devluxe 0.2.0

Governed AI project doc-kit validator — check CLAUDE.md, AGENTS.md, governance.yaml and the decision log as a CI gate.

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 validator (Python). Check that a repo's AI agent contract — CLAUDE.md, AGENTS.md, governance.yaml, .ai-notes/devtrack.md — exists, is complete, and stays honest. The scaffolding counterpart (init) ships in the npm package of the same name.

pip install devluxe
devluxe check .            # structural validation
devluxe check . --gate     # strict line-count floors

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. Zero runtime dependencies; Python ≥ 3.10; importable API: from devluxe import check.

CI usage

- run: pip install devluxe && devluxe check .

Scope (honest)

v0.2 = check only, deliberately: scaffolding lives in the npm CLI (npx devluxe init); this package is the validate-anywhere gate for Python-first pipelines. Both packages share one rule table and one version.

License

MIT © Dane Anthony Cooper