# `.claude/` — Claude Code workspace

Repository-scoped AI configuration. Loaded automatically by Claude Code when invoked from the repo root.

| File / folder                 | Purpose                                                  | Materialized |
| ----------------------------- | -------------------------------------------------------- | ------------ |
| `settings.json`               | Permissions, model, hooks                                | Phase 1      |
| `settings.local.json.example` | Per-developer overrides (real file gitignored)           | Phase 1      |
| `hooks/`                      | PreToolUse / PostToolUse / Stop / UserPromptSubmit hooks | Phase 1      |
| `commands/`                   | Slash commands (`/create-feature`, `/review-code`, ...)  | Phase 7      |
| `agents/`                     | Sub-agent personas                                       | Phase 7      |
| `skills/`                     | Task playbooks (SKILL.md per skill)                      | Phase 7      |
| `blueprints/`                 | Feature blueprints                                       | Phase 7      |
| `context/`                    | Pre-compressed context summaries                         | Phase 7      |
| `prompts/`                    | Reusable prompt fragments                                | Phase 7      |
| `orchestrators/`              | Multi-agent pipelines                                    | Phase 7      |

The root [`CLAUDE.md`](../CLAUDE.md) is the entry point Claude Code reads first. It links here for everything else.
