# {{PROJECT_NAME}}

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

## What (Stack & Structure)

This project uses **Claude Craft** rules for AI-assisted development.

### Technologies
{TECH_LIST}

### Project Structure
```
{{PROJECT_ROOT}}/
├── .claude/
│   ├── references/   # Coding standards & architecture (auto-loaded)
│   ├── agents/       # Specialized AI agents
│   ├── commands/     # Slash commands (namespaced)
│   └── skills/       # Extended capabilities
└── src/              # Application source code
```

## Why (Purpose & Organization)

### Core Principles
- **Analysis Before Action**: Always understand code before modifying (see `references/01-workflow-analysis.md`)
- **SOLID + KISS**: Clean, maintainable code (see `references/04-solid-principles.md`)
- **TDD/BDD**: Test-driven development (see `references/07-testing.md`)
- **Security First**: OWASP compliance (see `references/11-security.md`)

### Architecture
Refer to `.claude/references/02-architecture*.md` for detailed patterns.

## How (Commands & Workflows)

### Available Agents
{AGENTS_LIST}

### Available Commands
{COMMANDS_LIST}

### Essential Commands
```bash
make help              # Show all commands
make test              # Run tests
make quality           # Run quality checks
make build             # Build project
```

### Development Workflow
1. **Analyze** - Read existing code, identify impacts
2. **Test First** - Write failing test (RED)
3. **Implement** - Minimal code to pass (GREEN)
4. **Refactor** - Clean up while tests pass
5. **Quality** - Run `make quality` before commit

## References

| Topic | Reference File |
|-------|----------------|
| Workflow | `references/01-workflow-analysis.md` |
| Architecture | `references/02-architecture*.md` |
| Coding Standards | `references/03-coding-standards.md` |
| SOLID Principles | `references/04-solid-principles.md` |
| KISS/DRY/YAGNI | `references/05-kiss-dry-yagni.md` |
| Testing | `references/07-testing.md` |
| Security | `references/11-security.md` |

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

<!-- Add your project-specific instructions below -->
<!-- This section is preserved during updates -->

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