Harness Audit

하네스 건강도 진단

Codex 하네스 설정의 전체 건강도를 8개 차원으로 진단합니다.

8개 진단 차원

1. AGENTS.md 품질 (0-3)

• 0: 없음
• 1: 존재하지만 기본만
• 2: 프로젝트 컨텍스트 + 규칙 포함
• 3: 상세한 아키텍처 + 패턴 + 안티패턴

2. Skills 커버리지 (0-3)

• 0: 스킬 없음
• 1: 1-5개
• 2: 6-15개 + 트리거/안티트리거 정의
• 3: 16개+ + 도메인별 분류 + eval 스킬 포함

3. Agents 아키텍처 (0-3)

• 0: 에이전트 없음
• 1: 1-3개 (기본)
• 2: 4-8개 + 역할 분리 명확
• 3: 9개+ + evaluator 분리 + 역할 경계 매트릭스

4. Hooks 자동화 (0-3)

• 0: 훅 없음
• 1: 기본 (prettier, lint)
• 2: 품질 게이트 + 보안 스캔
• 3: 전체 파이프라인 (coverage + security + e2e + eval)

5. Rules 구조화 (0-3)

• 0: 규칙 없음
• 1: 1-2개 일반 규칙
• 2: 파일 패턴별 규칙 (.ts, .py 등)
• 3: 도메인별 + 보안 + 성능 + 테스트 규칙

6. MCP 서버 (0-3)

• 0: MCP 없음
• 1: 1-2개 기본
• 2: 검색 + 문서 + UI 도구
• 3: 검색 + 문서 + 코드 분석(code-review-graph 등)

7. Eval 파이프라인 (0-3)

• 0: eval 없음
• 1: 수동 verify만
• 2: 자동 품질 게이트 + 스코어링
• 3: 독립 evaluator + pass@k + AI 슬롭 감지

8. 팀/멀티에이전트 (0-3)

• 0: 단독 사용
• 1: 기본 서브에이전트
• 2: 역할 기반 팀 + 커뮤니케이션 프로토콜
• 3: Codex /goal + custom agents + backpressure

실행 프로세스

1. 프로젝트 루트와 ~/.codex/ 디렉토리 전체 스캔
2. 각 차원별 점수 산출 (0-3)
3. 총점 (0-24) + 등급 산출

등급

| 총점 | 등급 | 설명 | |------|------|------| | 21-24 | S | 프로덕션 레벨 하네스 | | 16-20 | A | 고급 설정. 소수 항목 개선 필요 | | 11-15 | B | 중급. 핵심 갭 존재 | | 6-10 | C | 기초. 대부분 수동 | | 0-5 | D | 미설정. 바닐라 상태 |

출력 형식

📊 하네스 건강도: [등급] ([N]/24)

| 차원 | 점수 | 상태 |
|------|------|------|
| AGENTS.md | [N]/3 | [상/중/하] |
| Skills | [N]/3 | ... |
| Agents | [N]/3 | ... |
| Hooks | [N]/3 | ... |
| Rules | [N]/3 | ... |
| MCP | [N]/3 | ... |
| Eval | [N]/3 | ... |
| Team | [N]/3 | ... |

🔧 개선 제안:
1. [가장 낮은 점수 차원 개선 방안]
2. ...

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: jh941213
• Source: jh941213/codex-lattice
• License: MIT

Install and usage instructions live in the source repository linked above.