Status: Proposed
Date: 2025-12-22
Impact: High - requires extensive reference updates
Current State (32 ADRs)
Core Sequence (ADR-NNN)
| Current | Title | Proposed |
|---|
| ADR-001 | Async Task Executor Refactoring | ADR-001 (no change) |
| ADR-002 | Hybrid Deployment Architecture | ADR-002 (no change) |
| ADR-002-ADDENDUM | License Validation Strategy | ADR-003 |
| ADR-003 | User Registration Authentication | ADR-004 |
| ADR-006 | Work Item Hierarchy | ADR-005 |
| ADR-010 | Autonomous Orchestration System | ADR-006 |
| ADR-011 | Uncertainty Quantification Framework | ADR-007 |
| ADR-012 | MoE Analysis Framework | ADR-008 |
| ADR-013 | MoE Judges Framework | ADR-009 |
| ADR-014 | Component Capability Schema | ADR-010 |
| ADR-015 | Self-Awareness Framework | ADR-011 |
| ADR-016 | LLM Council Pattern | ADR-012 |
| ADR-017 | Agent Skills Framework Adoption | ADR-013 |
| ADR-018 | Agentic Documentation Standard | ADR-014 |
| ADR-100 | CODITECT Master Index System | ADR-015 |
| Current | Title | Proposed |
|---|
| ADR-CX-CONTEXT-EXTRACTION | Context Extraction | ADR-020 |
Context Query Series (ADR-CXQ-*)
| Current | Title | Proposed |
|---|
| ADR-CXQ-CONTEXT-QUERY | Context Query | ADR-021 |
| ADR-CXQ-007 | Codebase Indexing Expansion | ADR-022 |
| ADR-CXQ-008 | SQLite Scalability Analysis | ADR-023 |
| ADR-CXQ-009 | Multi-Tenant Platform Architecture | ADR-024 |
LMS Series (ADR-LMS-*)
| Current | Title | Proposed |
|---|
| ADR-LMS-PHASE-1 | LMS Phase 1 | ADR-030 |
| ADR-LMS-PHASE-2 | LMS Phase 2 | ADR-031 |
| ADR-LMS-004 | User Authentication | ADR-032 |
| ADR-LMS-005 | Certificates | ADR-033 |
| ADR-LMS-006 | SCORM/xAPI | ADR-034 |
| ADR-LMS-007 | Assessments | ADR-035 |
| ADR-LMS-008 | Analytics | ADR-036 |
| ADR-LMS-009 | Instructor Dashboard | ADR-037 |
| ADR-LMS-010 | External Integration | ADR-038 |
Standalone ADRs
| Current | Title | Proposed |
|---|
| ADR-TOKEN-ACCOUNTING | Token Accounting | ADR-040 |
| ADR-WORKFLOW-EXECUTOR | Workflow Executor | ADR-041 |
Proposed Number Ranges
| Range | Category |
|---|
| 001-019 | Core Architecture |
| 020-029 | Context System (CX/CXQ) |
| 030-039 | Learning Management System |
| 040-049 | Runtime/Execution |
| 050-059 | Security |
| 060-069 | Integration |
| 070-079 | Reserved |
| 080-089 | Reserved |
| 090-099 | Experimental |
Migration Steps
- Create mapping file - Document old → new number mapping
- Update all ADR content - Fix internal references
- Rename files - Use git mv for history preservation
- Update external references - Search all .md files for ADR-* references
- Update frontmatter - Add adr_number field per ADR-018
- Re-index - Run component-frontmatter-indexer.py
Impact Analysis
Files requiring updates:
- 32 ADR files (rename + internal refs)
- ~50+ documentation files (external refs)
- Config files with ADR references
- CLAUDE.md files mentioning ADRs
Estimated effort: 2-4 hours with automation
Decision Required
Author: CODITECT Core Team