Documentation Consolidation MoE Orchestration Plan

Documentation Consolidation MoE Orchestration Plan

Created: 2025-12-22 Objective: Reduce 544 docs to ~100 essential, high-quality documents Method: Mixture of Experts with 2-3 iteration cycles

---

MoE Architecture

Writer Pool (Phase 1: Consolidation)

Writer ID	Scope	Target Reduction
W1-Customer	docs/getting-started/, docs/training/	33 → 8
W2-Guides	docs/guides/, docs/reference/	38 → 15
W3-Research	internal/research/	198 → 20
W4-Project	internal/project/	131 → 25
W5-Architecture	internal/architecture/	103 → 40 (ADRs preserved)

Editor Pool (Phase 2: Review)

Editor ID	Focus	Criteria
E1-Clarity	Language clarity, conciseness	No jargon, active voice, <120 char lines
E2-Agentic	Frontmatter compliance, token budgets	All required fields, within limits
E3-Consistency	Cross-references, terminology	Consistent naming, valid links

Orchestrator (Coordination)

• Assigns work to writers/editors
• Tracks completion status
• Manages iteration cycles
• Reports final metrics

---

Iteration Cycles

Cycle 1: Initial Consolidation

1. Writers merge/eliminate redundant docs
2. Writers add agentic frontmatter
3. Editors review for compliance
4. Orchestrator collects feedback

Cycle 2: Refinement

1. Writers address editor feedback
2. Trim content further (target: -30% tokens)
3. Editors verify improvements
4. Orchestrator validates progress

Cycle 3: Final Polish

1. Final content tightening
2. Cross-reference validation
3. Full frontmatter audit
4. Generate doc-index.json

---

Deletion Queue (Pre-approved)

internal/research/research/           # 29 files - nested duplicate
internal/research/completion-reports/ # 13 files - historical
internal/research/audits/             # 17 files - completed
*.pdf, *.png, *.zip in research       # ~30 files - binaries

Consolidation Targets

docs/getting-started/ (11 → 4)

KEEP:

• USER-quick-start.md (primary)
• WHAT-IS-CODITECT-CORE.md (intro)
• CODITECT-WELCOME-ABOARD.md (onboarding)
• CLAUDE.md (directory context)

MERGE INTO ABOVE:

• 00-README.md → merge into WHAT-IS-CODITECT-CORE.md
• 02-CODITECT-FOR-CLAUDE-AGENTS.md → merge into WHAT-IS-CODITECT-CORE.md
• 03-CODITECT-ARCHITECTURE-VISUAL.md → merge into WHAT-IS-CODITECT-CORE.md
• 04-CODITECT-VISION-AND-ROADMAP.md → merge into WHAT-IS-CODITECT-CORE.md
• EXPANDED-ONBOARDING-DESIGN.md → merge into CODITECT-WELCOME-ABOARD.md
• ONBOARDING-PRACTICE-EXERCISES.md → merge into CODITECT-WELCOME-ABOARD.md
• ONBOARDING-VISUAL-GUIDE.md → merge into CODITECT-WELCOME-ABOARD.md

docs/training/ (22 → 8)

KEEP:

• USER-TRAINING-PATHWAYS.md (primary)
• CODITECT-OPERATOR-TRAINING-SYSTEM.md
• ADVANCED-CERTIFICATION-LEVELS.md
• CODITECT-GLOSSARY.md
• CLAUDE.md

MERGE:

• All 1-2-3-* guides → into USER-TRAINING-PATHWAYS.md
• All PERSONA-* → into USER-TRAINING-PATHWAYS.md
• FAQ, troubleshooting → consolidate

internal/research/ (198 → 20)

KEEP (consolidate similar topics):

• Key Anthropic references (5 files max)
• Active research topics (10 files max)
• Business/market research (5 files max)

DELETE:

• Completed audits
• Completion reports
• PDF fragments and images
• Duplicate nested folders

---

Success Metrics

Metric	Before	Target
Total docs	544	~100
Customer docs	105	~40
Contributor docs	439	~60
Avg tokens/doc	Unknown	<2000
Frontmatter compliance	0%	100%

---

Execution Order

1. DELETE - Remove pre-approved deletions first
2. CONSOLIDATE - Merge related docs
3. FRONTMATTER - Add agentic fields
4. EDIT - Trim and clarify
5. VALIDATE - Check all standards