claude-config-tdd

Opinionated Claude Code setup: TDD workflow, sub-agents, safe permissions, MCP servers.

Features

• TDD workflow — qa writes tests → frontend/backend implement → reviewer reviews
• 5 sub-agents — architect, frontend, backend, qa, reviewer
• 4 commands — /fix, /review, /test, /test-new
• Safe defaults — git writes, sudo, rm, .env denied; test runners and linters auto-allowed
• MCP servers — Chrome DevTools, Context7

Install

git clone https://github.com/eugeek/claude-config-tdd.git
cd claude-config-tdd
./install.sh

Existing ~/.claude is moved to ~/.claude-old.

Add to ~/.zshrc:

export CONTEXT7_API_KEY="..."

Workflow

New feature — Opus + Plan Mode (Shift+Tab):

1. Complex task → architect reviews structure
2. Plan: feature → decomposition + files → result

Implementation — Sonnet + auto-accept (Shift+Tab twice):

1. qa writes tests (red)
2. frontend / backend / both implement (green)
3. reviewer reviews

Skip TDD — prefix with quick::

quick: fix typo in button label

Commands

Command	Purpose
/fix	Reviewer agent + auto-fix safe issues
/review	Fresh-perspective code review
/test	Run tests, auto-detect runner
/test-new	Generate tests for untested code

Agents

Agent	Role
architect	Structure analysis, plan mode only
frontend	React, TypeScript, UI
backend	API, database, auth, server
qa	Writes tests before implementation
reviewer	Reviews after green

Permissions

• Denied — git add/commit/push/pull/merge/rebase/stash, sudo, rm, .env read/write
• Allowed — npm/yarn/pnpm/bun/npx, vitest/jest/pytest, tsc/mypy/ruff/eslint/biome, read-only git
• Ask — everything else

Structure

.
├── agents/      Sub-agent definitions
├── commands/    Slash commands
├── rules/       Code style, TDD, plan mode, etc.
├── CLAUDE.md    Loads rules into context
├── settings.json
├── mcp.json
└── install.sh

API keys

• Context7 — https://context7.com/dashboard