tayebchlyah/heldout-dev-loop
A stage-driven development loop for Claude Code and Codex, where the acceptance tests are written from the spec and held out from the agent that writes the code.
ARCHETYPE
Fort Knox
Deny lists, pre-tool hooks, sandboxing. Nothing touches prod without a signature.
GUARDRAILS
4/5
Blocks destructive commands · Protects secrets · Pre-tool screening hook · No YOLO mode · details
Quality 17/100 Guardrails v2
Copy this rig
# review before running: this installs third-party code
$ npx degit tayebchlyah/heldout-dev-loop/.claude ./rig-heldout-dev-loop # 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.
$ npx degit tayebchlyah/heldout-dev-loop/.agents/skills/continue .claude/skills/continue $ npx degit tayebchlyah/heldout-dev-loop/.agents/skills/dev-loop .claude/skills/dev-loop $ npx degit tayebchlyah/heldout-dev-loop/.agents/skills/garden .claude/skills/garden $ npx degit tayebchlyah/heldout-dev-loop/.agents/skills/pause .claude/skills/pause $ npx degit tayebchlyah/heldout-dev-loop/.agents/skills/release-audit .claude/skills/release-audit $ npx degit tayebchlyah/heldout-dev-loop/.agents/skills/release-notes .claude/skills/release-notes $ npx degit tayebchlyah/heldout-dev-loop/.agents/skills/release .claude/skills/release
$ curl -fsSL --create-dirs -o .claude/agents/implementer.md https://raw.githubusercontent.com/tayebchlyah/heldout-dev-loop/main/.claude/agents/implementer.md $ curl -fsSL --create-dirs -o .claude/agents/spec-tester.md https://raw.githubusercontent.com/tayebchlyah/heldout-dev-loop/main/.claude/agents/spec-tester.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": [
"Skill(superpowers:verification-before-completion)",
"Skill(superpowers:test-driven-development)",
"Skill(superpowers:systematic-debugging)",
"Skill(superpowers:brainstorming)",
"Skill(superpowers:finishing-a-development-branch)",
"Read(./.env)",
"Read(./.env.*)",
"Agent(caveman:cavecrew-reviewer)",
"Agent(caveman:cavecrew-builder)",
"Agent(caveman:cavecrew-investigator)"
]
},
"hooks": {
"PreToolUse": [
{
"matcher": "Bash|Monitor",
"hooks": [
{
"type": "command",
"command": "\"${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/git-guard.sh\""
}
]
},
{
"matcher": ".*",
"hooks": [
{
"type": "command",
"command": "\"${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/deny-acceptance-to-subagents.sh\""
}
]
},
{
"matcher": "AskUserQuestion",
"hooks": [
{
"type": "command",
"command": "\"${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/deny-ask.sh\""
}
]
},
{
"matcher": "Edit|Write|NotebookEdit",
"hooks": [
{
"type": "command",
"command": "\"${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/worktree-wall.sh\""
}
]
}
]
}
} Skills (7)
Subagents (2)
| implementer model: sonnet | Implements one plan task from a brief. Never reads the held-out acceptance suite in tests/acceptance. Use for every SDD implementer dispatch. |
| spec-tester model: opus | Writes held-out acceptance tests in tests/acceptance from the approved spec alone. Never reads src. Use once per feature, after the spec is approved and before writing-plans. |
Hooks (15)
| event | matcher | runs |
|---|---|---|
| SessionStart | startup|resume|clear|compact | d="${CLAUDE_PROJECT_DIR:-.}"; [ -f "$d/dev-loop.json" ] && echo 'This repo runs the dev-loop skill. Invoke it before any other action.'; exit 0 |
| SessionStart | startup|resume|clear|compact | "${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/board.sh" session-start |
| PreToolUse | Bash|Monitor | "${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/git-guard.sh" |
| PreToolUse | .* | "${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/deny-acceptance-to-subagents.sh" |
| PreToolUse | AskUserQuestion | "${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/deny-ask.sh" |
| PreToolUse | Edit|Write|NotebookEdit | "${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/worktree-wall.sh" |
| Stop | * | "${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/gate.sh" |
| Stop | * | "${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/seal.sh" turn |
| SubagentStop | * | "${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/gate.sh" |
| SubagentStop | * | "${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/seal.sh" stop |
| SubagentStart | * | "${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/gate-snapshot.sh" |
| UserPromptSubmit | * | "${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/board.sh" prompt |
| PostToolUse | Bash | "${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/board.sh" post-tool |
| PostToolUse | TaskCreate|TaskUpdate | "${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/board.sh" post-tool |
| StopFailure | rate_limit | "${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/pause.sh" |
Permissions
deny (10)
Skill(superpowers:verification-before-completion)
Skill(superpowers:test-driven-development)
Skill(superpowers:systematic-debugging)
Skill(superpowers:brainstorming)
Skill(superpowers:finishing-a-development-branch)
Read(./.env)
Read(./.env.*)
Agent(caveman:cavecrew-reviewer)
Agent(caveman:cavecrew-builder)
Agent(caveman:cavecrew-investigator)
ask (0)
—
allow (0)
—
Similar rigs
RAIT-09/obsidian-agent-client
Bring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.
Pragmatist 4.8k tok · · Q15
eugene1g/agent-safehouse
Sandbox your local AI agents so they can read/write only what they need
Minimalist 1.5k tok · · Q0
movieclaw/MovieClaw
Next-gen AI media server. One container replaces Sonarr, Radarr, Prowlarr, Bazarr, Jellyseerr and Jellyfin, with a web app, a native iPhone app, and an AI agent that gets things done. Free for personal use.
Minimalist 320 tok · · Q0
jgravelle/jdocmunch-mcp
The leading, most token-efficient MCP server for documentation exploration and retrieval via structured section indexing
Pragmatist 18.0k tok · · Q10