Skip to main content

Decision Archive

The docs site explains the current system. The historical archive explains why it got here.

Primary Archive​

Design specs live in:

docs/superpowers/specs/

Implementation plans live in:

docs/superpowers/plans/

Use these when you need the original trade-offs for a feature. Many AI features have multiple specs because the Sage evolved from document ingestion, to rules chat, to LangGraph routing, to prep tools, to Codex extraction.

Generated Knowledge Graph​

When present locally, graphify-out/GRAPH_REPORT.md and graphify-out/graph.json provide a generated map of files, concepts, and relationships. Treat Graphify output as an exploration aid, not a replacement for reading the source before editing.

Feature Ledger​

The Features page is not just marketing copy. It is the current behavior ledger. Update it in the same change as any feature addition, removal, or behavior change.

Evaluation Notes​

EVALUATION_DELIVERABLES.md and EVAL_HARNESS.md explain the eval strategy and deliverables. Read them before changing citation metrics, NPC judging, or encounter-math evaluation.