5dfb8f3e12
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>
1.6 KiB
1.6 KiB
역할별 처절한 감사
| 역할 | 결함 | v16 처방 |
|---|---|---|
| 운영사 | Scheduler가 중복 실행되면 운영자는 DB 수작업으로 퇴행한다. | Lease fencing, heartbeat, J41, Runbook과 Owner를 표면화한다. |
| 아키텍트 | 14개 컴포넌트가 존재해도 공급자 호환성 증거가 없으면 Adapter는 선언이다. | Adapter v4 compatibility report와 승인 Evidence를 둔다. |
| PM/PL | 576개 WBS가 있어도 실제 코드/DB/Test 연결이 약하면 일정 장식이다. | v16 Delta는 구현 파일과 수용증거가 1:1인 작업만 추가한다. |
| UX/AX | 정상 화면 템플릿만 표준화하면 stale/conflict/hold를 숨긴다. | DataContextHeader, CommandBar, CRUD v2 상태 계약을 추가한다. |
| QA | 파일 존재 검사를 build PASS로 오해할 위험이 있다. | 정적 검증과 runtime 검증을 분리하고 미실행을 명시한다. |
| 투자 고객 | 내부 점수보다 데이터 시점·비용·반대증거·만료·승인이 중요하다. | Evidence/VersionSet/Projection/Watermark/Correlation을 공통 Header로 노출한다. |
| 개발자 | Generic Repository나 모든 prop 래핑은 과설계다. | 외부 경계와 의미 안정성이 있는 최소 계약만 추상화한다. |
| 데이터 아키텍트/DBA | 평가 누락·중복·revision 재평가가 수작업이면 재현성이 깨진다. | J42와 append-only reconciliation evidence를 추가한다. |
| 준법/리스크 | 자동화가 제안·평가를 넘어 모델 활성화로 새면 통제 실패다. | 모든 신규 Job은 EvaluationOnly이며 schedules 기본 disabled다. |