bathos-debt

name	bathos-debt
description	.agent-team/ 산출물과 _state/ 리스크 로그 전반의 "CONCERNS:" 앵커를 한 번에 수집해 부채 ledger로 보여준다. 게이트 판정 CONCERNS(조건부 통과)의 후속 해소 여부를 놓치지 않기 위함. "부채 확인", "/bathos-debt", "CONCERNS 목록", "남은 리스크 뭐 있어", "부채 ledger" 요청 시 사용.

bathos-debt — CONCERNS 부채 ledger (CF-A6 · US15 · Should)

근거: _recon/ponytail-analysis.md #8(companion 스킬 패밀리, /ponytail-debt), 04-architecture/hook-and-gate-design-kr.md §6, story-a6-debt-ledger-kr.md. 재정의(카피 금지 준수): ponytail-debt는 소스코드의 ponytail: 주석을 grep한다. BATHOS 산출물은 마크다운 문서이므로, 앵커를 CONCERNS: 리터럴(게이트 판정 §2.1의 CONCERNS 표기와 동일 어휘)로 재정의한다. 읽기 전용 — 아무것도 변경하지 않는다.

목적

게이트 판정 CONCERNS(조건부 통과, 비차단 리스크)는 문서 곳곳(04-architecture/, _state/risk-log.md, manifest.json의 risks[] 등)에 흩어져 남는다. 시간이 지나면 "나중에 해소하겠다"던 항목이 조용히 잊힌다(ponytail의 "later means never" 문제와 동형). 이 스킬은 흩어진 CONCERNS: 앵커를 한 번에 조회 가능한 ledger로 모은다.

스캔 절차 (에이전트가 직접 수행 — 별도 스크립트 불요)

1. 대상 범위: .agent-team/**/*.md(전 하위 디렉터리) + .agent-team/_state/risk-log.md (있다면) + bathos state show(또는 bathos --state-dir <dir> state show)로 조회한 manifest.json의 risks[] 배열. node_modules·.git·core/target은 제외.
2. 앵커 탐지: 각 파일에서 CONCERNS: 리터럴이 포함된 행을 찾는다.

   grep -rn 'CONCERNS:' .agent-team --include='*.md'
   

   표기가 파일마다 미세하게 다를 수 있다(볼드 **CONCERNS:**, 인용 블록 안 등) — 관대하게 "행 내 CONCERNS: 리터럴 포함"만 조건으로 삼는다. 오탐이 의심돼도 note로 강등하지 말고 그대로 노출한다(사용자가 최종 판단).
3. 웨이브 추론: 파일 경로의 최상위 디렉터리(00-plan~12-report, _state)로 웨이브를 역추론한다. 프론트매터에 wave: 필드가 있으면 그것을 우선한다. _state/risk-log.md·manifest.json risks[] 항목은 owner_wave 필드를 사용한다.
4. 심각도 폐쇄 어휘 판정 — 아래 3값 외 임의 태그 금지:

   표기	의미	판정 근거
   [x]	blocker	문맥에 "차단"/"blocker"/"FAIL" 동반
   [!]	concerns	기본값(대부분의 게이트 CONCERNS 항목)
   [·]	note	문맥에 "참고"/"note"/"비차단" 명시 동반

5. 요약 추출: CONCERNS: 뒤 첫 문장을 80자로 절단한다(그 이상은 …).
6. 정렬: 웨이브 순(W0→W6, _state는 맨 뒤) → 그 안에서 심각도(blocker→concerns→note) 순.
7. ID 부여: 이번 실행 내에서만 안정적인 순번 D-01, D-02, … (정렬 후 부여 — 재실행해도 같은 스캔 결과면 같은 ID가 나오도록 정렬을 먼저 확정한 뒤 채번한다).

출력 형식 (인수: --wave <W0..W6> 필터 선택, --format table|md|json, 기본 table)

table (기본, 터미널/채팅 출력 — surface-formats-kr.md §a-1 정본 형식)

BATHOS DEBT LEDGER  ·  scanned 37 files  ·  2026-07-08 14:20
────────────────────────────────────────────────────────────
  ID    WAVE   SEV    SOURCE                         SUMMARY
────────────────────────────────────────────────────────────
  D-01  W3     [!]    _state/risk-log.md:42            fingerprint diff 정규화 경로 (추정)
  D-02  W4     [·]    04-architecture/schema-ext:72    콜드스타트 데이터 부족
────────────────────────────────────────────────────────────
  총 2건 · CONCERNS 1 · note 1 · 미해결 2 / 해결 0
  다음: 각 SOURCE 경로로 이동해 해소 후 라인에서 'CONCERNS:' 제거

md (문서에 그대로 붙여넣기)

동일 내용을 마크다운 표(| ID | WAVE | SEV | SOURCE | SUMMARY |)로 출력하고, 표 아래에 위와 동일한 푸터 문단을 둔다.

json (도구 연계 — surface-formats-kr.md §a-3 정본 스키마)

{
  "scanned_at": "2026-07-08T14:20:00Z",
  "scanned_files": 37,
  "items": [
    { "id": "D-01", "wave": "W3", "severity": "concerns",
      "source": "_state/risk-log.md", "line": 42,
      "summary": "fingerprint diff 정규화 경로 (추정)", "status": "open" }
  ],
  "summary": { "total": 2, "concerns": 1, "note": 1, "open": 2, "resolved": 0 }
}

status는 open(기본) 또는 항목 텍스트에 "해소됨"/"resolved" 등이 동반되면 resolved. summary에 blocker 카운트가 1건 이상이면 필드를 추가한다(0건이면 생략 가능 — 정본 예시가 concerns/note 사례만 다루므로 blocker 발생 시 임의 확장 아님을 명시).

상태별 출력 (막다른 골목 금지 — 항상 "다음 행동" 포함)

상태	출력
로딩(파일 많을 때)	scanning .agent-team/ … (k/N) 진행 로그
빈(0건)	✓ 미해결 CONCERNS 없음 — 부채 0건 (scanned N files) — 성공 톤(문제 없음을 긍정적으로)
에러(.agent-team/ 미탐지)	✗ .agent-team/ 미탐지. 프로젝트 루트에서 실행하세요. (탐색: <cwd>)
부분(일부 파일 파싱/읽기 실패)	정상 항목은 그대로 출력 + 푸터에 주의: k개 파일 건너뜀(파싱 실패) 추가(개별 실패로 전체를 죽이지 않음)

디자인 규약 (project-context-kr.md §9 그대로 적용)

• 무컬러이모지 — 흑백 기호만: ✓ ✗ ! · [ ]. ✅⚠️⛔ 등 컬러 이모지 금지.
• 로그 접두: [bathos debt] <기호> <메시지>.
• 미측정/미확인 값은 —로 표기(날조 금지).

Boundaries (스코프 밖 — D1·D2 규약 최초 적용 사례)

• 쓰기 없음: 이 스킬은 순수 조회다. .agent-team/ 문서를 수정·"해소됨" 자동 표기하지 않는다(사용자가 직접 해소 후 표기).
• CONCERNS 앵커 재정의 강제 없음: 기존 문서의 CONCERNS: 표기 스타일을 통일 시도하지 않는다(그대로 수집만).
• manifest.json risks[] 스키마 변경 없음: 기존 bathos state show 읽기 전용 조회만 사용, 신규 CLI 서브커맨드를 만들지 않는다.
• HTML/대시보드 렌더링 없음: table/md/json 3형태까지만(Martin W6 HTML 리포트는 범위 밖 — 이 스킬의 json 출력을 소스로 삼을 수는 있음).
• 범위 밖 이관 추적 없음: _state/risk-log.md의 "후속(범위 밖)" 섹션 항목(예: US12-AC2 실반영, npm 퍼블리시)은 이 ledger가 아니라 risk-log 자체가 SSOT다 — 이 스킬은 그 섹션도 CONCERNS: 리터럴이 있으면 그대로 수집하되 별도 가공은 하지 않는다.

테스트 (체크리스트형 — 스킬이므로 결정성 유닛테스트 대신 시나리오 검증)

가장 싼 검증은 본 프로젝트의 실제 .agent-team/에 대해 실행해 기존 _state/risk-log.md(§A~§C)의 CONCERNS 항목들이 정확히 잡히는지 확인하는 것이다. 추가로 임시 픽스처로 아래를 확인한다:

1. CONCERNS: 앵커 3건(웨이브·심각도 상이) 포함 임시 .agent-team/을 만들어 스캔 → 3건이 웨이브→심각도 순으로 정렬돼 출력되는지.
2. --format json 출력이 위 스키마와 정확히 일치하는지(필드 누락 없음).
3. CONCERNS: 앵커가 0건인 픽스처 → 빈(성공 톤) 상태 문구가 정확히 출력되는지.
4. .agent-team/ 자체가 없는 디렉터리에서 실행 → 에러 상태 문구(탐색: <cwd> 포함)가 출력되는지.
5. 읽기 권한이 없는 파일 1개를 섞은 픽스처 → 나머지 항목은 정상 출력 + 주의: 1개 파일 건너뜀 푸터가 붙는지(부분 성공 우선 원칙).