architectonic-rail
v0.3.1
Published
Portable work-rail contract, ledger schema, and dependency-aware selector for human-agent projects.
Maintainers
Readme
Rail
Architectonic layer: portable work coordination for human-agent projects.
Status: active public reference, pre-1.0. Rail defines one canonical work ledger and a small execution contract. It is not a project-management suite, scheduler, issue tracker, or source-code authority. The canonical repository is
architectonic/rail.
Rail contract version 0.3.1 implements Architectonic package protocol 0.2.x.
The two versions are intentionally distinct: the first versions this work
coordination contract; the second declares compatibility with the package family.
rail = execution protocol
work ledger = canonical current work state
backlog = ledger items not ready
queue = ready ledger items
now = optional projection
run log = optional event historyThe package includes:
rail.md— canonical vocabulary and behavior;schema/ledger.schema.json— portable ledger shape;architectonic-rail validate— structural and semantic checks;architectonic-rail next— dependency-aware ready-item selection;architectonic-rail status— compact current-state summary.
Use
Keep exactly one ledger.json in the location named by the project contract. Common locations are docs/ledger/ledger.json, operations/ledger.json, and meta/ledger.json.
node bin/architectonic-rail.js validate docs/ledger/ledger.json
node bin/architectonic-rail.js next docs/ledger/ledger.json
node bin/architectonic-rail.js next docs/ledger/ledger.json --role code-reviewer
node bin/architectonic-rail.js status docs/ledger/ledger.jsonBacklog, queue, and now are queries over the ledger. Do not maintain separate authored files for them.
Write ledger prose with the controlled technical language contract defined in
rail.md.
