菜单
개발이 스펙대로 됐는지 구현 주장 항목을 코드 대조로 0~100 채점하고, 95점 미만은 되먹여 재작업하는 검증 루프를 돈다. carve-verify-loop 워크플로가 없거나(타 에이전트·일반 세션) 손으로 돌릴 때 사용.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | checklist-loop |
| description | 개발이 스펙대로 됐는지 구현 주장 항목을 코드 대조로 0~100 채점하고, 95점 미만은 되먹여 재작업하는 검증 루프를 돈다. carve-verify-loop 워크플로가 없거나(타 에이전트·일반 세션) 손으로 돌릴 때 사용. |
권위는 도구가 아니라 이 절차에 있다(fable-team-guide 4절).
carve-verify-loop워크플로는 이 절차를 코드로 자동 실행할 뿐이다. Fable/Opus/Sonnet 어떤 세션이든, 훅 없는 다른 에이전트든 아래를 그대로 수동 실행하면 동일하게 동작한다.
specs/checklist.json이 단일 진실원.{
"goal": "주문 취소 API",
"iteration": 2,
"threshold": 95,
"items": [
{
"id": "c1",
"claim": "POST /orders/{id}/cancel 구현",
"acceptance": "204 반환 + 상태 CANCELLED 전이 테스트 통과",
"owns": ["src/api/cancel/**"],
"attempts": 2,
"score": 88,
"pass": false,
"gaps": ["멱등성 미검증", "이미 취소된 주문 409 테스트 없음"],
"evidence": "src/api/cancel/route.ts:12; test 3/4 pass"
}
]
}
claim/acceptance/owns: 분해 단계에서 채운다. owns glob은 항목끼리 겹치면 안 된다(파일 오너 1개).score/pass/gaps/evidence/attempts: 채점 단계에서 채운다. pass = score >= threshold.S1. Spec/분해 목표를 리서치 → 3~7개 항목으로 분해(claim·acceptance·owns 비중복).
상호의존 파일(구현 + 그 테스트, 모듈 + 그 마이그레이션)은 반드시 같은 항목 owns에 함께 둔다 —
항목은 격리 worktree에서 채점돼 다른 항목 파일을 못 보므로, 구현·테스트를 쪼개면 테스트 항목이 영구 미달.
specs/checklist.json 작성(전 항목 score:null). → Stop 게이트가 이때부터 완료를 막는다.
S2. Build 미해결 항목(pass=false)마다 builder 1개. worktree 격리, 동시 3~5개 상한.
owns 밖 쓰기 금지. 재작업이면 아래 S4의 반성 프롬프트 + gaps를 입력으로 준다.
S3. Score 항목마다 evaluator(read-only)에 채점 위임 → 코드 대조 + 테스트 실행으로 0~100.
결과를 checklist.json에 반영(score·pass·gaps·evidence·attempts++).
S4. Loop score<임계 항목만 골라 gap을 builder에 되먹여 S2로. 미달 항목만 재작업(전수 아님).
반성 프롬프트 강제: "무엇이 실패했나? 어떤 구체적 변경이 임계를 넘기나? 같은 접근 반복 중인가?"
S5. 종료 전 항목 pass=true → S6. / 특정 항목 3회(MAX_ATTEMPTS) 재작업에도 미달 → [ESCALATION] 후
그 항목 failed 기록하고 루프 탈출(무한 재시도 금지, orchestration.md 5절).
S6. 최종 evaluator 통합 최종 판정(항목 간 계약 위반·회귀 점검). 통과분만 완료로 선언.
가드레일: 항목당 재작업 3회, 외곽 루프 8회(MAX_ITERATIONS)를 상한으로 둔다. 예산 85% 도달 시 일시정지 보고.
specs/checklist.json이 존재하고 score<threshold거나 미채점(score:null) 항목이 남으면
Stop 훅 checklist-gate.sh가 완료를 **차단(exit 2)**한다("미완 N개 — 루프 계속"). 워크플로 없이 손으로 돌려도 강제력이 걸린다.
파일이 없으면 무동작 — 루프를 쓰지 않는 작업은 방해받지 않는다.
/verify-loop 주문 취소 API 구현
또는 발화에 carve-verify-loop 실행 / ultracode. 인자로 항목을 직접 줄 수도 있다:
{ "goal": "주문 취소 API",
"threshold": 95,
"tasks": [
{ "id": "api", "claim": "취소 엔드포인트", "acceptance": "204+CANCELLED 전이 테스트 통과", "owns": ["src/api/cancel/**"] }
] }
.claude/workflows/carve-verify-loop.js.claude/hooks/checklist-gate.sh.claude/agents/evaluator.md(채점 모드 절)docs/md/orchestration.md, docs/md/fable-team-guide.md되돌릴 수 없는 결정(ADR)과 그 근거를 시간순으로 specs/DECISIONS.md에 append-only 기록한다. 아키텍처·의존성·API 계약 변경 시 사용. 주의 — 이건 결정 로그이지 릴리스 버전 이력이 아니다(VERSION·CHANGELOG.md 갱신은 version-changelog 스킬).
프로젝트를 전수 분석(스택+코드베이스)해 ① CLAUDE.md·AGENTS.md 설정 정합성을 검증·제안하고 ② 스택에 필요한데 없는 요소(하네스 규칙·외부 개발도구·설정 스캐폴딩)를 보강 제안하며 ③ 불필요한 구성을 prune한다. FIX/ADD/KEEP/PRUNE 통합 제안표 → 1회 확인 → 적용 → evaluator 독립 평가표. 전체 설치 후 프로젝트에 맞게 맞춤화할 때 사용.
하네스의 모든 HTML 산출물(문서·가이드·랜딩·리포트·데모 등)을 일관된 디자인 시스템으로 작성·갱신하는 범용 스킬. anti-ai-slop 하드 게이트 + theme-factory(색·폰트)·frontend-design(레이아웃 방향) 디자인 검토 + 1000px 반응형 + 임베드(SPA) 안전 + 실측 검증을 기본 탑재. HTML을 "예쁘게/그럴듯하게" 만들 때 발동. 릴리스 시 carve-workflow-guide.html 갱신은 §7 특수 모드(이 리포 전용).
이미지·HTML·SVG·슬라이드·PDF 등 시각 산출물과 문서·리포트·카피 글쓰기를 생성·수정하기 전 반드시 발동한다. 그라데이션·글로우·장식 모션 등 AI 특유의 조악한(slop) 디자인을 차단하고, 상투어·균질 구조·불릿 남발 등 AI 티가 나는 글쓰기 흔적을 제거한다. 정보 위계·여백·타이포·근거·절제로 시니어 실무자가 만든 수준의 고급 산출물을 만드는 품질 게이트. 무언가를 "예쁘게" 또는 "그럴듯하게" 만들려는 순간마다 이 게이트를 통과시킨다.
Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.
릴리스 버전이 바뀔 때 VERSION·CHANGELOG.md·README 버전 이력을 함께 갱신한다. 버전 업/릴리스 준비 시 반드시 사용 — VERSION만 바꾸면 pre-commit이 커밋을 차단한다.