project-context-loader

> **AI-consumed reference.** Optimized for Claude to read during execution. > Human-readable explanation: see [docs/architecture/HIERARCHICAL_PLANNING.md](../../../docs/architecture/HIERARCHICAL_PLANNING.md) > or [docs/getting-started/](../../../docs/getting-started/) depending on topic. # Project Context Loader Load project conventions and generate session context on demand. --- ## When to Use **Before:** `/run`, code generation, refactoring, test writing. **Skip:** Simple questions (no code), when `session-context.toon` already loaded. --- ## Loading Process ### 1. Check Cache If `.claude/session-context.toon` exists and is recent (< 1 hour), use it. ### 2. Generate (If Missing) Scan codebase for: file naming, import style, export pattern, error handling, testing framework, styling approach. Write to `.claude/session-context.toon`. ### 3. Load Project Config From `.claude/project-contexts/[project]/`: | File | When | |------|------| | `project-config.yaml` | Always | | `conventions.md` | Always | | `rules.md` | Always | | `repo-map.md` | First task | | `file-registry.yaml` | When modifying code | | `architecture.md` | Architecture decisions | ### 4. Smart Loading ```toon loading_strategy[4]{scenario,files_to_load}: Simple question,session-context.toon only Bug fix / small change,"session-context.toon + conventions.md + file-registry.yaml" New feature / refactor,All 7 files Architecture decision,"session-context.toon + architecture.md + repo-map.md" ```...