Bootstrap Autonomous Delivery

From idea to a fully orchestrated delivery pipeline.

This repo packages a portable skill + reference implementation that takes a feature from planning docs to autonomous, test-first execution with hard gates.

What it does

1. Locks a planning corpus (PRD, Stories, Technical-Plan, API-Surface, ADRs, testing blueprint, roadmap).
2. Enforces decision completeness with ADR traceability + open-question closure.
3. Compiles roadmap markdown into machine-readable roadmap JSON.
4. Runs an autonomous Smithers pipeline with:
   • test-first checkpoints
   • delta quality gates (type/lint/test)
   • mandatory adversarial review
   • UI-required browser smoke checks
   • per-subtask local commits
5. Ships a live run visualizer (AgentPrism sidecar).

Repo layout

• SKILL.md
  • Skill instructions and execution workflow.
• references/
  • Acquisition protocol, architecture docs, schema, templates.
• scripts/
  • scaffold-feature-docs.sh to scaffold planning docs.
  • install-smithers-template.sh to install orchestrator template into any repo.
• assets/smithers-orchestrator-template/
  • Full reference Smithers implementation (workflow + gates + visualizer).

Quick start

1. Scaffold planning docs in a target repo:

bash scripts/scaffold-feature-docs.sh <target-feature-dir>

2. Install the Smithers template into the target repo:

bash scripts/install-smithers-template.sh <target-repo-root> scripts/smithers-delivery

3. In the target repo, wire scripts from:

references/package-scripts.template.json

4. Set planning root for your feature:

export SMITHERS_PLANNING_DOC_ROOT=".planning/features/<feature-slug>"

5. Build roadmap JSON and run:

bun run smithers:roadmap:build
bun run smithers:run:fullauto

Key docs

• references/document-acquisition-protocol.md
• references/system-components.md
• references/smithers-reference-implementation.md
• references/orchestration-setup-checklist.md
• references/roadmap-schema.json

Notes

• The template is path-decoupled via environment variables (SMITHERS_*).
• Installer excludes runtime DB artifacts and avoids destructive sync behavior.
• Commits are local-only by design; no auto-push in orchestration.