decision-loglisted
Install: claude install-skill kimsanguine/hplan
# Decision Log — Self-Calibrating Build Gate
Running for: **$ARGUMENTS**
## Core Goal
- 모든 gate 결정을 `harness/decisions.jsonl`에 append-only로 기록 → **3-6개월 뒤 audit으로 hit_rate 측정**.
- false_hold (hold 했는데 외부에서 성공함) + missed_build (build 했는데 죽음)을 자동 추출 → rubric 보정 데이터.
- "내 게이트가 정확한가?"라는 질문에 답할 수 있는 유일한 PM skill.
## Trigger Gate
### Use This Skill When
- 매 build/interview/pivot/hold/CONDITIONAL_GO 결정 시 즉시 호출 (의무)
- 3-6개월 뒤 outcome이 확정됐을 때 backfill
- 분기별 self-review — "지난 분기 결정 중 정확했던 비율은?"
### Route to Other Skills When
- audit 결과 false_hold 다수 → `evidence-rubric`의 threshold 검토
- missed_build 다수 → Evidence Gate 통과 기준 강화
- decision = `hold` + 영구 사유 → `exclusions` add 같이 호출
- decision = `build` → `handoff` 로 라우팅
### Boundary Checks
- ❌ 영구 삭제 불가 (append-only). 잘못된 entry는 새 entry로 supersede.
- ❌ outcome backfill 없으면 audit이 의미 없음 — 잊지 말 것.
- ❌ `--from-hitl`은 이미 기록된 HITL id만 허용. 없는 id를 주면 거부된다 (끊어진 승격 링크 방지).
- ⚠️ `--root`는 `harness/` 자체가 아니라 그 **부모 디렉터리**를 가리킨다.
## Inputs
```bash
# Log a decision
python3 hplan/scripts/decision_log.py log \
--project alpha-app --gate build --decision build --score 78 \
--reason "5/5 강한 신호" --reason "COGS GREEN"
# Promote an earlier HITL decision into a gate decision
python3 hplan/scripts/decision_log.py log \
--project alpha-app --gate build --decision build --score 78 \
--from-hitl hitl-2026-07-28-ab12c
# Backfill outcome (3-6 months later)
python3 hplan/scripts/decision_log.py update --id dec-XXX --outcome shipped
# Audit — sing