docs(04-05): complete intel injection into planner plan

Tasks completed: 2/2
- Add intel file read to Step 7
- Add intel section to planner prompt template

SUMMARY: .planning/phases/04-semantic-intelligence/04-05-SUMMARY.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

.planning/STATE.md

@@ -10,18 +10,18 @@ See: .planning/PROJECT.md (updated 2026-01-19)
 ## Current Position
 
 Phase: 4 of 4 (Semantic Intelligence & Scale)
-Plan: 4 of 4 complete
+Plan: 5 of 5 complete
 Status: Phase complete
-Last activity: 2026-01-20 — Completed 04-04-PLAN.md (CLI Query Interface - gap closure)
+Last activity: 2026-01-20 — Completed 04-05-PLAN.md (Intel Injection into Planner)
 
 Progress: [██████████] 100%
 
 ## Performance Metrics
 
 **Velocity:**
-- Total plans completed: 11
-- Average duration: 2.6 min
-- Total execution time: 29 min
+- Total plans completed: 12
+- Average duration: 2.5 min
+- Total execution time: 30 min
 
 **By Phase:**
 
@@ -30,7 +30,7 @@ Progress: [██████████] 100%
 | 1. Foundation & Learning | 2/2 | 7 min | 3.5 min |
 | 2. Context Injection | 2/2 | 4 min | 2.0 min |
 | 3. Brownfield & Integration | 3/3 | 6 min | 2.0 min |
-| 4. Semantic Intelligence | 4/4 | 12 min | 3.0 min |
+| 4. Semantic Intelligence | 5/5 | 13 min | 2.6 min |
 
 *Updated after each plan completion*
 
@@ -67,6 +67,8 @@ Progress: [██████████] 100%
 | Query mode read-only | 04-04 | Query actions don't persist to disk, safe operations |
 | Default limit 10 for dependents | 04-04 | Prevents huge output for files with many dependents |
 | Query routing before Write/Edit | 04-04 | Clean separation between query and indexing modes |
+| Intel read in Step 7 with others | 04-05 | Keep all context file reads in one place |
+| 2>/dev/null for missing intel | 04-05 | Graceful degradation when summary.md doesn't exist |
 
 ### Pending Todos
 
@@ -79,7 +81,7 @@ Progress: [██████████] 100%
 ## Session Continuity
 
 Last session: 2026-01-20
-Stopped at: Completed 04-04-PLAN.md (CLI Query Interface gap closure)
+Stopped at: Completed 04-05-PLAN.md (Intel Injection into Planner)
 Resume file: None
 
 ## Phase Progress
@@ -94,3 +96,4 @@ Resume file: None
 - 04-02: Query interface ✓
 - 04-03: Entity generation instructions ✓
 - 04-04: CLI query interface (gap closure) ✓
+- 04-05: Intel injection into planner ✓

.planning/phases/04-semantic-intelligence/04-05-SUMMARY.md

@@ -0,0 +1,101 @@
+---
+phase: 04-semantic-intelligence
+plan: 05
+subsystem: codebase-intelligence
+tags: [planner-integration, context-injection, dependency-awareness]
+
+# Dependency graph
+requires:
+  - phase: 04-02
+    provides: Query functions and summary.md generation
+provides:
+  - Intel injection into planner prompt via {intel_content} placeholder
+  - Planner receives dependency hotspots and module types at planning time
+affects: [planning, context-assembly, plan-quality]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns: [context-file-injection, graceful-degradation]
+
+key-files:
+  created: []
+  modified: [commands/gsd/plan-phase.md]
+
+key-decisions:
+  - "Read intel at Step 7 alongside other context files"
+  - "Use 2>/dev/null for graceful degradation when summary.md doesn't exist"
+  - "Add intel section after gap closure section in planning_context"
+
+patterns-established:
+  - "Context file injection: read into variable in Step 7, inject via placeholder in Step 8"
+  - "Optional context: empty string if file doesn't exist, planner handles gracefully"
+
+# Metrics
+duration: 1min
+completed: 2026-01-20
+---
+
+# Phase 04 Plan 05: Intel Injection into Planner Summary
+
+**Wired plan-phase.md to read and inject .planning/intel/summary.md into planner prompt, giving planners awareness of dependency hotspots and module composition**
+
+## Performance
+
+- **Duration:** 1 min
+- **Started:** 2026-01-20T16:23:37Z
+- **Completed:** 2026-01-20T16:24:14Z
+- **Tasks:** 2
+- **Files modified:** 1
+
+## Accomplishments
+- Planner now receives codebase intelligence (dependency hotspots, module types, relationship counts)
+- Phase 4 infrastructure is fully connected: index → graph → summary → planner
+- Graceful degradation: planners work fine when intel doesn't exist yet
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1 & 2: Add intel read and injection** - `61d1e91` (feat)
+
+## Files Created/Modified
+- `commands/gsd/plan-phase.md` - Added INTEL_CONTENT read in Step 7, {intel_content} placeholder in Step 8 planning_context
+
+## Decisions Made
+
+**Read location:** Added intel read in Step 7 alongside other context files (STATE, ROADMAP, RESEARCH, etc.) rather than a new step. Keeps all context file reads in one place.
+
+**Template location:** Added intel section after gap closure section and before `</planning_context>`. This puts codebase-level context after phase-specific context.
+
+**Empty string fallback:** Used `2>/dev/null` so INTEL_CONTENT is empty string when summary.md doesn't exist. Planner template handles this gracefully.
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+
+None
+
+## User Setup Required
+
+None - no external service configuration required.
+
+## Next Phase Readiness
+
+**Last mile wiring complete.** The codebase intelligence system is now fully operational:
+- `gsd-intel-index` hook captures file changes and builds graph database
+- Summary generation creates human-readable intel from graph queries
+- Planner receives intel automatically when planning phases
+
+When a project has been indexed via `/gsd:scan-codebase` or through hook triggers, the planner will see:
+- Dependency hotspots (files with most dependents - change carefully)
+- Module type breakdown (utils, APIs, components, etc.)
+- Total relationship count
+
+This closes the Phase 4 objective: Claude understands codebase structure and conventions before it starts working.
+
+---
+*Phase: 04-semantic-intelligence*
+*Completed: 2026-01-20*