How apriorhythm/apriori-spec-development works
apriori is a zero-dependency CLI and agent-guided workflow for turning change specifications into test-bound, mechanically gated, archived specifications. The principal loop is change kickoff and spec authoring, scenario verification against tests, gate checks, then delta merge into the living spec store. The README documents additional hotfix, project-health, status, initialization, and upgrade capabilities. Source excerpts are limited, so subsystem links below follow the CLI dispatcher and documented behavior; they do not imply uninspected internal calls.
Main entry points: apriori.js CLI dispatcher · spec-runner.js Scenario verification · gate.js Mechanical gate · archive-merge.js Delta archive
Components 17
Change workflow
- CLI dispatcher
bin/apriori.js - Change kickoff
lib/new.js - Workflow status
lib/status.js - Hotfix lane
lib/hotfix.js
Verification and gates
- Scenario verification
lib/spec-runner.js - Mechanical gate
lib/gate.js - Structural check
lib/check.js
Spec store
- Delta archive
lib/archive-merge.js - Store stamp
lib/archive-merge.js
Project setup
- Seam diagnostics
lib/doctor.js - Project initialization
lib/init.js - Tool-file update
lib/update.js - Project configuration
lib/config.js - Project resolution
lib/resolve.js
Other components
- Human / agent
- Project test command
- Living spec store
Connections 19
- Human / agent → CLI dispatcher: runs commands
- CLI dispatcher → Change kickoff: dispatches new
- CLI dispatcher → Workflow status: dispatches status
- CLI dispatcher → Hotfix lane: dispatches hotfix
- CLI dispatcher → Scenario verification: dispatches verify
- CLI dispatcher → Mechanical gate: dispatches gate
- CLI dispatcher → Structural check: dispatches check
- CLI dispatcher → Delta archive: dispatches archive
- CLI dispatcher → Store stamp: dispatches stamp
- CLI dispatcher → Seam diagnostics: dispatches doctor
- CLI dispatcher → Project initialization: dispatches init
- CLI dispatcher → Tool-file update: dispatches update
- Scenario verification → Project test command: runs test command
- Mechanical gate → Scenario verification: checks verification
- Delta archive → Living spec store: merges delta
- Store stamp → Living spec store: reads baseline
- Seam diagnostics → Project resolution: diagnoses seam
- Project initialization → Project configuration: configures project
- Tool-file update → Project configuration: resolves settings