# CLAUDE.md

## Project Overview

**Stack**: [Swift / SwiftUI / iOS | Kotlin / Compose / Android | Python / FastAPI | Node.js / React]
**Architecture**: [Component-driven | MVVM | Clean Architecture]
**Testing**: [ViewInspector / Snapshot / XCTest | Compose Testing / JUnit | pytest]
**Build**: [Xcode / xcodebuild | Gradle | npm / yarn]

---

## Terminal Pipeline (All Projects)

### Pipeline Phases

1. Analysis (Opus) -> scope, impact analysis
2. Planning (Opus) -> spec, task breakdown
3. Development (Sonnet) -> TDD, code, build
4. Review -> deterministic gates + parallel review + Fable triage
   - Claude Code: Opus + Sonnet (2 paralel)
   - Copilot CLI: GPT-5.4 + Opus + Sonnet (3 paralel)
   - Codex CLI: gpt-5.6 (xhigh) + gpt-5.4 + gpt-5.6 (medium) (3 paralel)

### Strict Rules

- **Author**: Git Identity from preferences (not Keychain)
- **Branch**: `bugfix/{JIRA_KEY}-{id}` or `feature/{JIRA_KEY}-{id}`
- **Commit**: `{type}(scope): description [{JIRA_KEY}-{id}]`
- No "Copilot", "AI", "generated by" in code  -  FORBIDDEN
- No unnecessary comments
- Never commit without passing build
- Self-documenting code, follow existing style

### Issue Management

- NEVER auto-close issues (GitHub or Jira)  -  approvals required
- PR body: use `Ref: #N` or `Related: #N`  -  never `Closes/Fixes/Resolves`

---

## Modular Rules (loaded from rules/)

| File                      | Content                                       |
| ------------------------- | --------------------------------------------- |
| `code-style.md`           | Naming, structure, patterns                   |
| `git-conventions.md`      | Commit messages, branching, rules             |
| `testing.md`              | Test naming, structure, coverage              |
| `tdd.md`                  | Red-Green-Refactor, testing pyramid           |
| `code-review.md`          | Review priority, severity, security checklist |
| `security.md`             | Keychain, ATS, credentials, privacy           |
| `performance.md`          | Bottlenecks, caching strategy                 |
| `debugging.md`            | Scientific debugging method                   |
| `app-store-guidelines.md` | App Store Review Guidelines summary           |
| `figma-pipeline.md`       | Figma -> SwiftUI component generation         |
| `swiftui-qa.md`           | 3-layer test strategy, 13-item checklist      |
| `kotlin-android.md`       | Kotlin & Android conventions                  |