afrexai-claude-code-production

# Claude Code Production Engineering

The complete methodology for shipping production code with Claude Code at 10X speed. Not installation scripts — actual patterns, workflows, and techniques that compound your output.

---

## Quick Health Check (run mentally before every session)

| Signal | Healthy | Fix |
|--------|---------|-----|
| CLAUDE.md exists at project root | ✅ | Create one (see §1) |
| .claueignore configured | ✅ | Add noise directories |
| Session context under 60% | ✅ | `/compact` or start fresh |
| Clear task scope before prompting | ✅ | Write task brief first |
| Tests exist for target code | ✅ | Write tests first (§7) |
| Git clean before big changes | ✅ | Commit or stash |
| Sub-agents for parallel work | ✅ | Use `/new` or Task tool |
| Verifying output, not trusting blindly | ✅ | Always review diffs |

Score: /8. Below 6 = slow, buggy sessions. Fix before coding.

---

## 1. Project Setup — CLAUDE.md Architecture

CLAUDE.md is your project's brain. Claude reads it at session start. A good one saves thousands of tokens per session.

### Template

```markdown
# Project: [name]

## Tech Stack
- Language: TypeScript (strict mode)
- Framework: Next.js 15 App Router
- Database: PostgreSQL via Drizzle ORM
- Testing: Vitest + Playwright
- Styling: Tailwind CSS v4

## Architecture Rules
- Max 50 lines per function, 300 lines per file
- One responsibility per file
- All exports typed — no `any`
- Errors as values (Result type), not thrown exceptions
- Database: migrations via `drizzle-kit generate` then `drizzle-kit push`

## File Structure
src/
  app/         → Next.js routes (thin — call services)
  lib/         → Business logic (pure functions)
  db/          → Schema, migrations, queries
  components/  → UI (server components default, 'use client' only when needed)
  types/       → Shared type definitions

## Commands
- `pnpm dev` — start dev server
- `pnpm test` — run vitest
- `pnpm test:e2e` — run playwright
- `pnpm lint` — eslint + tsc --n...

# Claude Code Production Engineering ⚡

Ship production code at 10X speed with Claude Code. Not installation scripts — actual patterns, workflows, and techniques.

## Install

```bash
clawhub install afrexai-claude-code-production
```

## What's Inside

- **CLAUDE.md architecture** — template + rules for maximum context efficiency
- **5 prompting patterns** that actually work (task brief, show don't tell, incremental, evidence-based, architecture discussion)
- **Context management system** — when to compact, when to start fresh, habits that save tokens
- **Sub-agent orchestration** — parallel productivity with Task tool and handoff documents
- **DEBUG protocol** — systematic debugging, not random guessing
- **Safe refactoring** — multi-file changes without breaking anything
- **TDD loop with Claude** — tests as acceptance criteria, minimum code to pass
- **Git workflow** — commit strategy, PR creation, branch management
- **Code review mode** — use Claude as reviewer before PRs
- **Production checklist** — P0/P1/P2 checks before deploying AI-generated code
- **Speed multipliers** — model selection, slash commands, session stacking
- **4 workflow templates** — new feature, bug fix, refactoring, research spike
- **Productivity metrics** — track and improve your output weekly

## Quick Start

1. Install the skill
2. Run: "Set up my project for Claude Code"
3. Start coding with Task Brief prompts (see §2)

## vs. Other Claude Code Skills

Other skills install Claude Code and create subagent configs. This skill teaches you the **methodology** — how to prompt, manage context, debug, refactor, test, and ship. Zero scripts, pure knowledge.

## ⚡ Level Up

Want production-grade AI context for your specific industry?

**[AfrexAI Context Packs — $47](https://afrexai-cto.github.io/context-packs/)** — Complete agent configurations for SaaS, Fintech, Healthcare, Legal, Ecommerce, and 5 more verticals.

## 🔗 More Free Skills by AfrexAI

- [afrexai-prompt-engineering](https://cl...