~ / rigs / tayebchlyah / heldout-dev-loop

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.

↗ GitHub ★ 1 no license updated 1d 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
~3.4k tokens
Moderate · median rig: 2.3k · breakdown
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)

eventmatcherruns
SessionStartstartup|resume|clear|compactd="${CLAUDE_PROJECT_DIR:-.}"; [ -f "$d/dev-loop.json" ] && echo 'This repo runs the dev-loop skill. Invoke it before any other action.'; exit 0
SessionStartstartup|resume|clear|compact"${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/board.sh" session-start
PreToolUseBash|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"
PreToolUseAskUserQuestion"${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/deny-ask.sh"
PreToolUseEdit|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
PostToolUseBash"${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/board.sh" post-tool
PostToolUseTaskCreate|TaskUpdate"${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}/.dev-loop/hooks/claude/board.sh" post-tool
StopFailurerate_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

copied ✓