igny8/part2-dev/planning/PLANNING_DOCS_CONSOLIDATION_PLAN.md

Planning Docs Consolidation Plan

1. Inventory & Tags

File	Scope	Notes
planning/ARCHITECTURE_CONTEXT.md	Contextual overview of Part 2 goals, stakeholders, constraints.	High-level reference.
planning/CONTENT-WORKFLOW-DIAGRAM.md	Detailed content lifecycle diagrams + descriptions.	Visual/text workflow.
planning/sample-usage-limits-credit-system	Legacy notes on credit usage examples.	Likely merge into workflows appendix.
IGNY8-HOLISTIC-ARCHITECTURE-PLAN.md	Comprehensive architecture narrative (cross-domain).	Overlaps with strategy sections.
IGNY8-IMPLEMENTATION-PLAN.md	Detailed step-by-step implementation roadmap.	Overlaps with roadmap bundle.
Igny8-part-2-plan.md	Program-level planning doc with milestones.	Should anchor roadmap bundle.
PHASE-0-4-FOUNDATION-TO-LINKER-OPTIMIZER.md	Phase-specific execution report for early phases.	Belongs in phase reports bundle.
PHASE-5-7-9-SITES-RENDERER-INTEGRATION-UI.md	Later phase report (sites renderer, UI).	Phase reports bundle.
PHASE-8-UNIVERSAL-CONTENT-TYPES.md	Focused phase doc on UCT.	Phase reports bundle.
PHASE-IMPLEMENTATION-VERIFICATION-REPORT.md	Consolidated verification results.	Phase reports bundle.
PHASE-5-MIGRATION-VERIFICATION-REPORT.md	Specific verification log.	Phase reports bundle (appendix).
PHASE-5-MIGRATION-FINAL-VERIFICATION.md	Final pass notes.	Combine with verification.
README.md	Folder guidance.	Needs update after consolidation.

2. Target Bundles

Bundle	New File	Contents
Strategy & Architecture	planning/01-strategy.md	Merge ARCHITECTURE_CONTEXT.md + relevant sections from IGNY8-HOLISTIC-ARCHITECTURE-PLAN.md.
Workflows & Systems	planning/02-workflows.md	Combine CONTENT-WORKFLOW-DIAGRAM.md, sample credit usage appendix, excerpts describing planner/writer/site builder alignment (pull from holistic plan where needed).
Phase & Verification Reports	planning/03-phase-reports.md	Consolidate all PHASE* docs + implementation verification into chronological sections with TOC anchors.
Roadmap & Implementation	planning/04-roadmap.md	Merge Igny8-part-2-plan.md + IGNY8-IMPLEMENTATION-PLAN.md, highlight milestones/stage gates.

3. Merge & Cross-Link Plan

1. Create the four new bundle files with clear TOCs.
2. For each source doc, move content into appropriate section, preserving headings.
3. Add cross-links between bundles (e.g., roadmap references strategy section anchors).
4. Update README.md to describe new structure and point to bundle docs.

4. Cleanup Tasks

• Archive or delete superseded source files once content is moved (keep git history).
• Update any references in other docs (master-docs, repo README, etc.) to point to the new bundle filenames.
• Verify diagrams/images still referenced correctly (adjust paths if needed).

Next Steps

1. Approve bundle structure (or adjust naming).
2. Execute merges in order: strategy → workflows → phase reports → roadmap.
3. Run lint/format checks on updated markdown.