spectacles
spectacles moves a feature from a plain GitHub issue to a merged
implementation through a disciplined pipeline: spec, architecture, triage,
execute, validate, review. Every step runs as an agentic GitHub Actions
workflow, and the whole pipeline is operated through GitHub primitives only:
issues, comments, labels, and pull requests.
Where to start
How a plain GitHub issue becomes a merged implementation, and what a human does at each step.
Run quick-setup.sh --suite sdd to install the suite on another
repository, including one with an existing codebase.
Distillery for retrieval and memory; Serena for symbol-level code intelligence.
The full design: ten demoable units, the needs-human contract, and the
human-interaction model.
Status
The repository foundation, the human-interaction contract, the shared MCP
tooling, the six pipeline agents (sdd-spec, sdd-triage, sdd-dispatch,
sdd-execute, sdd-validate, sdd-review), and the consumer packaging — the
one-command install onto another repo — are built. See
Installing the SDD suite.
The source, including the workflow definitions, shared fragments, and ADRs, is at github.com/norrietaylor/spectacles.