~ / rigs / danielsaed / sdd-base

danielsaed/sdd-base

Spec-driven development workflow for Claude Code: an orchestrator plus permissioned planner, implementer and reviewer agents — one feature per spec, branch and PR.

↗ GitHub ★ 0 MIT updated 5d ago project Claude CodeCodex
share on X
ARCHETYPE
Fort Knox
Deny lists, pre-tool hooks, sandboxing. Nothing touches prod without a signature.
CONTEXT TAX · EVERY TURN
~9.7k tokens
Heavy · median rig: 2.3k · breakdown
GUARDRAILS
4/5
Blocks destructive commands · Protects secrets · Pre-tool screening hook · No YOLO mode · details
Quality 53/100 Guardrails v2

Copy this rig

# review before running: this installs third-party code
$ claude mcp add playwright -- npx -y @playwright/mcp@0.0.85 --headless --isolated --browser chromium
$ npx degit danielsaed/sdd-base/.claude ./rig-sdd-base  # inspect, then merge into .claude/

MCP servers are added to Claude Code at local scope; env vars are shown as YOUR_… placeholders — we never store values. Files are fetched with degit into a separate folder so you can review before merging.

$ claude mcp add playwright -- npx -y @playwright/mcp@0.0.85 --headless --isolated --browser chromium
$ npx degit danielsaed/sdd-base/.claude/skills/sdd .claude/skills/sdd
$ curl -fsSL --create-dirs -o .claude/agents/implementer.md https://raw.githubusercontent.com/danielsaed/sdd-base/main/.claude/agents/implementer.md
$ curl -fsSL --create-dirs -o .claude/agents/planner.md https://raw.githubusercontent.com/danielsaed/sdd-base/main/.claude/agents/planner.md
$ curl -fsSL --create-dirs -o .claude/agents/reader.md https://raw.githubusercontent.com/danielsaed/sdd-base/main/.claude/agents/reader.md
$ curl -fsSL --create-dirs -o .claude/agents/reviewer.md https://raw.githubusercontent.com/danielsaed/sdd-base/main/.claude/agents/reviewer.md

Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.local)",
      "Read(./**/.env)",
      "Read(./**/.env.local)",
      "Bash(cat .env*)",
      "Bash(git push --force *)",
      "Bash(git push -f *)",
      "Bash(git push * --force*)",
      "Bash(git push origin main*)",
      "Bash(git push origin HEAD:main*)",
      "Bash(rm -rf /*)",
      "Bash(rm -rf ~*)"
    ]
  },
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash|Edit|Write|MultiEdit|NotebookEdit",
        "hooks": [
          {
            "type": "command",
            "command": "python3 \"$CLAUDE_PROJECT_DIR/.claude/hooks/agent_guard.py\""
          }
        ]
      }
    ]
  }
}

MCP servers (1)

serversourceest. tokens
Playwright MCP · "playwright" npm 7.5k

Skills (1)

Subagents (4)

implementer
model: sonnet
Implements tasks from a plan inside its feature folder (.worktrees/<area>-<slug>, branch feat/<area>-<slug>), one commit per task, following the verification list in AGENTS.md. Doesn't push, merge or
planner
model: sonnet
Turns an approved spec (areas/<area>/open/<slug>/spec.md) into a task plan (plan.md). Only reads the repo and writes plan.md; no code edits, no terminal. Use it in step 2 of the SDD flow, after the us
reader
model: haiku
Reads large outputs (logs, code sweeps, long docs, query results) and returns only the summary the orchestrator asked for. Edits nothing; read-only terminal. Use it whenever the orchestrator would hav
reviewer
model: opus
Independently verifies a feature against its spec's acceptance criteria, measuring with scripts and commands. Edits nothing. Use it in step 4 of the SDD flow, after the implementer finishes.

Hooks (3)

eventmatcherruns
UserPromptSubmit*python3 "$CLAUDE_PROJECT_DIR/.claude/hooks/reminder.py"
Stop*python3 "$CLAUDE_PROJECT_DIR/.claude/hooks/closeout.py"
PreToolUseBash|Edit|Write|MultiEdit|NotebookEditpython3 "$CLAUDE_PROJECT_DIR/.claude/hooks/agent_guard.py"

Permissions

deny (12)
Read(./.env)
Read(./.env.local)
Read(./**/.env)
Read(./**/.env.local)
Bash(cat .env*)
Bash(git push --force *)
Bash(git push -f *)
Bash(git push * --force*)
Bash(git push origin main*)
Bash(git push origin HEAD:main*)
Bash(rm -rf /*)
Bash(rm -rf ~*)
ask (0)
—
allow (0)
—

Similar rigs

copied ✓