gouravchawla334/claude-code-field-guide
Production-grade field guide, modular curriculum, and reference architecture for Claude Code, agentic workflows, deterministic hooks, and spec-driven development.
ARCHETYPE
Fort Knox
Deny lists, pre-tool hooks, sandboxing. Nothing touches prod without a signature.
CONTEXT TAX · EVERY TURN
up to ~21.9k tokens
Claude Code loads MCP tools on demand, so the real cost is usually lower.
Context hog · 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 74/100 Guardrails v2
Copy this rig
# review before running: this installs third-party code $ claude mcp add orders-db -- uvx mcp-server-sqlite --db-path ./data/orders.db $ claude mcp add --transport http github https://api.githubcopilot.com/mcp/ -H 'Authorization: YOUR_VALUE' -H 'X-MCP-Readonly: YOUR_VALUE' $ npx degit gouravchawla334/claude-code-field-guide/.claude ./rig-claude-code-field-guide # 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 orders-db -- uvx mcp-server-sqlite --db-path ./data/orders.db $ claude mcp add --transport http github https://api.githubcopilot.com/mcp/ -H 'Authorization: YOUR_VALUE' -H 'X-MCP-Readonly: YOUR_VALUE'
$ npx degit gouravchawla334/claude-code-field-guide/.claude/skills/spec-driven-dev .claude/skills/spec-driven-dev $ curl -fsSL --create-dirs -o .claude/agents/data-quality-auditor.md https://raw.githubusercontent.com/gouravchawla334/claude-code-field-guide/main/.claude/agents/data-quality-auditor.md $ curl -fsSL --create-dirs -o .claude/agents/unit-estimator.md https://raw.githubusercontent.com/gouravchawla334/claude-code-field-guide/main/.claude/agents/unit-estimator.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(./secrets/**)",
"Read(**/*.pem)",
"Read(**/*.key)",
"Read(**/credentials*)",
"Bash(rm -rf:*)",
"Bash(git push --force:*)",
"Bash(git push -f:*)",
"Bash(git reset --hard:*)",
"Bash(curl:*)",
"Bash(wget:*)",
"Bash(sudo:*)",
"mcp__orders-db__write_query",
"mcp__orders-db__create_table",
"mcp__orders-db__drop_table",
"mcp__orders-db__modify_table"
],
"ask": [
"Bash(git commit:*)",
"Bash(git push:*)"
]
},
"hooks": {
"PreToolUse": [
{
"matcher": "Read|Edit|Write|Bash",
"hooks": [
{
"type": "command",
"command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/protect-secrets.sh\""
}
]
}
]
}
} MCP servers (2)
| server | source | est. tokens |
|---|---|---|
| mcp-server-sqlite · "orders-db" | pypi | 2.5k |
| GitHub MCP · "github" | remote · remote | 18.0k |
Skills (1)
Subagents (2)
| data-quality-auditor model: sonnet | Read-only auditor that checks code, schemas and data against PRD.md (column contract, null and duplicate rules, dedup and quarantine rules, SLAs). Use proactively after any change to pipeline/ code or |
| unit-estimator model: sonnet | Breaks SPEC.md (derived from PRD.md) into small, independently testable work units traced to PRD requirement IDs, and estimates effort and risk. Use proactively after a SPEC.md is written and before i |
Hooks (6)
| event | matcher | runs |
|---|---|---|
| SessionStart | * | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/session-start.sh" |
| UserPromptSubmit | * | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/inject-prd-reminder.sh" |
| PreToolUse | Read|Edit|Write|Bash | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/protect-secrets.sh" |
| PostToolUse | Edit|Write | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/ruff-fix.sh" |
| Stop | * | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/test-gate.sh" |
| SubagentStop | * | bash "$CLAUDE_PROJECT_DIR/.claude/hooks/test-gate.sh" |
Slash commands (1)
/audit-prd
Permissions
deny (17)
Read(./.env)
Read(./.env.*)
Read(./secrets/**)
Read(**/*.pem)
Read(**/*.key)
Read(**/credentials*)
Bash(rm -rf:*)
Bash(git push --force:*)
Bash(git push -f:*)
Bash(git reset --hard:*)
Bash(curl:*)
Bash(wget:*)
Bash(sudo:*)
mcp__orders-db__write_query
mcp__orders-db__create_table
mcp__orders-db__drop_table
mcp__orders-db__modify_table
ask (2)
Bash(git commit:*)
Bash(git push:*)
allow (13)
Read(./pipeline/**)
Read(./tests/**)
Read(./PRD.md)
Bash(python3 -m pytest:*)
Bash(python -m pytest:*)
Bash(pytest:*)
Bash(ruff check:*)
Bash(ruff format:*)
Bash(git status)
Bash(git diff:*)
Bash(git log:*)
Bash(git branch --show-current)
Bash(sqlite3 -readonly:*)
Similar rigs
lee-to/ai-workspace
AI Workspace - Give your AI agents memory that spans across projects.
Pragmatist 19.7k tok · · Q0
ChooJeongHo/MovieFinder
TMDB API를 활용한 영화 검색 Android 앱
Pragmatist 25.0k tok · · Q0
feng-2/codex-spec-workflow
A minimal, Kiro-inspired spec-driven workflow for Codex with portable language packs, strict validation, and repo-local plugin support.
Minimalist 952 tok · · Q0
heyong4725/claude-setup
Claude Code professional setup for Rust development
Pragmatist 19.1k tok · · Q0