BillDX/spicy-to-dark-factory-starter
Workshop starter for 'From Spicy Autocomplete to Dark Factory: Agentic Coding in Practice' — a FastAPI mini-app with a full Claude Code harness (agents, slash commands, hooks, sandbox settings) and self-paced exercises.
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
Copy this rig
# review before running: this installs third-party code
$ npx degit BillDX/spicy-to-dark-factory-starter/.claude ./rig-spicy-to-dark-factory-starter # 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.
$ curl -fsSL --create-dirs -o .claude/agents/coder.md https://raw.githubusercontent.com/BillDX/spicy-to-dark-factory-starter/main/.claude/agents/coder.md $ curl -fsSL --create-dirs -o .claude/agents/documenter.md https://raw.githubusercontent.com/BillDX/spicy-to-dark-factory-starter/main/.claude/agents/documenter.md $ curl -fsSL --create-dirs -o .claude/agents/planner.md https://raw.githubusercontent.com/BillDX/spicy-to-dark-factory-starter/main/.claude/agents/planner.md $ curl -fsSL --create-dirs -o .claude/agents/reviewer.md https://raw.githubusercontent.com/BillDX/spicy-to-dark-factory-starter/main/.claude/agents/reviewer.md $ curl -fsSL --create-dirs -o .claude/agents/security-reviewer.md https://raw.githubusercontent.com/BillDX/spicy-to-dark-factory-starter/main/.claude/agents/security-reviewer.md $ curl -fsSL --create-dirs -o .claude/agents/tester.md https://raw.githubusercontent.com/BillDX/spicy-to-dark-factory-starter/main/.claude/agents/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": [
"Bash(rm -rf:*)",
"Bash(git push --force:*)",
"Bash(git reset --hard:*)",
"Write(./.env)",
"Write(./.env.*)"
]
}
} Subagents (6)
| coder model: sonnet | Implements a plan in code. Use as the implementation stage of a controller pipeline, after the planner. Works in an isolated worktree. |
| documenter model: haiku | Adds docstrings to public functions and classes. Use when route handlers, models, or utility functions are missing documentation. Edits files in place. |
| planner model: opus | Reads a SPEC and produces a step-by-step implementation plan. Use as the first stage of a controller pipeline. Read-only — produces a plan, not code. |
| reviewer model: sonnet | Reviews code changes for bugs, correctness issues, and style problems. Use when the user asks for a code review, or as a parallel reviewer in a controller pipeline. Read-only — never edits. |
| security-reviewer model: sonnet | Reviews code for security issues — injection, auth, data exposure, dangerous functions. Use when the user asks for a security review, or as one specialist in a multi-reviewer controller pipeline. Read |
| tester model: sonnet | Writes tests for new or under-tested code, then runs them. Use as the testing stage of a controller pipeline, in parallel with the coder. Works in an isolated worktree. |
Slash commands (5)
/exercise-1/exercise-2/exercise-3/review/ship
Permissions
deny (5)
Bash(rm -rf:*)
Bash(git push --force:*)
Bash(git reset --hard:*)
Write(./.env)
Write(./.env.*)
ask (0)
—
allow (13)
Read
Edit
Write
Glob
Grep
Bash(uv sync:*)
Bash(uv run pytest:*)
Bash(uv run ruff:*)
Bash(uv run uvicorn:*)
Bash(git status:*)
Bash(git diff:*)
Bash(git log:*)
Bash(git worktree list:*)
Similar rigs
juzser/blacksmith
Autonomous agent factory — loop runner, worktree engine, and a local dashboard over the event log.
Orchestrator 2.6k tok ·
CreatmanCEO/claude-code-antiregression-setup
Stop Claude Code from breaking your projects. Ready-to-use CLAUDE.md templates, subagents, hooks, and anti-regression configs.
Pragmatist 96 tok ·
Rusty-Alucard/ai-dev-base
AI-driven development base template — reusable patterns for multi-agent Claude Code workflows
Pragmatist 1.3k tok ·
OMOCHInoHOSHI/dotfiles-claude
.claude
Pragmatist 293 tok ·