~ / rigs / jvitorcosta / python-uv-claude-template

jvitorcosta/python-uv-claude-template

Copier template: Python + uv + ruff + mypy + pytest + Makefile + full Claude Code setup

↗ GitHub ★ 0 no license updated 27d ago project Claude Code
field: unknown workflow: PR / code review
stack: Python
share on X
ARCHETYPE
Fort Knox
Deny lists, pre-tool hooks, sandboxing. Nothing touches prod without a signature.
CONTEXT TAX · EVERY TURN
~167 tokens
Featherweight · median rig: 2.3k · breakdown
GUARDRAILS
5/5
Blocks destructive commands · Protects secrets · Pre-tool screening hook · No YOLO mode · Sandbox or ask-first rules · details
Quality 26/100 Guardrails v2

Copy this rig

# review before running: this installs third-party code
$ npx degit jvitorcosta/python-uv-claude-template/template/.claude ./rig-python-uv-claude-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.

$ npx degit jvitorcosta/python-uv-claude-template/template/.claude/skills/release .claude/skills/release
$ curl -fsSL --create-dirs -o .claude/agents/code-reviewer.md https://raw.githubusercontent.com/jvitorcosta/python-uv-claude-template/main/template/.claude/agents/code-reviewer.md
$ curl -fsSL --create-dirs -o .claude/agents/security-auditor.md https://raw.githubusercontent.com/jvitorcosta/python-uv-claude-template/main/template/.claude/agents/security-auditor.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(./**/*.pem)",
      "Read(./**/*.key)",
      "Bash(pip install:*)",
      "Bash(sudo:*)"
    ],
    "ask": [
      "Bash(git push:*)",
      "Bash(uv publish:*)"
    ]
  },
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "uv run --no-project --quiet \"$CLAUDE_PROJECT_DIR/.claude/hooks/validate_bash.py\""
          }
        ]
      }
    ]
  }
}

Skills (1)

Subagents (2)

code-reviewer
model: sonnet
Reviews Python changes for correctness, readability, tests and adherence to project conventions. Use proactively after writing or modifying code, and for /review.
security-auditor
model: sonnet
Audits code for security vulnerabilities (injection, secrets, unsafe deserialisation, path traversal, dependency risk). Use when changes touch input handling, subprocess, files, auth, network or confi

Hooks (2)

eventmatcherruns
PreToolUseBashuv run --no-project --quiet "$CLAUDE_PROJECT_DIR/.claude/hooks/validate_bash.py"
PostToolUseEdit|MultiEdit|Writeuv run --no-project --quiet "$CLAUDE_PROJECT_DIR/.claude/hooks/format_python.py"

Slash commands (2)

/fix-issue/review

Permissions

deny (6)
Read(./.env)
Read(./.env.*)
Read(./**/*.pem)
Read(./**/*.key)
Bash(pip install:*)
Bash(sudo:*)
ask (2)
Bash(git push:*)
Bash(uv publish:*)
allow (13)
Bash(make:*)
Bash(uv run:*)
Bash(uv sync:*)
Bash(uv add:*)
Bash(uv remove:*)
Bash(uv lock:*)
Bash(uv tree:*)
Bash(git status:*)
Bash(git diff:*)
Bash(git log:*)
Bash(git switch:*)
Bash(gh issue view:*)
Bash(gh pr view:*)

Similar rigs

copied ✓