forge-status

/forge-status

code-forge의 현재 런타임 상태를 회고/진단용 단일 뷰로 보여줍니다. 외부 도구 연동용 JSON surface도 제공 — forge status --json.

[즉시 실행] 아래 절차대로 상태를 출력하세요.

---

사용법

/forge-status              → 사람 읽는 리포트 (상세)
/forge-status --json       → JSON 출력 (forge-glow, CI 연동용)
/forge-status --week       → 최근 7일 quality 추이
/forge-status --reflect    → REFLECT flag 상세

---

Step 1: CLI 호출

플러그인이 제공하는 단일 surface를 호출:

${CLAUDE_PLUGIN_ROOT}/bin/forge status

--json 인자 있으면:

${CLAUDE_PLUGIN_ROOT}/bin/forge status --json

→ JSON 그대로 출력하고 종료. 사람이 호출했어도 --json이면 파이프라인 용도로 가정.

---

Step 2: 상세 섹션 추가

--json이 아닌 경우, bin/forge status 출력 다음에 아래 섹션 보강:

2-1. 최근 quality 이벤트 (있으면)

tail -10 .claude/state/quality.jsonl 2>/dev/null

각 이벤트를 사람 읽는 포맷으로 변환:

[2026-04-14 10:00] eslint   PASS
[2026-04-14 10:00] tsc      FAIL  2 errors
[2026-04-14 10:00] test-trigger  WARN  TC 없음: src/hooks/useFoo.ts

2-2. REFLECT flag 상세 (활성 시)

[ -f .claude/state/reflect.flag ] && cat .claude/state/reflect.flag

→ timestamp, failed_blocks, failed_files 파싱하여 테이블화.

2-3. Notepad 미리보기 (있으면)

if [ -f .claude/state/notepad.md ]; then
  echo "=== Notepad 미리보기 ==="
  head -20 .claude/state/notepad.md
fi

2-4. 최근 decisions (있으면)

if [ -f .claude/state/decisions.md ]; then
  echo "=== 최근 결정 3건 ==="
  grep -A 3 "^## " .claude/state/decisions.md | tail -15
fi

2-5. 사용량 (usage.jsonl)

if [ -f "$HOME/.code-forge/usage.jsonl" ]; then
  echo "=== 이번 주 사용 Top 3 ==="
  # 7일 이내 에이전트/스킬 집계
  CUTOFF=$(date -u -v-7d +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -d '7 days ago' +"%Y-%m-%dT%H:%M:%SZ")
  awk -v c="$CUTOFF" '$0 !~ /"ts":"'"$CUTOFF"'"/ && match($0,/"name":"([^"]+)"/,n) { print n[1] }' "$HOME/.code-forge/usage.jsonl" | sort | uniq -c | sort -rn | head -3
fi

---

Step 3: 옵션 처리

--week

quality.jsonl에서 최근 7일 이벤트 일별 집계:

2026-04-14  █████████ 9 (pass:7 fail:2)
2026-04-13  ████ 4 (pass:4)
2026-04-12  ██████ 6 (pass:5 warn:1)

--reflect

REFLECT flag 없으면 "깨끗함" + 최근 해제 시각. 있으면 전체 본문 + 권장 조치:

ADAPT 권장 절차:
  1. 실패 파일 Read → 증상 파악
  2. 근인 분석
  3. 수정 → Stop 훅 재실행
  4. 통과 시 flag 자동 삭제

우회: rm .claude/state/reflect.flag
Ack: 본문에 'ack: <이유>' 추가

---

Step 4: 외부 도구 연동 힌트

사람 리포트 맨 아래에 안내:

─────────────────────────────────────
외부 도구 (forge-glow, CI, 슬랙봇):
  $CLAUDE_PLUGIN_ROOT/bin/forge status --json
계약: docs/contracts/state-schema.md v1

---

관련

• docs/contracts/state-schema.md — .claude/state/ 파일 포맷 계약
• /stats — Bellows usage.jsonl 전용 집계 (다른 관점)
• /cleanup — state 파일 정리
• forge-glow — 실시간 statusLine HUD (회고는 /forge-status, 실시간은 glow)

---

금지 사항

• .claude/state/ 파일을 직접 cat으로 통째로 쏟아내기 금지 — 항상 파싱/요약
• 외부 도구가 이 스킬을 호출하는 것 금지 — 반드시 bin/forge status --json 직접 사용
• 파일 경로 참조를 공식 계약인 것처럼 안내 금지 — 항상 bin/forge surface를 권장