dev.kit

dev.kit is a 12-factor repo adapter.

It scans a repository for the workflow contracts that reduce drift across engineering teams: documentation, dependency contracts, config boundaries, verification entrypoints, runtime entrypoints, and build/release/run separation.

The goal is to make repos easier to work on the same way every time. As a repo gets closer to a 12-factor operating model, humans and agents need less tribal knowledge to build, test, run, deploy, and improve it.

Install

curl -fsSL https://raw.githubusercontent.com/udx/dev.kit/main/bin/scripts/install.sh | bash
dev.kit

This installs dev.kit into ~/.udx/dev.kit and adds dev.kit to ~/.local/bin/dev.kit. If ~/.local/bin is not already on PATH, the installer prints the exact command to export it manually.

Commands

dev.kit

• Audits the current repo as a 12-factor engineering contract.
• Returns a short improvement plan by default.
• --json returns the same model in machine-readable form.

dev.kit bridge

• Exposes the repo model for agents and automation.
• Returns detected archetypes, factor statuses, entrypoints, and guidance so agents can work from grounded repo reality instead of guessing.

Examples

dev.kit
dev.kit --json
dev.kit bridge --json

Why It Matters

Run dev.kit when a repo is new, drifting, hard to onboard into, or inconsistent across environments.

The value is operational clarity:

• develop without tribal knowledge
• verify changes predictably
• automate build and runtime workflows
• let teammates and agents operate with less ambiguity
• standardize how work moves from local changes to CI and deployment

Uninstall

dev.kit uninstall

Removes the local install from ~/.udx/dev.kit and the ~/.local/bin/dev.kit symlink.

Further docs:

• Workflow
• Engineering Guide
• Pull Requests
• Development