Help us improve
Share bugs, ideas, or general feedback.
From ccpp
Diagnoses agent harness maturity against 12 principles via file checks and greps, scoring levels (L1-L5) and suggesting setup, audit, or maintenance improvements without modifications.
npx claudepluginhub jh941213/my-cc-harness --plugin ccppHow this skill is triggered — by the user, by Claude, or both
Slash command
/ccpp:harness-diagnosticsThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
12원칙 기반 하네스 성숙도 진단 및 개선 제안 도구.
Scores a project's agent harness across 5 subsystems, identifies the bottleneck, and outputs a prioritized improvement plan. Use to assess readiness for long-run agent sessions or when adopting an agent stack on a new codebase.
Diagnoses Claude Code harness health (hooks, skills, agents, rules, MCP, eval) across 8 dimensions, scores 0-24 with S-D grades, and provides improvement suggestions. Scans ~/.claude/. Triggers: harness audit, 하네스 진단.
Assesses codebase readiness for agents/production across 8 pillars, verifies commands/GitHub settings, reports all issues, auto-fixes agent readiness.
Share bugs, ideas, or general feedback.
12원칙 기반 하네스 성숙도 진단 및 개선 제안 도구. Read-only: 진단 + 제안만 수행하며, 직접 파일을 수정하지 않음.
$ARGUMENTS
| 모드 | 트리거 키워드 | 목적 |
|---|---|---|
| Setup | "환경 구축", "setup", "초기화" | 에이전트 협업 환경 초기 점검 + 추천 |
| Audit | "하네스 진단", "점검", "audit", 기본값 | 12원칙 점수화 + 개선 로드맵 |
| Maintenance | "drift 확인", "정리", "maintenance" | stale 코드/문서 감지 + 정리 제안 |
키워드가 없으면 Audit 모드를 기본으로 실행.
각 원칙 0-8점, 총 100점 (12 × 8 = 96, 나머지 4점은 종합 보너스).
| # | 원칙 | 점검 대상 |
|---|---|---|
| 1 | Agent Entry Point | CLAUDE.md/AGENTS.md 존재 + 명확한 에이전트 진입점 |
| 2 | Map, Not Manual | 문서가 "지도"인가 vs "매뉴얼"인가 (포인터, 계층 구조) |
| 3 | Invariant Enforcement | 도구가 실수를 자동 차단하는가 (hooks, linters, CI) |
| 4 | Convention Over Configuration | 명시적 규칙 파일 존재 (rules/, .eslintrc, prettier 등) |
| 5 | Progressive Disclosure | 정보 계층화 (CLAUDE.md → rules/ → docs/ → 코드) |
| 6 | Layered Architecture | 의존성 방향 단방향, 레이어 분리 |
| 7 | Garbage Collection | stale 파일/문서/의존성 정리 메커니즘 |
| 8 | Observability | 자체 검증 가능 (테스트, 빌드, 타입체크) |
| 9 | Knowledge in Repo | 지식이 레포에 있는가 (ADR, docs/, 인라인 설명) |
| 10 | Reproducibility | 동일 입력 → 동일 결과 (lock 파일, 환경 설정) |
| 11 | Modularity | 변경 영향 예측 가능 (모듈 경계, 인터페이스) |
| 12 | Self-Documentation | 코드가 의도를 설명하는가 (네이밍, 구조) |
| 등급 | 점수 | 설명 |
|---|---|---|
| L1 None | 0-19 | 하네스 없음. 에이전트가 매번 처음부터 추론 |
| L2 Basic | 20-39 | 기본 설정 존재. 일부 자동화 |
| L3 Structured | 40-59 | 구조화된 규칙과 도구. 대부분 자동화 |
| L4 Optimized | 60-79 | 최적화된 하네스. 에이전트 자율성 높음 |
| L5 Autonomous | 80-100 | 자율 운영. 자가 진단/수정 가능 |
CLAUDE.md 또는 .claude/CLAUDE.mdrules/ 또는 .claude/rules/docs/ 디렉토리# 🔍 Harness Diagnostics Report
## 프로젝트: {프로젝트명}
## 모드: {Setup | Audit | Maintenance}
## 날짜: {YYYY-MM-DD}
---
## 원칙별 점수
| # | 원칙 | 점수 | 근거 |
|---|------|------|------|
| 1 | Agent Entry Point | X/8 | ... |
| 2 | Map, Not Manual | X/8 | ... |
| ... | ... | ... | ... |
| 12 | Self-Documentation | X/8 | ... |
**종합 보너스**: X/4
**총점**: XX/100
## 성숙도 등급: LX {등급명}
---
## 개선 제안 Top 3
### 1. {제안 제목} (P{0-2})
- **현재**: {현재 상태}
- **개선**: {구체적 액션}
- **효과**: {기대 점수 향상}
### 2. ...
### 3. ...
---
## 상세 분석
{원칙별 상세 설명 — 접힌 섹션으로}