xinweiiiii/claude-code-template-nextjs-fastapi
Claude Code setup template for Next.js + FastAPI projects — includes CLAUDE.md, custom agents, and reusable skills
field: unknown workflow: Frontend & designPlanning & specsPR / code reviewTesting & TDDGit & commits
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
GUARDRAILS
3/5
Blocks destructive commands · Pre-tool screening hook · No YOLO mode · details
Quality 18/100 Guardrails v2
Copy this rig
# review before running: this installs third-party code
$ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude ./rig-claude-code-template-nextjs-fastapi # 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 xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/code-structure .claude/skills/code-structure $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/coding-patterns .claude/skills/coding-patterns $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/deployment-patterns .claude/skills/deployment-patterns $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/docker-publish .claude/skills/docker-publish $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/fastapi-architecture .claude/skills/fastapi-architecture $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/nextjs-advanced-routing .claude/skills/nextjs-advanced-routing $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/nextjs-anti-patterns .claude/skills/nextjs-anti-patterns $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/nextjs-app-router-fundamental .claude/skills/nextjs-app-router-fundamental $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/nextjs-client-cookie-pattern .claude/skills/nextjs-client-cookie-pattern $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/postgres-patterns .claude/skills/postgres-patterns $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/project-setup .claude/skills/project-setup $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/pydantic-patterns .claude/skills/pydantic-patterns $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/python-testing .claude/skills/python-testing $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/redis .claude/skills/redis $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/rest-response-standard .claude/skills/rest-response-standard $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/speckit-agent-context-update .claude/skills/speckit-agent-context-update $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/speckit-analyze .claude/skills/speckit-analyze $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/speckit-checklist .claude/skills/speckit-checklist $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/speckit-clarify .claude/skills/speckit-clarify $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/speckit-constitution .claude/skills/speckit-constitution $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/speckit-git-commit .claude/skills/speckit-git-commit $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/speckit-git-feature .claude/skills/speckit-git-feature $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/speckit-git-initialize .claude/skills/speckit-git-initialize $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/speckit-git-remote .claude/skills/speckit-git-remote $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/speckit-git-validate .claude/skills/speckit-git-validate $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/speckit-implement .claude/skills/speckit-implement $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/speckit-plan .claude/skills/speckit-plan $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/speckit-specify .claude/skills/speckit-specify $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/speckit-tasks .claude/skills/speckit-tasks $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/speckit-taskstoissues .claude/skills/speckit-taskstoissues $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/tailwind-css .claude/skills/tailwind-css $ npx degit xinweiiiii/claude-code-template-nextjs-fastapi/.claude/skills/well-designed-api-patterns .claude/skills/well-designed-api-patterns
$ curl -fsSL --create-dirs -o .claude/agents/code-reviewer.md https://raw.githubusercontent.com/xinweiiiii/claude-code-template-nextjs-fastapi/main/.claude/agents/code-reviewer.md $ curl -fsSL --create-dirs -o .claude/agents/pr-writer.md https://raw.githubusercontent.com/xinweiiiii/claude-code-template-nextjs-fastapi/main/.claude/agents/pr-writer.md $ curl -fsSL --create-dirs -o .claude/agents/security-auditor.md https://raw.githubusercontent.com/xinweiiiii/claude-code-template-nextjs-fastapi/main/.claude/agents/security-auditor.md $ curl -fsSL --create-dirs -o .claude/agents/self-reviewer.md https://raw.githubusercontent.com/xinweiiiii/claude-code-template-nextjs-fastapi/main/.claude/agents/self-reviewer.md $ curl -fsSL --create-dirs -o .claude/agents/test-writer.md https://raw.githubusercontent.com/xinweiiiii/claude-code-template-nextjs-fastapi/main/.claude/agents/test-writer.md
Merge into .claude/settings.json (project) or ~/.claude/settings.json (user). Hook commands reference scripts in the source repo — copy those too.
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "python3 \"${PROJECT_ROOT:-.}/.claude/hooks/block_dangerous.py\""
}
]
}
]
}
} Skills (32)
code-structureclean-code-production-patternsdeployment-patternsdocker-publishfastapi-architecturenextjs-anti-patternsnextjs-anti-patternsnextjs-advanced-routingnextjs-client-cookie-patternpostgres-patternsproject-setuppydantic-patternspython-testingredisrest-response-standardspeckit-agent-context-updatespeckit-analyzespeckit-checklistspeckit-clarifyspeckit-constitutionspeckit-git-commitspeckit-git-featurespeckit-git-initializespeckit-git-remotespeckit-git-validatespeckit-implementspeckit-planspeckit-specifyspeckit-tasksspeckit-taskstoissuestailwindcsswell-designed-api-patterns
Subagents (5)
| code-reviewer model: opus | Reviews code for style, correctness, security, and performance. Use after any implementation is complete. |
| pr-writer model: opus | Creates a pull request with a high-quality PR description. Use when opening a PR — produces a clear problem statement, solution rationale, deployment notes, and test evidence. Does NOT just summarise |
| security-auditor model: claude-opus-4-6 | Reviews code for security risks, authentication gaps, authorization flaws, secrets exposure, injection vectors, and unsafe data handling in FastAPI and Next.js |
| self-reviewer model: opus | Blunt pre-PR review of the author's own uncommitted or unpushed changes. Use before opening a PR, to catch what a reviewer would reject. Runs a staged pass — scope, correctness, standards, devil's adv |
| test-writer model: sonnet | Writes comprehensive tests for FastAPI and Next.js with explicit assertions, realistic test data, and clear coverage of happy paths, error cases, and edge cases. Delegate to this agent for any test cr |
Hooks (3)
| event | matcher | runs |
|---|---|---|
| PostToolUse | Write|Edit | FILE=$(python3 -c "import sys,json; print(json.load(sys.stdin).get('tool_input',{}).get('file_path',''))"); EXT="${FILE##*.}"; cd "${PROJECT_ROOT:-.}"; case "$EXT" in ts|tsx|js|jsx) npx eslint --fix "$FILE" || true; npx prettier --write "$F |
| PreToolUse | Bash | python3 "${PROJECT_ROOT:-.}/.claude/hooks/block_dangerous.py" |
| Stop | * | python3 "${PROJECT_ROOT:-.}/.claude/hooks/session_summary.py" |
Slash commands (7)
/open-pr/pre-pr/review/security-audit/self-review/test-and-review/write-tests
Similar rigs
mahendrjy/dotfiles
My automate dotfiles
Skill Collector 535 tok · · Q0
gyasis/chiron
Universal LLM-powered lesson generator for solo learners across code, medicine, and language. Self-contained interactive lesson HTML. Q8 architecture: parent Claude Code agent runs all text-LLM steps; built as a Claude Code skill.
Skill Collector 2.7k tok · · Q50
CodyAMaughan/agent-first-engineering
A curriculum + an agent-agnostic scaffolder for agent-first software engineering: design your codebase so AI coding agents (Claude Code, Codex, Cursor) succeed.
Skill Collector 3.1k tok · · Q60
alfredoperez/speckit-companion
VS Code extension for spec-driven development — manage specs, workflows, and steering docs for AI CLI tools (Claude Code, Gemini CLI, Copilot CLI)
Skill Collector 3.2k tok · · Q8