kimminsung/ParaWiki
1
0
Fork 0
Code Issues 10 Pull Requests Actions Packages Projects Releases Wiki Activity

에이전트 협업 인프라 구축 — .claude/ 확장 (agents/commands/skills/hooks) #3

New Issue
Closed
opened 2026-04-14 17:18:47 +09:00 by kimminsung · 0 comments
kimminsung commented 2026-04-14 17:18:47 +09:00
Owner
Copy Link
Copy Source

배경

PLAN.md · PROGRESS.md 기반의 에이전트 협업 프로토콜을 실제 Claude Code 확장으로 구현. 여러 에이전트가 병렬로 작업할 때 조정 지점을 자동화하고, Karpathy Wiki 규칙(raw/ 불변)을 하드 가드로 강제.

추가된 항목

Agents (.claude/agents/)

  • cimery-architect-researcher.md — cimery 아키텍처 주제 심층 조사 (오늘 12개 병렬 조사 패턴 재사용). ADR·wiki·메모리를 순서대로 읽고 웹 조사.
  • adr-drafter.md — ADR 형식 자동 준수. ADR-001/002/003 스타일 고정, 번호 자동 부여, wiki/log.md · PROGRESS.md 한 줄씩 자동 추가.

Commands (.claude/commands/)

  • /plan — PLAN.md P0/P1 현황 + add/done 액션.
  • /progress — PROGRESS.md 최근 10건 + add/snapshot 액션.
  • /adr <주제> — adr-drafter 에이전트 dispatch → ADR 초안.
  • /research <주제>;<주제> — 여러 주제 병렬 조사 dispatch.
  • /cimery-start — 세션 진입 루틴 (PROGRESS → PLAN → dev-guide 순차 요약).

Skill (.claude/skills/plan-commit/)

  • PLAN.md에서 완료 항목을 PROGRESS.md로 원자적 이동. 커밋은 기본 OFF.

Hooks (.claude/hooks/ + settings.json 업데이트)

  • block-raw-writes.sh — PreToolUse(Write|Edit|MultiEdit) on raw/** → 거부. Karpathy 규칙 #1 하드 가드.
  • session-start-context.py — SessionStart → PLAN.md P0/P1 + PROGRESS.md 스냅샷을 additionalContext로 주입.
  • wiki-log-reminder.sh — PostToolUse(Write|Edit|MultiEdit) on wiki/** · Output/reports/** · Output/guides/** → wiki/log.md · PROGRESS.md 갱신 알림.

효과

  1. 세션 시작 시 에이전트가 자동으로 프로젝트 상태를 인지.
  2. 원본(raw/) 실수 수정 원천 차단.
  3. 위키/ADR 변경 시 기록 누락 방지.
  4. ADR·조사 작업이 재현 가능한 명령으로 표준화.

관련

  • ADR-001 · ADR-002 · ADR-003 (결정 누적)
  • PLAN.md · PROGRESS.md (협업 프로토콜)
  • CLAUDE.md "에이전트 작업 흐름" 섹션
## 배경 PLAN.md · PROGRESS.md 기반의 에이전트 협업 프로토콜을 실제 Claude Code 확장으로 구현. 여러 에이전트가 병렬로 작업할 때 조정 지점을 자동화하고, Karpathy Wiki 규칙(raw/ 불변)을 하드 가드로 강제. ## 추가된 항목 ### Agents (`.claude/agents/`) - `cimery-architect-researcher.md` — cimery 아키텍처 주제 심층 조사 (오늘 12개 병렬 조사 패턴 재사용). ADR·wiki·메모리를 순서대로 읽고 웹 조사. - `adr-drafter.md` — ADR 형식 자동 준수. ADR-001/002/003 스타일 고정, 번호 자동 부여, wiki/log.md · PROGRESS.md 한 줄씩 자동 추가. ### Commands (`.claude/commands/`) - `/plan` — PLAN.md P0/P1 현황 + `add`/`done` 액션. - `/progress` — PROGRESS.md 최근 10건 + `add`/`snapshot` 액션. - `/adr <주제>` — `adr-drafter` 에이전트 dispatch → ADR 초안. - `/research <주제>;<주제>` — 여러 주제 병렬 조사 dispatch. - `/cimery-start` — 세션 진입 루틴 (PROGRESS → PLAN → dev-guide 순차 요약). ### Skill (`.claude/skills/plan-commit/`) - PLAN.md에서 완료 항목을 PROGRESS.md로 원자적 이동. 커밋은 기본 OFF. ### Hooks (`.claude/hooks/` + settings.json 업데이트) - `block-raw-writes.sh` — **PreToolUse(Write|Edit|MultiEdit)** on `raw/**` → 거부. Karpathy 규칙 #1 하드 가드. - `session-start-context.py` — **SessionStart** → PLAN.md P0/P1 + PROGRESS.md 스냅샷을 `additionalContext`로 주입. - `wiki-log-reminder.sh` — **PostToolUse(Write|Edit|MultiEdit)** on `wiki/**` · `Output/reports/**` · `Output/guides/**` → wiki/log.md · PROGRESS.md 갱신 알림. ## 효과 1. 세션 시작 시 에이전트가 자동으로 프로젝트 상태를 인지. 2. 원본(raw/) 실수 수정 원천 차단. 3. 위키/ADR 변경 시 기록 누락 방지. 4. ADR·조사 작업이 재현 가능한 명령으로 표준화. ## 관련 - ADR-001 · ADR-002 · ADR-003 (결정 누적) - PLAN.md · PROGRESS.md (협업 프로토콜) - CLAUDE.md "에이전트 작업 흐름" 섹션
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
kimminsung (김민성)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: kimminsung/ParaWiki#3