Menu
사용자가 명시적으로 요청한 경우에만 retrospective 누적물을 분석해 반복 패턴을 식별하고, 구조화된 질문에 대한 답변에 따라 skill/agent/hook/참조문서를 갱신.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | improve-harness |
| description | 사용자가 명시적으로 요청한 경우에만 retrospective 누적물을 분석해 반복 패턴을 식별하고, 구조화된 질문에 대한 답변에 따라 skill/agent/hook/참조문서를 갱신. |
"Harness"란 AI agent 시스템이 신뢰성 있게 작동하도록 감싸는 설정·규칙·자동화 레이어 전체를 말한다. 이 저장소에서 harness는 다음 구성요소로 이루어진다:
| 구성요소 | 위치 | 역할 |
|---|---|---|
| Skills | .agents/skills/<verb-noun>/SKILL.md | 재사용 가능한 단일 목적 작업 단위 |
| Agents | .claude/agents/, .codex/agents/ | 도메인 전문 페르소나·서브에이전트 |
| Prompts / Commands | .claude/commands/, .codex/prompts/ | 채널별 사용자 진입점 |
| Hooks | .claude/settings.json, .github/hooks/ | 세션 시작·종료·명령 전후 자동 트리거 |
| MCP 설정 | .vscode/mcp.json, .mcp.json | 외부 도구 연결(legalize-kr, notebooklm 등) |
| 명명 규약 | .agents/CONVENTIONS.md | 일관된 식별자 체계 |
| AGENTS.md 계층 | AGENTS.md, */AGENTS.md | 범위별 행동 규칙 |
Anthropic Claude Code — subagents best practice
description의 "Use when:" 절이 명확할수록 모델이 자동 선택 정확도가 높아진다.CLAUDE.md(= 이 저장소의 AGENTS.md)를 세션 시작에 자동으로 읽힌다 — 규칙 중복 작성 금지.OpenAI Codex CLI — prompting guide
brief, collect, retro)가 긴 명사구보다 호출 안정성이 높다.developer_instructions에 Role / Context / Procedure / Output 4섹션 구조를 쓰면 모델이 일관된 출력을 만든다.# Custom instructions)LLM-powered autonomous agent patterns (Lilian Weng, 2023)
track-goals skill이 담당.회고/*.md, .goals/current.md). 회고를 harness 개선 루프에 연결하는 것이 핵심.pre-tool-bash.ps1 훅으로 차단.Retrospective-driven improvement loop (이 저장소 패턴)
write-retro 로 회고 저장improve-harness 실행$ARGUMENTS: (선택) 분석할 retrospective 수. 생략 시 전체.회고/*.md를 읽어 다음을 추출:
## 막힌 것 항목 전체## 자동화 후보 항목 전체## 새로 알게 된 사이트·포맷·정책 항목 전체## 성공한 것 중 반복 성공 패턴추출된 항목을 교차 비교하여:
| 패턴 유형 | 조건 | 처리 후보 |
|---|---|---|
| 반복 차단 | 같은 "막힌 것"이 2회 이상 | skill 또는 hook 생성 후보 |
| 미구현 자동화 후보 | "자동화 후보"에 등록 후 아직 구현 안 됨 | 우선순위 질문 |
| 반복 사이트 발견 | 같은 사이트가 2회 이상 "새로 알게 된" | 문서/ 기존 참조 문서 보강 후보 |
| 반복 성공 패턴 | 같은 접근법이 효과적으로 2회 이상 사용됨 | skill 규칙 강화 또는 AGENTS.md 규칙 후보 |
식별된 패턴을 우선순위순으로 정리하고, 각각에 대해 구조화된 질문:
한 번에 3개 이하의 질문만 던진다. 나머지는 다음 실행으로 이월.
사용자 답변에 따라:
| 답변 | 실행 |
|---|---|
| skill 생성 | .agents/skills/<verb-noun>/SKILL.md stub 작성 |
| hook 생성 | 대상 채널의 설정 파일에 hook 추가 (Claude: .claude/settings.json, Copilot: .github/hooks/) |
| references 추가 | 문서/ 기존 참조 문서에 항목 append |
| 스킬 규칙 강화 | 해당 .agents/skills/<name>/SKILL.md에 규칙 추가 |
| AGENTS.md 규칙 후보 | 직접 수정하지 않음 — 후보 텍스트만 출력하고 사용자가 별도 확인 후 반영 |
| 보류 | 기록만 남기고 다음 실행까지 이월 |
처리 결과를 .goals/feedback-log.md에 append:
## YYYY-MM-DD
- 패턴: <설명>
- 결정: <사용자 선택>
- 실행: <수행한 변경 요약>
verb-noun 규칙을 따른다..claude/.github/.codex/.vscode/사용자가 /improve-harness 또는 improve-harness을 명시적으로 요청한 경우에만 실행한다. 자동 트리거 금지.
| 자료 | 링크 | 핵심 내용 |
|---|---|---|
| Claude Code subagents guide | https://docs.anthropic.com/en/docs/claude-code/sub-agents | Single responsibility, "Use when:", AGENTS.md 자동 로드 |
| Codex CLI README | https://github.com/openai/codex | Role/Context/Output 구조, 짧은 식별자 |
| LLM Powered Autonomous Agents (Weng) | https://lilianweng.github.io/posts/2023-06-23-agent/ | Planning·Memory·Tool use 3요소 |
| ReAct: Synergizing Reasoning and Acting | https://arxiv.org/abs/2210.03629 | 추론(Thought)+행동(Act)+관찰(Observe) 루프 |
| Anthropic Model Specification | https://anthropic.com/model-spec | 안전·윤리 제약이 harness 규칙 설계에 미치는 영향 |
동적 로딩(JavaScript 렌더링)을 사용하는 대한민국 지방의회·광역의회 누리집에서 browser 또는 Playwright 도구로 회의록 목록·회기유형·상세 본문 경로를 수집하고 검증 가능한 메타데이터와 함께 정리한다. Use when: 성남시의회 등 지방의회에서 정례회/임시회 판별, 회기별 회의록 URL 수집, recordView key 추출, 대량 회의록 다운로드 입력(JSONL) 생성이 필요할 때.
동적 로딩(JavaScript 렌더링)을 사용하는 대한민국 지방의회·광역의회 누리집에서 browser 또는 Playwright 도구로 연간의사일정·회기일정·위원회 일정을 수집하고 Markdown 표로 정리한다. Use when: 성남시의회·경기도의회 등 지방의회 공식 페이지에서 회기번호·집회일·종료일· 주요의제를 추출해야 할 때; 연도 선택형 드롭다운이나 AJAX 렌더링으로 직접 크롤링이 불가능할 때; 연간의사일정 문서를 최신 공식 데이터로 갱신할 때.
대한민국 지방자치단체의 조례·자치법규를 ELIS, 지방의회 의안검색, law.go.kr에서 교차 확인해 원문을 보존하고 메타데이터 주석이 있는 Markdown으로 변환한다. 최신 조례 목록 확인, 자치법규 수집, 조례안과 시행 조례 교차검증, Semantic 카테고리 분류, 개정 이력 누적 저장에 사용한다.
저장소 전체의 prompt, agent instructions, tool configuration, document organization을 종합 점검하여 규칙 불일치·누락·중복을 식별하고 수정 제안을 출력.
location.txt 또는 사용자 지정 지역을 기준으로 심야·새벽 병원 접근성을 조사한다. 병원 목록, 소아청소년과·가정의학과, 응급실 대안, 위치 정보를 표로 정리한다. Use when: 특정 지역의 야간진료 병원 탐색, 소아과/가정의학과 야간 운영 조사, 응급실 대안 정리, 지역별 심야 의료 접근성 보고서 작성.
검토하고 재작성한다: Markdown 조사 문서의 주관적·평가적·추정형 표현을 사실 서술형으로 바꾸고 information / evidence / reference 연결을 정리할 때 사용.