# {{PROJECT_NAME}} - React

> Generated: {{GENERATION_DATE}} | Claude Craft v{{VERSION}}

## What (Stack & Structure)

**Stack**: React {{REACT_VERSION}}, TypeScript {{TYPESCRIPT_VERSION}}, {{BUILD_TOOL}}

### Project Structure
```
src/
├── components/        # Reusable UI components
│   ├── ui/           # Base components (Button, Input)
│   └── features/     # Feature-specific components
├── hooks/            # Custom React hooks
├── pages/            # Page components / routes
├── services/         # API calls, external services
├── stores/           # State management
├── types/            # TypeScript types/interfaces
└── utils/            # Helper functions
```

## Why (Purpose & Organization)

### Architecture: Component-Based + Feature-First
- **Components**: Small, reusable, single responsibility
- **Hooks**: Logic extraction and reuse
- **Services**: API abstraction layer

See `rules/02-architecture.md` for complete patterns.

### Critical Rules
| Rule | Reason |
|------|--------|
| TypeScript strict | Type safety |
| Component isolation | Testable, reusable |
| Custom hooks | Logic separation |
| 80%+ coverage | Quality assurance |

## How (Commands & Workflows)

### Development Commands
```bash
npm run dev           # Start dev server
npm run build         # Production build
npm run test          # Run tests
npm run lint          # ESLint check
npm run type-check    # TypeScript check
```

### Quality Pipeline
```bash
npm run lint          # ESLint
npm run type-check    # TypeScript
npm run test          # Jest/Vitest
npm run build         # Verify build
```

### Development Workflow
1. **Analyze** - Understand component hierarchy (`rules/01-workflow-analysis.md`)
2. **TDD** - Write test → Implement → Refactor
3. **Quality** - Run `npm run lint && npm run test`
4. **Commit** - Conventional Commits format

## References

| Topic | Rule File |
|-------|-----------|
| Analysis | `rules/01-workflow-analysis.md` |
| Architecture | `rules/02-architecture.md` |
| TypeScript | `rules/03-coding-standards.md` |
| SOLID | `rules/04-solid-principles.md` |
| State Management | `rules/06-state-management.md` |
| Testing | `rules/07-testing.md` |
| Performance | `rules/08-performance.md` |

<!-- PROJECT-SPECIFIC-START -->
## Project Specifics

{{TECH_STACK}}

<!-- Add project-specific configuration below -->

<!-- PROJECT-SPECIFIC-END -->
