Consolidate skills 11→5 and make SDD complement superpowers - #1
Merged
Conversation
Scope SDD to the spec/document/traceability layer and defer the engineering loop (planning, TDD, execution, generic verification, code review, branch-finishing) to the superpowers plugin. - Skills 11→5: merge requirement+spec+adr into sdd-specify; refocus sdd-trace (traceability/drift gate) and sdd-archive (document-side Definition of Done); rewrite the spec-driven-development router as the SDD↔superpowers integration map. Command surface 10→4; always-on description cost ~-33%. - Remove sdd-requirement/spec/adr (→sdd-specify), sdd-plan/sdd-implement (→superpowers), sdd-verify (→sdd-trace+sdd-archive+superpowers), sdd-gap (→references/cross-repo-gap.md). - Add references/sdd-with-superpowers.md (boundary + docs/superpowers path redirect) and references/cross-repo-gap.md. - Trim both agents to 2 examples; scope sdd-doc-reviewer to SDD docs, not code. - Propagate across router, scaffold templates, hooks, Cursor rule, README, AGENTS.md, docs, issue templates, and CHANGELOG. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…-invoke Address QA review (F1/F3 + Cursor feedback): - Agents: cut sdd-doc-reviewer / sdd-traceability-auditor descriptions from ~1.8k to ~1.05k chars (one example each); move triggering detail into a "When to invoke" body section (on-load, not always-on). - Skills: tighten sdd-specify / sdd-trace / sdd-archive descriptions; sharpen sdd-specify anti-triggers (existing-§ edit; traceability audit). - Trim duplicated superpowers handoff prose in skill bodies; keep the contextual one-liner handoffs (the full map stays in the router + reference). - Always-on description cost ~1,614 → ~1,212 tokens (agents 55% → 44%). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
… auditor self-contained
Builds on a Cursor-agent review pass, with two corrections:
- sdd-scaffold: resolve bundled templates host-agnostically — ${CLAUDE_PLUGIN_ROOT}
with a Glob fallback for Cursor/other installs (fixes Claude-only template lookup);
fold the superpowers redirect into step 4.
- cursor-hooks.json: add "version": 1.
- Thin rules/sdd-context.mdc (~50%); dedup superpowers routing in the router and the
worker skills to one-liners + references/sdd-with-superpowers.md.
- sdd-traceability-auditor: keep the drift-class list INLINE — an isolated agent can't
load the sdd-trace skill, so self-containment beats the dedup.
- Don't assert an unconfirmed ${CURSOR_PLUGIN_ROOT} in docs; lead on the Glob fallback.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Refactors the plugin's component surface from 11 skills → 5 and re-scopes it to be complementary to the superpowers plugin rather than overlapping it. SDD now owns only the spec / document / traceability layer; the generic engineering loop (explore, plan, TDD, execute, verify, code-review, branch-finish) is delegated to superpowers.
Combined flow:
What changed
sdd-requirement+sdd-spec+sdd-adr→sdd-specify; refocusedsdd-trace(traceability/drift gate) andsdd-archive(document-side Definition of Done); rewrotespec-driven-developmentas the SDD↔superpowers integration map. Keptsdd-scaffold.sdd-plan/sdd-implement→ superpowers;sdd-verify→sdd-trace+sdd-archive+ superpowers;sdd-gap→references/cross-repo-gap.md.## When to invokesections;sdd-doc-reviewerscoped to SDD documents (not code);sdd-traceability-auditorkept self-contained.sdd-with-superpowers.md(boundary + thedocs/superpowers/*→ canonical-tree path redirect).sdd-scaffoldresolves bundled templates host-agnostically (Glob fallback for Cursor);cursor-hooks.jsonadds"version": 1; thinnedrules/sdd-context.mdc.Impact
/sdd-*commands: 10 → 4 (scaffold,specify,trace,archive) + the router.scripts/validate.py✓ ·claude plugin validate .✓ · public-safety scan clean.Notes for the reviewer
cursor-hooks.jsonversion: 1fires correctly. Code works either way (Glob fallback; additive field).sdd-traceability-auditor(overlapssdd-trace's scan; kept for context-isolated whole-repo audits).🤖 Generated with Claude Code