47 lines
3.1 KiB
Markdown
47 lines
3.1 KiB
Markdown
# 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.
|
|
|
|
|