docs(c1): purge all 29 legacy Kanban references from SKILL.md and documentation (100% PASS)

This commit is contained in:
2026-08-06 08:03:15 +09:00
parent 924e77e8b8
commit 2d5e20a6aa
8 changed files with 980 additions and 93 deletions
+13 -9
View File
@@ -1,9 +1,9 @@
# 🛠️ Multi-Agent Mux 종합 개선 및 미해결 과제 백로그 (`IMPROVEMENTS.md`)
- **최종 갱신일**: 2026-08-05 (B-1 해결 및 완료 항목 섹션 분리 반영)
- **최종 갱신일**: 2026-08-06 (C-1 Kanban 잔재 문서 전면 제거 완료 반영)
- **통합 관리 대상**: 기존 `CODEBASE_REVIEW_REPORT.md` + `OPTIMIZATION.md`
- **총 추적 미해결 과제**: **18** (아키텍처 2건, 엣지케이스 8건, 오케스트레이션 3건, 레거시 잔재 5건)
- **완료된 과제**: **3** (A-1, A-5, B-1)
- **총 추적 미해결 과제**: **17** (아키텍처 2건, 엣지케이스 8건, 오케스트레이션 3건, 레거시 잔재 4건)
- **완료된 과제**: **4** (A-1, A-5, B-1, C-1)
---
@@ -76,10 +76,7 @@
---
## 4. ⚪ 레거시 잔재 및 죽은 코드 (Legacy Remnants — 5건)
### **C-1: Kanban 문서 29회 언급 vs 실제 구현 0건**
- SKILL.md 파일들에 Kanban 지원 및 상태 파일 서술이 29회 언급되어 있으나 스크립트 구현은 0건입니다.
## 4. ⚪ 레거시 잔재 및 죽은 코드 (Legacy Remnants — 4건)
### **C-2: 미사용 `.cache/` 상태 디렉터리 생성**
- `reconcile.sh``.cache/multi-agent-mux-monitor` 디렉터리를 `mkdir`만 하고 아무것도 읽거나 쓰지 않습니다.
@@ -95,7 +92,7 @@
---
## 5. 🎉 완료된 과제 (Completed Tasks — 3건)
## 5. 🎉 완료된 과제 (Completed Tasks — 4건)
### **A-1: 워크스페이스 세션 격리 & drift-B 오등록 방지** — ✅ 완료
- `derive_workspace_slug` 헬퍼 함수를 추가하여 워크스페이스 경로 기반 단일 소켓 슬러그(`mam-<parent>-<work>`) 도출 체계를 구축했습니다.
@@ -108,8 +105,15 @@
- `lib.sh` tier-3 신원 캐시 조회 시 미정의 변수(`db_path`, `yaml_path`) 및 `yaml` import 누락으로 무조건 `NameError` 예외가 발생하던 결함을 해결했습니다.
- DB를 1차 권위 경로로, `$YAML_PATH`를 폴백으로 정제하고 전용 회귀 테스트 `tests/test_b1_tier3_identity.py` (8/8 PASS)를 작성하여 입증했습니다.
### **C-1: Kanban 문서 29회 언급 vs 실제 구현 0건** — ✅ 완료
- SKILL.md 3종(monitor 22 / status 5 / create 2)과 README 2종의 Kanban 서술을 전면 제거했습니다.
- `multi-agent-mux-monitor` 의 실행 메커니즘 서술을 실제 구현인 `reconcile.sh --subscribe` (MQTT push + 브로커 다운 시 폴링 폴백) 기준으로 재작성했습니다.
- 존재하지 않는 스킬 참조 2건(`kanban-worker`, `kanban-orchestrator`)을 실존 스킬로 교체했습니다.
- `hermes kanban create` CLI 플래그 잔재 10종(`--goal-max-turns`, `--assignee`, `--comment-card` 등)을 파생형 검증 게이트(G-C)로 차단했습니다.
- 제품 표면(`.agents/skills/`, `README*.md`) Kanban 참조 **0건** 확인.
---
## 6. 결론 및 향후 보완 로드맵
`IMPROVEMENTS.md` 문서에 따라 향후 코드베이스 개편 시 남은 백로그 항목(아키텍처 2건, 엣지케이스 8건, 오케스트레이션 3건, 레거시 잔재 5건)을 일원화된 보완 로드맵으로 관리합니다.
`IMPROVEMENTS.md` 문서에 따라 향후 코드베이스 개편 시 남은 백로그 항목(아키텍처 2건, 엣지케이스 8건, 오케스트레이션 3건, 레거시 잔재 4건)을 일원화된 보완 로드맵으로 관리합니다.