~ / rigs / gouravchawla334 / claude-code-field-guide

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.

↗ GitHub ★ 0 MIT updated 2d ago project Claude Code Claude plugin
stack: PythonShell
share on X
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)

serversourceest. 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)

eventmatcherruns
SessionStart*bash "$CLAUDE_PROJECT_DIR/.claude/hooks/session-start.sh"
UserPromptSubmit*bash "$CLAUDE_PROJECT_DIR/.claude/hooks/inject-prd-reminder.sh"
PreToolUseRead|Edit|Write|Bashbash "$CLAUDE_PROJECT_DIR/.claude/hooks/protect-secrets.sh"
PostToolUseEdit|Writebash "$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

copied ✓