From code-forge
Displays code-forge runtime status including REFLECT flag, quality events, notepad/decisions, usage stats, and doctor diagnostics. Supports --json for external tool integration.
How this skill is triggered — by the user, by Claude, or both
Slash command
/code-forge:forge-statusThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
code-forge의 현재 런타임 상태를 회고/진단용 단일 뷰로 보여줍니다.
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 상세
플러그인이 제공하는 단일 surface를 호출:
${CLAUDE_PLUGIN_ROOT}/bin/forge status
--json 인자 있으면:
${CLAUDE_PLUGIN_ROOT}/bin/forge status --json
→ JSON 그대로 출력하고 종료. 사람이 호출했어도 --json이면 파이프라인 용도로 가정.
--json이 아닌 경우, bin/forge status 출력 다음에 아래 섹션 보강:
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
[ -f .claude/state/reflect.flag ] && cat .claude/state/reflect.flag
→ timestamp, failed_blocks, failed_files 파싱하여 테이블화.
if [ -f .claude/state/notepad.md ]; then
echo "=== Notepad 미리보기 ==="
head -20 .claude/state/notepad.md
fi
if [ -f .claude/state/decisions.md ]; then
echo "=== 최근 결정 3건 ==="
grep -A 3 "^## " .claude/state/decisions.md | tail -15
fi
if [ -f "$HOME/.code-forge/usage.jsonl" ]; then
echo "=== 이번 주 사용 Top 3 ==="
# 7일 이내 에이전트/스킬 집계 — POSIX awk (gawk 3-인자 match 금지: macOS에서 무동작이었음)
# ISO ts는 문자열 비교가 곧 시간 비교
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" -F'"' '{
ts=""; name=""
for (i = 1; i < NF; i++) {
if ($i == "ts") ts = $(i+2)
if ($i == "name") name = $(i+2)
}
if (ts >= c && name != "") print name
}' "$HOME/.code-forge/usage.jsonl" | sort | uniq -c | sort -rn | head -3
fi
if ls .claude/state/whetstone/*.md >/dev/null 2>&1; then
echo "=== Whetstone 초안 (채택은 사람이 — status를 accepted/rejected로) ==="
for w in .claude/state/whetstone/*.md; do
S=$(grep '^status:' "$w" | head -1 | sed 's/^status: *//')
C=$(grep '^count:' "$w" | head -1 | sed 's/^count: *//')
P=$(sed -n '/^## 반복 패턴/{n;p;}' "$w" | cut -c1-70)
printf "%-9s %3s회 %s\n" "[$S]" "$C" "$P"
done
fi
${CLAUDE_PLUGIN_ROOT}/bin/forge doctor
4종 보고만 (자동 수리 없음): 주입 회로(route.json 최근성) / 품질 게이트 만년 빨간불(pass==0&&fail>0) / 버전 정합(프로젝트 local.md vs 설치본) / flow CLI 휴면.
--weekquality.jsonl에서 최근 7일 이벤트 일별 집계:
2026-04-14 █████████ 9 (pass:7 fail:2)
2026-04-13 ████ 4 (pass:4)
2026-04-12 ██████ 6 (pass:5 warn:1)
--reflectREFLECT flag 없으면 "깨끗함" + 최근 해제 시각. 있으면 전체 본문 + 권장 조치:
ADAPT 권장 절차:
1. 실패 파일 Read → 증상 파악
2. 근인 분석
3. 수정 → Stop 훅 재실행
4. 통과 시 flag 자동 삭제
우회: rm .claude/state/reflect.flag
Ack: 본문에 'ack: <이유>' 추가
사람 리포트 맨 아래에 안내:
─────────────────────────────────────
외부 도구 (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를 권장npx claudepluginhub ggombee/code-forgeShows current forge project status including plan objective, module DAG, iteration history, and saved learnings from project memory.
Shows a single-screen work status dashboard with task state, epic progress, knowledge flywheel health, and recent activity. Useful for getting oriented or deciding next actions.
Shows dashboards summarizing Claude Code projects with sessions, branches, contributions, and activity stats. Activates on 'project overview', 'show project X', or similar queries.