~ / rigs / triat / claude-projects-template

triat/claude-projects-template

A structured Claude Code template with persistent task management, enforced TDD workflows, 9 specialized agents, and a design system — copy into any project to make Claude consistently excellent.

↗ GitHub ★ 0 no license updated 8mo ago project Claude Code
share on X
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
CONTEXT TAX · EVERY TURN
~22.8k 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 github -e GITHUB_PERSONAL_ACCESS_<redacted> -- npx -y @modelcontextprotocol/server-github
$ claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres ${DATABASE_URL}
$ claude mcp add fetch -- npx -y @modelcontextprotocol/server-fetch
$ npx degit triat/claude-projects-template/.claude ./rig-claude-projects-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 github -e GITHUB_PERSONAL_ACCESS_<redacted> -- npx -y @modelcontextprotocol/server-github
$ claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres ${DATABASE_URL}
$ claude mcp add fetch -- npx -y @modelcontextprotocol/server-fetch
$ curl -fsSL --create-dirs -o .claude/agents/architect.md https://raw.githubusercontent.com/triat/claude-projects-template/main/.claude/agents/architect.md
$ curl -fsSL --create-dirs -o .claude/agents/build-error-resolver.md https://raw.githubusercontent.com/triat/claude-projects-template/main/.claude/agents/build-error-resolver.md
$ curl -fsSL --create-dirs -o .claude/agents/code-reviewer.md https://raw.githubusercontent.com/triat/claude-projects-template/main/.claude/agents/code-reviewer.md
$ curl -fsSL --create-dirs -o .claude/agents/debugger.md https://raw.githubusercontent.com/triat/claude-projects-template/main/.claude/agents/debugger.md
$ curl -fsSL --create-dirs -o .claude/agents/planner.md https://raw.githubusercontent.com/triat/claude-projects-template/main/.claude/agents/planner.md
$ curl -fsSL --create-dirs -o .claude/agents/refactor-cleaner.md https://raw.githubusercontent.com/triat/claude-projects-template/main/.claude/agents/refactor-cleaner.md
$ curl -fsSL --create-dirs -o .claude/agents/security-reviewer.md https://raw.githubusercontent.com/triat/claude-projects-template/main/.claude/agents/security-reviewer.md
$ curl -fsSL --create-dirs -o .claude/agents/tdd-guide.md https://raw.githubusercontent.com/triat/claude-projects-template/main/.claude/agents/tdd-guide.md
$ curl -fsSL --create-dirs -o .claude/agents/ui-designer.md https://raw.githubusercontent.com/triat/claude-projects-template/main/.claude/agents/ui-designer.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(git push --force origin main*)",
      "Bash(git push --force origin master*)",
      "Bash(git push -f origin main*)",
      "Bash(git push -f origin master*)",
      "Bash(git reset --hard HEAD~*)",
      "Bash(rm -rf /*)",
      "Bash(rm -rf ~*)",
      "Bash(chmod 777*)",
      "Bash(sudo rm*)"
    ]
  },
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "bash .claude/hooks/pre-bash-guard.sh"
          }
        ]
      }
    ]
  }
}

MCP servers (3)

serversourceest. tokens
GitHub MCP · "github"
env: GITHUB_PERSONAL_ACCESS_TOKEN
npm 18.0k
Postgres npm 600
Fetch npm 450

Subagents (9)

architect
model: opus
Evaluates architectural trade-offs and documents decisions as ADRs. Invoke when choosing between fundamentally different technical approaches, adding a major dependency, or restructuring how component
build-error-resolver
model: sonnet
Systematically diagnoses and resolves build failures, compilation errors, and broken test suites. Invoke when the build or tests are failing and the cause is not immediately obvious.
code-reviewer
model: sonnet
Reviews code for bugs, logic errors, quality issues, and adherence to project conventions. Invoke after implementing a feature and before committing.
debugger
model: sonnet
Investigates bugs using systematic root-cause analysis. Invoke when a bug's cause is unclear, a fix isn't working, or an issue is intermittent.
planner
model: sonnet
Creates detailed implementation plans before any code is written. Invoke when starting a new feature or task, or when requirements need to be thought through before touching code.
refactor-cleaner
model: sonnet
Cleans up code without changing behavior — removes dead code, reduces complexity, improves naming. Invoke when code needs structural improvement but no new functionality.
security-reviewer
model: opus
Audits code for security vulnerabilities including injection, auth flaws, and data exposure. Invoke before committing any changes touching auth, APIs, user input, or database queries.
tdd-guide
model: sonnet
Enforces test-driven development by ensuring tests are written before implementation. Invoke when implementing any new feature or bug fix.
ui-designer
model: sonnet
Builds UI components and screens consistent with the project design system. Invoke for any UI work — new components, full screens, layouts, or restyling existing UI.

Hooks (2)

eventmatcherruns
PostToolUseWrite|Editbash .claude/hooks/post-edit-format.sh
PreToolUseBashbash .claude/hooks/pre-bash-guard.sh

Slash commands (9)

/commit/debug/feature/init/plan/refactor/review/test/ui

Permissions

deny (9)
Bash(git push --force origin main*)
Bash(git push --force origin master*)
Bash(git push -f origin main*)
Bash(git push -f origin master*)
Bash(git reset --hard HEAD~*)
Bash(rm -rf /*)
Bash(rm -rf ~*)
Bash(chmod 777*)
Bash(sudo rm*)
ask (0)
—
allow (38)
Bash(git status)
Bash(git diff*)
Bash(git log*)
Bash(git add*)
Bash(git stash*)
Bash(git stash pop)
Bash(git branch*)
Bash(git checkout*)
Bash(git fetch*)
Bash(git merge*)
Bash(git rebase*)
Bash(git show*)
Bash(git blame*)
Bash(npm install*)
Bash(npm run*)
Bash(npm test*)
Bash(npx*)
Bash(yarn*)
Bash(pnpm*)
Bash(python*)
Bash(pip install*)
Bash(pytest*)
Bash(go test*)
Bash(go build*)
Bash(go run*)
Bash(go mod*)
Bash(docker compose up*)
Bash(docker compose down*)
Bash(docker compose logs*)
Bash(ls*)
Bash(cat*)
Bash(echo*)
Bash(mkdir*)
Bash(cp*)
Bash(mv*)
Bash(which*)
Bash(env*)
Bash(pwd)

Similar rigs

copied ✓