Documentation Index
Historical snapshot: 2026-07-11
Version at snapshot: v0.2.0
This legacy inventory is retained for reference. Use the canonical documentation hub for current navigation.
Total Files at snapshot: 693+ markdown files
Purpose: Historical inventory of repository documentation
Quick Navigation
Active Documentation
Core Documentation
Recent Additions (2025-12-11)
Agent Infrastructure (64KB+)
| Document |
Size |
Category |
agents/prompts/debugging/test-failure-debugging.md |
4.8KB |
Debugging |
agents/prompts/debugging/resolve-merge-conflicts.md |
6.3KB |
Debugging |
agents/prompts/debugging/performance-optimization.md |
7.0KB |
Debugging |
agents/prompts/debugging/security-remediation.md |
8.6KB |
Debugging |
agents/prompts/audit/run-full-audit.md |
- |
Audit |
agents/prompts/audit/check-regressions.md |
- |
Audit |
agents/prompts/deployment/pre-release-deployment.md |
- |
Deployment |
agents/prompts/documentation/generate-wiki.md |
- |
Documentation |
agents/prompts/organization/repository-cleanup.md |
- |
Organization |
agents/prompts/self-healing/feedback-loop.md |
- |
Self-Healing |
Archived Documentation
Historical Documents (archive/historical_docs_20251210/)
Status: Archived as of 2025-12-10
Reason: Information preserved in more recent documents or no longer relevant
Count: 50+ documents
| Category |
Count |
Examples |
| Status Updates |
15+ |
STATUS_UPDATE_AUDIT_REPORT.md, WORK_SUMMARY.md |
| Implementation Reports |
10+ |
IMPLEMENTATION_COMPLETE.md, MSP_IMPLEMENTATION_SUMMARY.md |
| Phase Completions |
8+ |
PHASE_6_INTEGRATION_COMPLETE.md, PHASE_C_SUMMARY.md |
| Gap Analyses |
5+ |
GAP_REMEDIATION_STATUS.md, MLOPS_GAP_ANALYSIS_AND_ROADMAP.md |
| Achievement Reports |
5+ |
ACHIEVEMENT_99_PERCENT.md, FINAL_STATUS_100_PERCENT.md |
Full Index: See workbench/INDEX.md
Removed Documents (archive/removed/)
Status: Removed from active use
Count: 10+ documents
Examples:
- Codex_Questions.md
- STATUS_UPDATE (various dates)
- CODEBASE_AUDIT (historical versions)
Technical Documentation
Architecture
API Documentation
Configuration
Guides and Tutorials
User Guides
Agent Guides
| Guide |
Purpose |
Updated |
| .codex/archive/deprecated/AGENTS.md |
Comprehensive agent guide |
2025-12-10 |
agents/TOKENIZED_WORKFLOWS.md |
Workflow tokens |
2026-02-10 |
agents/prompts/README.md |
Prompts library |
2025-12-11 |
Integration Guides
Status Reports
Active Reports
Audit Reports
| Report |
Focus |
Location |
| Audit Artifacts |
Capability tracking |
audit_artifacts/ |
| Reports |
Generated reports |
reports/ |
| Stub Analysis |
Code stubs |
reports/stub_analysis.md |
Architecture and Design
Design Documents
Implementation Plans
Documentation by Topic
MLOps and Training
LEVEL_4_MLOPS_ASSESSMENT.md - MLOps maturity assessment
training/ - Training documentation
audit_artifacts/ - Audit results
MATURITY_REMAINING_WORK.md - Maturity improvements
Testing and Quality
tests/ - Test documentation
reports/stub_analysis.md - Stub analysis
.codex/ - Quality checks
COMPREHENSIVE_GAP_ANALYSIS.md - Gap analysis
Security and Compliance
SECURITY.md - Security policy
security_allowlist.json - Approved exceptions
agents/prompts/debugging/security-remediation.md - Security guide
.bandit.yaml - Bandit configuration
Deployment and Operations
deploy/ - Deployment manifests
Dockerfile* - Container images
docker-compose.yml - Local orchestration
.github/workflows/ - CI/CD (gated)
AI Agent Integration
agents/ - Agent infrastructure
agents/prompts/ - Prompt library
.codex/archive/deprecated/AGENTS.md - Agent operations
agents/TOKENIZED_WORKFLOWS.md - Workflow tokens
Documentation Statistics
By Category
| Category |
Count |
Percentage |
| Active Documentation |
~100 |
14% |
| Archived Documentation |
~50 |
7% |
| Agent Prompts |
~10 |
1% |
| Test Documentation |
~500 |
72% |
| Other |
~33 |
5% |
By Status
| Status |
Count |
Notes |
| Active |
~600 |
Current and maintained |
| Archived |
~50 |
Preserved for reference |
| Removed |
~10 |
Obsolete, in archive/removed/ |
| 🆕 Recent (< 1 phase) |
~10 |
Added in recent PRs |
By Size
| Size Range |
Count |
Examples |
| < 1KB |
~300 |
Small test docs, stubs |
| 1-10KB |
~300 |
Standard documentation |
| 10-50KB |
~80 |
Comprehensive guides |
| > 50KB |
~13 |
Major reference documents |
Finding Documentation
By Task
I want to...
By Audience
I am a...
Maintenance Guidelines
For Contributors
Adding New Documentation:
1. Create file in appropriate directory
2. Add entry to this index
3. Follow naming conventions (lowercase-with-hyphens or UPPERCASE_WITH_UNDERSCORES)
4. Include metadata (date, author, purpose)
5. Link from related documents
Updating Documentation:
1. Update the document
2. Update "Last Updated" metadata
3. Update this index if location/status changes
4. Notify relevant stakeholders
Archiving Documentation:
1. Move to appropriate archive/ subdirectory
2. Update this index with archived status
3. Add redirect in original location if applicable
4. Update dependent documents
For AI Agents
Finding Documentation:
from pathlib import Path
# List all markdown files
docs = list(Path('.').rglob('*.md'))
# Filter by category
active_docs = [d for d in docs if 'archive' not in str(d)]
archived_docs = [d for d in docs if 'archive' in str(d)]
# Search by topic
def find_docs(topic):
return [d for d in docs if topic.lower() in d.name.lower()]
Using Index Programmatically:
- Parse this markdown file
- Extract links and metadata
- Build documentation graph
- Identify gaps or inconsistencies
External Links
- Repository: https://github.com/Aries-Serpent/codex
- Issues: https://github.com/Aries-Serpent/codex/issues
- Pull Requests: https://github.com/Aries-Serpent/codex/pulls
- Wiki: (Generate via agents/prompts/documentation/generate-wiki.md)
- Workflow Navigator:
agents/workflow_navigator.py
- Audit Runner:
scripts/space_traversal/audit_runner.py
- Documentation Generator:
agents/prompts/documentation/
Changelog
| Date |
Change |
Impact |
| 2025-12-11 |
Created comprehensive index |
Initial version |
| 2025-12-11 |
Added architecture blueprint |
32KB new doc |
| 2025-12-11 |
Added debugging guides |
26KB new docs |
| 2025-12-11 |
Added contributor onboarding |
12KB new doc |
| 2025-12-10 |
Archived historical documents |
50+ files moved |
Index Version: 1.0.0
Maintainer: Repository owners
Last Full Audit: 2025-12-11
Next Review: 2026-01-11 (quarterly)