Claude Code 2.1 Power User Guide

# Feature: [Name]

## Goal
What problem does this solve?

## Success Criteria
- [ ] Criterion 1
- [ ] Criterion 2

## Technical Approach
### Phase 1: Foundation
- Setup, scaffolding, types

### Phase 2: Core Logic
- Main implementation

### Phase 3: Polish
- Error handling, tests, docs

## Non-Goals
What we're NOT building

# Project: [Name]

## Tech Stack
- Language: TypeScript
- Framework: Next.js 14
- Database: PostgreSQL + Prisma
- Testing: Vitest, Playwright

## Project Structure
src/
├── app/          # Next.js app router
├── components/   # React components
├── lib/          # Shared utilities
└── server/       # API routes

## Code Conventions
- Use functional components with hooks
- Prefer `type` over `interface`
- Use absolute imports (@/)
- Co-locate tests with source files

## Common Commands
- `pnpm dev` - Start dev server
- `pnpm test` - Run unit tests
- `pnpm lint` - ESLint + Prettier

## Development Workflow
1. Create feature branch from main
2. Write tests first (TDD preferred)
3. Run lint before committing
4. Use conventional commits

## Things to Remember
- Auth uses NextAuth with GitHub provider
- All API routes need rate limiting
- Images served via Cloudinary

## Do NOT
- Use `any` type without justification
- Commit without running tests
- Use npm (we use pnpm)
- Push directly to main

Skills are markdown files with YAML frontmatter in .claude/skills/:

# .claude/skills/my-deploy.md
---
name: deploy-preview
description: Deploy to preview environment
context: fork          # Runs in isolated sub-agent
model: sonnet          # Use faster model
hooks:
  post-tool-use: notify-slack
---

## Instructions
1. Run the build command: `pnpm build`
2. Deploy to Vercel preview: `vercel --prebuilt`
3. Return the preview URL
4. Post to #deploys Slack channel

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@anthropic/context7-mcp"]
    },
    "browser": {
      "command": "npx", 
      "args": ["-y", "@anthropic/browser-mcp"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic/filesystem-mcp", "/path/to/allowed"]
    }
  }
}

1. 1.
   Install the Claude GitHub App

   Go to github.com/apps/claude and install on your repo

2. 2.
   Add API key to repository secrets

   Settings → Secrets → Actions → New secret: ANTHROPIC_API_KEY

3. 3.
   Create workflow file

   Add .github/workflows/claude.yml:

   name: Claude Code Action
   on:
     issue_comment:
       types: [created]
     pull_request_review_comment:
       types: [created]
   
   jobs:
     claude:
       if: contains(github.event.comment.body, '@claude')
       runs-on: ubuntu-latest
       permissions:
         contents: write
         pull-requests: write
         issues: write
       steps:
         - uses: actions/checkout@v4
         - uses: anthropics/claude-code-action@v1
           with:
             anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

4. 4.
   Start using!

   Comment @claude [your request] on any issue or PR