# CLAUDE.md System — Phase Index

This folder documents the Habib Cables ERP `CLAUDE.md` documentation system **by build phase**.
Each phase folder contains the deliverables produced in that phase, so you can revisit any phase in
isolation and understand it completely.

> The live entry point is the root [`CLAUDE.md`](../../CLAUDE.md) (auto-loaded by Claude Code). It is
> the Phase 4 deliverable and links into the phase folders below.

## The six phases

| Phase | Deliverable | Folder |
|-------|-------------|--------|
| **1 — Analyze** | Project structure analysis, common patterns, integration points, architecture proposal | [phase-1-analysis/ANALYSIS.md](phase-1-analysis/ANALYSIS.md) |
| **2 — Components** | Repository/component-specific docs for each boundary (web core, shop POS, desktop sync) | [phase-2-components/](phase-2-components/) |
| **3 — Shared config** | `MASTER_*` files — principles, rules, commands, integration, tools | [phase-3-shared/](phase-3-shared/) |
| **4 — Master orchestrator** | The root `CLAUDE.md` entry point + notes | [phase-4-master/ORCHESTRATOR.md](phase-4-master/ORCHESTRATOR.md) |
| **5 — Validation** | Consistency, completeness, and usability checks | [phase-5-validation/VALIDATION.md](phase-5-validation/VALIDATION.md) |
| **6 — Implementation** | File placement, team adoption, maintenance plan | [phase-6-implementation/IMPLEMENTATION_GUIDE.md](phase-6-implementation/IMPLEMENTATION_GUIDE.md) |

## How to read this

- **Learning the process?** Go phase 1 → 6 in order.
- **Doing real work?** Start at the root [`CLAUDE.md`](../../CLAUDE.md), which routes you to the
  Phase 2 component file and Phase 3 shared rules you need.
- **Auditing / onboarding?** Phase 5 (validation) simulates common scenarios; Phase 6 covers adoption.

## Phase dependency

```
Phase 1 (analysis)
   └─► Phase 2 (component docs)  ──┐
   └─► Phase 3 (shared MASTER_*) ──┼─► Phase 4 (master orchestrator = root CLAUDE.md)
                                   │        └─► Phase 5 (validation)
                                   │                 └─► Phase 6 (implementation guide)
```
