~ / rigs / xinweiiiii / claude-code-template-nextjs-fastapi

xinweiiiii/claude-code-template-nextjs-fastapi

Claude Code setup template for Next.js + FastAPI projects — includes CLAUDE.md, custom agents, and reusable skills

↗ GitHub ★ 2 no license updated 3mo ago project Claude CodeCodex
share on X
ARCHETYPE
Orchestrator
A bench of specialised subagents. The main agent mostly delegates.
CONTEXT TAX · EVERY TURN
~3.0k tokens
Moderate · median rig: 2.3k · breakdown
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)

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)

eventmatcherruns
PostToolUseWrite|EditFILE=$(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
PreToolUseBashpython3 "${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

copied ✓