~ / rigs / Freakling / Director-Driven-Development

Freakling/Director-Driven-Development

How-to docs for Director-Driven Development: you direct, AI agents build, one automatic check proves every task. Covers Godot-Director, App-Director and SaaSAllTheThings. Built with App-Director.

↗ GitHub ★ 0 MIT updated 14d 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
~4.1k tokens
Moderate · median rig: 2.3k · breakdown
GUARDRAILS
4/5
Blocks destructive commands · Protects secrets · Pre-tool screening hook · No YOLO mode · details
Quality 56/100 Guardrails v2

Copy this rig

# review before running: this installs third-party code
$ npx degit Freakling/Director-Driven-Development/.claude ./rig-director-driven-development  # 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 Freakling/Director-Driven-Development/.claude/skills/acceptance .claude/skills/acceptance
$ npx degit Freakling/Director-Driven-Development/.claude/skills/align .claude/skills/align
$ npx degit Freakling/Director-Driven-Development/.claude/skills/design .claude/skills/design
$ npx degit Freakling/Director-Driven-Development/.claude/skills/drift-reset .claude/skills/drift-reset
$ npx degit Freakling/Director-Driven-Development/.claude/skills/next-task .claude/skills/next-task
$ npx degit Freakling/Director-Driven-Development/.claude/skills/prune .claude/skills/prune
$ npx degit Freakling/Director-Driven-Development/.claude/skills/refresh-model-sizing .claude/skills/refresh-model-sizing
$ npx degit Freakling/Director-Driven-Development/.claude/skills/release .claude/skills/release
$ npx degit Freakling/Director-Driven-Development/.claude/skills/research .claude/skills/research
$ npx degit Freakling/Director-Driven-Development/.claude/skills/security .claude/skills/security
$ npx degit Freakling/Director-Driven-Development/.claude/skills/ui-design .claude/skills/ui-design
$ curl -fsSL --create-dirs -o .claude/agents/builder.md https://raw.githubusercontent.com/Freakling/Director-Driven-Development/main/.claude/agents/builder.md
$ curl -fsSL --create-dirs -o .claude/agents/researcher.md https://raw.githubusercontent.com/Freakling/Director-Driven-Development/main/.claude/agents/researcher.md
$ curl -fsSL --create-dirs -o .claude/agents/reviewer.md https://raw.githubusercontent.com/Freakling/Director-Driven-Development/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)",
      "Read(.env.local)",
      "Read(**/.env.local)",
      "Read(.env.*.local)",
      "Read(**/.env.*.local)",
      "Read(.env.development)",
      "Read(**/.env.development)",
      "Read(.env.production)",
      "Read(**/.env.production)",
      "Read(.env.staging)",
      "Read(**/.env.staging)",
      "Read(.env.test)",
      "Read(**/.env.test)",
      "Read(*.pem)",
      "Read(**/*.pem)",
      "Read(*.key)",
      "Read(**/*.key)",
      "Read(~/.ssh/**)",
      "Read(~/.git-credentials)",
      "Read(~/.config/git/credentials)",
      "Read(~/.config/gh/**)",
      "Read(~/AppData/Roaming/GitHub CLI/**)",
      "Bash(git *--output*)",
      "PowerShell(git *--output*)",
      "Bash(git *--no-index*)",
      "PowerShell(git *--no-index*)",
      "Bash(git *--ext-diff*)",
      "PowerShell(git *--ext-diff*)",
      "Bash(git commit *--file*)",
      "PowerShell(git commit *--file*)",
      "Bash(git grep *--open*)",
      "PowerShell(git grep *--open*)",
      "Bash(git grep *-O*)",
      "PowerShell(git grep *-O*)",
      "Bash(git tag *--file*)",
      "PowerShell(git tag *--file*)",
      "Bash(bash tools/*..*)",
      "PowerShell(bash tools/*..*)"
    ]
  },
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash|Monitor|PowerShell",
        "hooks": [
          {
            "type": "command",
            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/guard-commands.sh\""
          }
        ]
      },
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/guard-protected.sh\""
          }
        ]
      },
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/guard-protected.sh\""
          }
        ]
      }
    ]
  }
}

Skills (11)

Subagents (3)

builder
model: inherit
Builds one claimed TASKS.md item in a fresh context and reports back in ~20 lines, so the orchestrator context stays small. Does not pick items, edit TASKS.md, or commit.
researcher
model: inherit
Researches one question in a fresh context, from the project's records, the repository and the web, and reports a note with options, trade-offs, sources and a recommendation. It informs a design call
reviewer
model: inherit
Reviews a finished uncommitted change in fresh context, analyses one area of the app for a design drift reset, or reads the app against the OWASP checklist for a security assessment. Read-only. Use wh

Hooks (4)

eventmatcherruns
Stop*bash "$CLAUDE_PROJECT_DIR/.claude/hooks/stop-check.sh"
PreToolUseBash|Monitor|PowerShellbash "$CLAUDE_PROJECT_DIR/.claude/hooks/guard-commands.sh"
PreToolUseEditbash "$CLAUDE_PROJECT_DIR/.claude/hooks/guard-protected.sh"
PreToolUseWritebash "$CLAUDE_PROJECT_DIR/.claude/hooks/guard-protected.sh"

Permissions

deny (39)
Read(.env)
Read(**/.env)
Read(.env.local)
Read(**/.env.local)
Read(.env.*.local)
Read(**/.env.*.local)
Read(.env.development)
Read(**/.env.development)
Read(.env.production)
Read(**/.env.production)
Read(.env.staging)
Read(**/.env.staging)
Read(.env.test)
Read(**/.env.test)
Read(*.pem)
Read(**/*.pem)
Read(*.key)
Read(**/*.key)
Read(~/.ssh/**)
Read(~/.git-credentials)
Read(~/.config/git/credentials)
Read(~/.config/gh/**)
Read(~/AppData/Roaming/GitHub CLI/**)
Bash(git *--output*)
PowerShell(git *--output*)
Bash(git *--no-index*)
PowerShell(git *--no-index*)
Bash(git *--ext-diff*)
PowerShell(git *--ext-diff*)
Bash(git commit *--file*)
PowerShell(git commit *--file*)
Bash(git grep *--open*)
PowerShell(git grep *--open*)
Bash(git grep *-O*)
PowerShell(git grep *-O*)
Bash(git tag *--file*)
PowerShell(git tag *--file*)
Bash(bash tools/*..*)
PowerShell(bash tools/*..*)
ask (0)
—
allow (28)
Bash(bash tools/check.sh*)
Bash(bash tools/security.sh)
Bash(bash tools/security.sh --due)
Bash(bash tools/ui_capture.sh*)
Bash(node tools/ui/drawing.mjs *)
Bash(node tools/ui/overlay.mjs *)
Bash(node tools/ui/verify.mjs *)
Bash(node tools/ui/capture.mjs *)
Bash(bash tools/setup-clone.sh*)
Bash(bash tools/stacks/*.sh*)
Bash(git add *)
Bash(git diff *)
Bash(git log *)
Bash(git show *)
Bash(git status)
Bash(git status *)
Bash(git rev-parse *)
Bash(git commit *)
Bash(git tag *)
Bash(git stash *)
Bash(git worktree *)
Bash(git ls-files *)
Bash(git grep *)
WebSearch
WebFetch
Bash(bash tools/work-clones.sh*)
Bash(bash tools/work-release.sh*)
Bash(bash tools/work-publish.sh*)

Similar rigs

copied ✓