Design records

Every design spec under docs/superpowers/specs/, newest first. Generated by scripts/render_spec_index.py; tests/test_docs_site.py asserts this file is a fresh render. Do not hand-edit.

• Library store: one deduplicated reference library, searchable, with provenance -- approved in brainstorm 2026-09-05 (approach A of three; the user chose
• Write-side skills: attestation-record and attestation-annotate -- implemented 2026-09-01 (commits aea5dd3.. this date); the
• attest runs record: derive the artifacts, do not transcribe them -- approved by instruction ("build the attest record command");
• LaTeX integration and reviewer-persona audits -- brainstorm — options with a recommendation, awaiting Matt's
• Round two: five lenses on structure, every finding dispositioned -- implemented 2026-08-29 — sixteen commits 0829857..5e8d2ca (four
• Package documentation: the surface, the reference, and the ratchets -- implemented 2026-08-29, with deviations below.
• Onion seams: nine cuts three lenses agree on -- implemented 2026-08-29 — nine commits d2526ed..9cd7e70 (five
• Docs for collaborators: a front door that leads with the answer -- implemented 2026-08-29 (d6bbe54, a2e5515, fa49ebe), with deviations below.
• Task corpora: a labelled set for every model-driven task -- design; implementation follows in the plan of the same date.
• Golden paths: documented use cases on disk -- implemented 2026-08-29, with deviations below.
• Example flows: every agent helper, driven end to end -- design; implementation follows in the plan of the same date.
• Scheduled refresh: bound the work, and say what it will cost -- proposed
• DSPy prompt optimization, with transfer as the acceptance test -- implemented 2026-08-27. The optimizer ran; its output is the
• attest claims --suggest: propose the annotations, never write them -- proposed
• Experiment-tracker adapters -- implemented 2026-08-23 in 984cc20. Deviations: none. The
• Swarm — refuted, and what replaced it -- closed. This spec exists to close a question, not to open work.
• Agent-config emitters -- implemented 2026-08-23 in d29c604. One addition the spec did
• Citations domain -- implemented 2026-08-23 in 80c1a4f. Deviations: CSL rendering
• Agent surfaces — design -- implemented 2026-08-22 in 783b4e9. ATTEST_TOOLS / ATTEST_EXPAND live in mcp/__init__.py; the surface sizes move, so re-measure rather than quoting the numbers below.
• Tool surface — design -- implemented 2026-08-21/22, with two deviations recorded below
• Onion refactor — design -- SUPERSEDED by 2026-08-21-tool-surface-design.md. Retained for its
• Architecture roadmap — five specs -- superseded in part — all five slots resolved 2026-08-22. See the
• Corpus ledger — design -- implemented 2026-08-21 in 56ddba9. The corpus is detected from driver-script syntax via AST, not from a model.
• Digest — design -- implemented as the feed.digest tool; moved into mcp/feed.py by the domain split in 0db570c.
• Run ledger — design -- implemented, in ledger.py (present at the repo's first commit, 1d54107, so there is no separate implementing sha).
• Claim checker — design -- implemented, in claims.py (present at the repo's first commit, 1d54107, so there is no separate implementing sha).
• Web UI tidy-up — design -- approved (brainstorming dialogue; all sections approved)
• SymPy MCP tools — design -- approved (brainstorming dialogue; all sections approved)
• Persona + feed MCP tools, and click provenance — design -- approved (brainstorming dialogue; all sections approved)
• Knowledge graph — design -- approved (brainstorming dialogue; all sections approved)
• LLM client extraction (OpenAI-compatible endpoints) + .env — design -- approved (brainstorming dialogue; both sections approved)
• hermes install — one-command setup + agent config guide — design -- approved (user: "fold it into the hermes install brainstorm" + "fix it all"; scope and scheduling answers captured below)
• Feature extraction for ranking — design -- approved (brainstorming dialogue, sections 1–3 approved individually)
• hermes-rss — Personalized RSS Ranking Agent (Design) -- (no Status line)