devluxe

Status: early development (v0.2, quiet release). Published to claim the namespace with a real, working tool; APIs may change without notice until v1.0. Not yet announced.

Governed AI project doc-kit. Scaffold the instruction files AI coding agents actually read — CLAUDE.md, AGENTS.md, governance.yaml, and an append-only decision log — then validate them as a CI gate. Snap. Wire. Ship.

npx devluxe init my-project --name my-project
npx devluxe check my-project          # structural validation
npx devluxe check my-project --gate   # strict line-count floors

Why

AI-assisted repos drift: agent instructions scatter, decisions evaporate, and "done" goes unverified. devluxe gives a repo its governed contract in four files and keeps it honest with a checkable gate:

• CLAUDE.md — the agent contract (purpose, working agreements, hard rules)
• AGENTS.md — multi-agent roles + forbidden actions
• governance.yaml — declarative guardrails (schema v2: routing, guardrails, verification)
• .ai-notes/devtrack.md — append-only ADR decision log

Copy-in model (the shadcn philosophy): init writes files you own — no runtime dependency, no lock-in. check is the gate:

| Check | What it validates | |---|---| | required files | all four kit files exist and are non-empty | | incomplete-markers | zero unfinished-work tokens anywhere in the kit | | required sections | ## Purpose + ## DO NOT (CLAUDE), ## Forbidden (AGENTS) | | governance keys | schema_version, metadata, guardrails, verification | | --gate floors | CLAUDE ≥100 · ARCHITECTURE ≥150 · BLUEPRINT ≥150 · PRD ≥100 lines |

Exit codes: 0 pass · 1 named failures · 2 usage error.

CI usage

- run: npx devluxe check . # fails the build on doc-kit drift

Scope (honest)

v0.2 ships init + check, zero runtime dependencies, Node ≥ 20, ESM-only. A Copier-style update (3-way re-apply of template improvements) is designed for v0.3. The Python sibling (pip install devluxe) ships check for Python-first CI. Not affiliated with Anthropic, OpenAI, or the AAIF AGENTS.md spec — it scaffolds files those ecosystems read.

License

MIT © Dane Anthony Cooper