trueline

Spec-Driven Development (SDD) framework for Claude Code users: specs and architecture as living documents and source of truth, evolution via spec deltas and ADRs, finalization with a judge-until-convergence loop and a human gate — all driven by an external orchestrator over a headless core.

Status: Milestone 1 (skeleton) implemented — strict schemas, fold-engine with byte-for-byte parity with OpenSpec, ADR log with projected state, derived state machine, cumulative gates, judge-until-convergence loop, headless invocation (SDK/CLI) and the full CLI surface.

trueline init                 # .trueline/ skeleton + config.yaml
trueline propose <id>         # phases: propose → plan → decompose → build
trueline validate [<id>|--ci] # battery of checks (drift) / post-merge net
trueline finalize <id>        # refactor short-circuit or judge loop
trueline approve|reject <id>  # human gate of finalization
trueline status [<id>]        # derived state + next step
trueline adr list             # decision log with display numbering

Documents

• docs/DESIGN.md — conceptual design (v5). In conflict with the spec, the design wins.
• docs/M1-SPEC.md — technical specification of Milestone 1 (r4, FINAL): the source of truth of the implementation.
• docs/M1-HANDOFF.md — implementation state, agenda and working style.

License

MIT — see LICENSE. The fold-engine parity suite is translated from the OpenSpec test suite (MIT) — see THIRD-PARTY-NOTICES.md.