 kjh2064
|
5dfb8f3e12
|
refactor: Reorganize docs folder structure for clarity and version management (PR 3c)
ci / backend (push) Failing after 1s
ci / static (push) Failing after 6s
ci / frontend (push) Failing after 5s
Reorganize documentation following AGENTS.md v16.0 governance (traceability, reproducibility):
Structure changes:
- CURRENT/ (new)
├─ 00~08.md (v16.0 standards, renamed for clarity)
└─ CATALOGS/ (9 CSV files: WBS, decision log, debt register, matrices, catalogs)
- LEGACY/ (new, read-only archives)
├─ v11/ (original baseline + hardening analysis)
├─ v12~v15/ (.gitkeep + README for future archiving)
- DECISIONS/ (new, ready for ADR usage)
- TEMPLATES/ (existing, unchanged)
Deletions (consolidated into CURRENT/):
- v16_0/ folder (files migrated)
- hardening/ folder (contents → LEGACY/v11/)
- Root-level v11 files (00~07.md, CSV)
Renames (for clarity):
- 00_EXECUTIVE_REFERENCE_IMPLEMENTATION.md → 00_EXECUTIVE.md
- 01_BRUTAL_ROLE_AUDIT.md → 01_ROLE_AUDIT.md
- 02_FRONTEND_ADAPTER_CRUD_STANDARD.md → 02_FE_ADAPTER.md
- 03_BACKEND_DATA_SCHEDULER_STANDARD.md → 03_BE_DATA.md
- 04_ALGORITHM_MODEL_GOVERNANCE.md → 04_ALGORITHM.md
- 05_PROCESS_VIBE_DEBT_CONTROL.md → 05_PROCESS_VIBE_DEBT.md
- 06_VALIDATION_TRUTH.md → 06_VALIDATION.md
- 07_PACKAGE_ATTACHMENT_POLICY.md → 07_PACKAGE_POLICY.md
Updates:
- docs/INDEX.md (complete rewrite with navigation)
- LEGACY/ folders with README + .gitkeep
Benefits:
✅ Clear version management (v16.0 is active, v11~v15 read-only)
✅ No version mixing in root
✅ CURRENT/ as single point of reference for active docs
✅ CATALOGS/ consolidates all data matrices
✅ LEGACY/ preserves history without clutter
✅ Traceability: decision log, tech debt, WBS all linked
✅ DECISIONS/ ready for ADR pattern (future use)
Sync with root:
- CLAUDE.md references: docs/CURRENT/, docs/INDEX.md ✅
- AGENTS.md references: docs/CURRENT/, traceability ✅
- README.md: Document guide links updated ✅
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
|
2026-08-02 05:49:29 +09:00 |
|