~ / rigs / tae0y / python-project-template

tae0y/python-project-template

Project template for Claude Python Vibecoding workflow

↗ GitHub ★ 14 no license updated 2mo ago project Claude Code
share on X
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
CONTEXT TAX · EVERY TURN
~17.9k tokens
Context hog · median rig: 2.3k · breakdown
GUARDRAILS
3/5
Blocks destructive commands · Pre-tool screening hook · No YOLO mode · details

Copy this rig

# review before running: this installs third-party code
$ claude mcp add context7 -- npx -y @upstash/context7-mcp@latest
$ claude mcp add chrome-devtools -- npx chrome-devtools-mcp@latest
$ claude mcp add playwright -- npx -y @executeautomation/playwright-mcp-server
$ claude mcp add --transport http microsoft-learn https://learn.microsoft.com/api/mcp
$ claude mcp add jcodemunch -- uvx jcodemunch-mcp
$ npx degit tae0y/python-project-template/.claude ./rig-python-project-template  # 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 context7 -- npx -y @upstash/context7-mcp@latest
$ claude mcp add chrome-devtools -- npx chrome-devtools-mcp@latest
$ claude mcp add playwright -- npx -y @executeautomation/playwright-mcp-server
$ claude mcp add --transport http microsoft-learn https://learn.microsoft.com/api/mcp
$ claude mcp add jcodemunch -- uvx jcodemunch-mcp
$ npx degit tae0y/python-project-template/.claude/skills/audit .claude/skills/audit
$ npx degit tae0y/python-project-template/.claude/skills/auto-fix .claude/skills/auto-fix
$ npx degit tae0y/python-project-template/.claude/skills/check .claude/skills/check
$ npx degit tae0y/python-project-template/.claude/skills/davinci-define .claude/skills/davinci-define
$ npx degit tae0y/python-project-template/.claude/skills/docker .claude/skills/docker
$ npx degit tae0y/python-project-template/.claude/skills/grill-me .claude/skills/grill-me
$ npx degit tae0y/python-project-template/.claude/skills/localdocs-til-link .claude/skills/localdocs-til-link
$ npx degit tae0y/python-project-template/.claude/skills/md-janitor .claude/skills/md-janitor
$ npx degit tae0y/python-project-template/.claude/skills/microsoft-docs .claude/skills/microsoft-docs
$ npx degit tae0y/python-project-template/.claude/skills/planning .claude/skills/planning
$ npx degit tae0y/python-project-template/.claude/skills/prd .claude/skills/prd
$ npx degit tae0y/python-project-template/.claude/skills/python-conventions .claude/skills/python-conventions
$ npx degit tae0y/python-project-template/.claude/skills/python-mcp-expert .claude/skills/python-mcp-expert
$ npx degit tae0y/python-project-template/.claude/skills/refactoring .claude/skills/refactoring
$ npx degit tae0y/python-project-template/.claude/skills/rethink-unblock .claude/skills/rethink-unblock
$ npx degit tae0y/python-project-template/.claude/skills/skill-creator .claude/skills/skill-creator
$ npx degit tae0y/python-project-template/.claude/skills/sparks-create .claude/skills/sparks-create
$ npx degit tae0y/python-project-template/.claude/skills/tdd .claude/skills/tdd
$ npx degit tae0y/python-project-template/.claude/skills/template-broadcast .claude/skills/template-broadcast
$ npx degit tae0y/python-project-template/.claude/skills/template-downstream .claude/skills/template-downstream
$ npx degit tae0y/python-project-template/.claude/skills/template-proposal-review .claude/skills/template-proposal-review
$ npx degit tae0y/python-project-template/.claude/skills/voice-business .claude/skills/voice-business
$ npx degit tae0y/python-project-template/.claude/skills/worklog .claude/skills/worklog
$ curl -fsSL --create-dirs -o .claude/agents/adr.md https://raw.githubusercontent.com/tae0y/python-project-template/main/.claude/agents/adr.md
$ curl -fsSL --create-dirs -o .claude/agents/docs-guardian.md https://raw.githubusercontent.com/tae0y/python-project-template/main/.claude/agents/docs-guardian.md
$ curl -fsSL --create-dirs -o .claude/agents/learn.md https://raw.githubusercontent.com/tae0y/python-project-template/main/.claude/agents/learn.md
$ curl -fsSL --create-dirs -o .claude/agents/progress-guardian.md https://raw.githubusercontent.com/tae0y/python-project-template/main/.claude/agents/progress-guardian.md
$ curl -fsSL --create-dirs -o .claude/agents/refactor-scan.md https://raw.githubusercontent.com/tae0y/python-project-template/main/.claude/agents/refactor-scan.md
$ curl -fsSL --create-dirs -o .claude/agents/tdd-guardian.md https://raw.githubusercontent.com/tae0y/python-project-template/main/.claude/agents/tdd-guardian.md
$ curl -fsSL --create-dirs -o .claude/agents/use-case-data-patterns.md https://raw.githubusercontent.com/tae0y/python-project-template/main/.claude/agents/use-case-data-patterns.md

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

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/check-new-test-file.sh"
          }
        ]
      },
      {
        "matcher": "Write|Edit|Read|Bash",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/guard-settings-files.sh"
          }
        ]
      }
    ]
  }
}

MCP servers (5)

serversourceest. tokens
Context7 npm 1.2k
Chrome DevTools MCP · "chrome-devtools" npm 9.0k
@executeautomation/playwright-mcp-server · "playwright" npm 2.5k
Microsoft Learn Docs · "microsoft-learn" remote · remote 1.2k
jcodemunch-mcp · "jcodemunch" pypi 2.5k

Skills (23)

Subagents (7)

adr
model: sonnet
>
docs-guardian
model: sonnet
>
learn
model: sonnet
>
progress-guardian
model: sonnet
>
refactor-scan
model: sonnet
>
tdd-guardian
model: sonnet
>
use-case-data-patterns
model: sonnet
>

Hooks (5)

eventmatcherruns
PreToolUseWrite"$CLAUDE_PROJECT_DIR"/.claude/hooks/check-new-test-file.sh
PreToolUseWrite|Edit|Read|Bash"$CLAUDE_PROJECT_DIR"/.claude/hooks/guard-settings-files.sh
PostToolUseWrite|Edit"$CLAUDE_PROJECT_DIR"/.claude/hooks/check-external-lib-usage.sh
PostToolUseBash"$CLAUDE_PROJECT_DIR"/.claude/hooks/check-pre-commit-gate.sh
PostToolUseBash"$CLAUDE_PROJECT_DIR"/.claude/hooks/check-commit-convention.sh

Slash commands (1)

/resume-work

Similar rigs

copied ✓