에이전트 협업 인프라 구축 — .claude/ 확장
All checks were successful
Publish ParaWiki / build-and-deploy (push) Successful in 29s

- PLAN.md · PROGRESS.md 도입: 병렬 에이전트 조정 지점
- CLAUDE.md 린화 + 에이전트 작업 흐름 섹션 (상세는 Output/guides/로 분리)
- Output/guides/cimery-dev-guide.md, obsidian-cli.md 신설
- Agents: cimery-architect-researcher, adr-drafter
- Commands: /plan, /progress, /adr, /research, /cimery-start
- Skill: plan-commit
- Hooks: raw/ 쓰기 차단, SessionStart PLAN/PROGRESS 주입,
  wiki/ADR 변경 시 log 갱신 알림, auto-approve (deny 훅 우선 유지)
- .gitignore: .claude/ 공유 자산 포함, 로컬 상태·바이너리만 유지 제외

Closes #3

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
minsung
2026-04-14 17:21:11 +09:00
parent d90ef2cfe1
commit 3bd01e31c9
23 changed files with 1059 additions and 67 deletions

19
.claude/commands/adr.md Normal file
View File

@@ -0,0 +1,19 @@
---
description: Draft a new ADR for the given decision topic using the adr-drafter agent
argument-hint: <decision topic or short description>
---
cimery 아키텍처 결정을 ADR 문서로 만든다.
## 절차
1. `Output/reports/` 디렉터리를 읽어 다음 ADR 번호 결정 (`max(NNN) + 1`).
2. `adr-drafter` 에이전트를 호출한다 — 입력으로 현재 주제와 이미 결정된 맥락을 전달.
3. 에이전트가 `Output/reports/ADR-NNN-<slug>.md`를 작성하고 `wiki/log.md` · `PROGRESS.md`에 한 줄씩 추가.
4. 작성된 ADR 경로 + 요약을 사용자에게 보고.
5. **커밋·푸시는 사용자 명시 요청 시에만 수행.**
## 주제
$ARGUMENTS
## 참고
먼저 `PROGRESS.md`·`PLAN.md`·`Output/guides/cimery-dev-guide.md`·기존 ADR을 읽어 중복·충돌 여부 확인.

View File

@@ -0,0 +1,29 @@
---
description: Start a cimery work session — load PROGRESS, PLAN, dev-guide context
---
cimery 작업 세션 진입 루틴. 실제 구현은 시작하지 않고 **상황을 정리**만 한다.
## 실행 절차
1. `PROGRESS.md` 읽기 — "현재 스냅샷" + 최근 10건 타임라인.
2. `PLAN.md` 읽기 — P0·P1 섹션만.
3. `Output/guides/cimery-dev-guide.md` 읽기 — "구현 우선순위" + "함정 체크리스트" 섹션만.
4. 다음 형식으로 요약:
```
## 지금까지 (PROGRESS)
- <최근 3~5건>
- 현재 cimery 코드 상태: <있음/없음/일부>
## 지금 해야 할 일 (PLAN P0·P1)
- <P0 항목>
- <P1 항목>
## 주의 (dev-guide)
- <가장 중요한 함정 2~3개>
## 제안
<다음에 할 가장 자연스러운 1~2개 행동>
```
5. **구현 시작 금지.** 사용자의 다음 지시를 기다린다.

24
.claude/commands/plan.md Normal file
View File

@@ -0,0 +1,24 @@
---
description: Show PLAN.md current P0/P1 or add/complete items
argument-hint: [add <text> | done <pattern> | (empty)]
---
PLAN.md at project root 관리 커맨드.
## 인수 없으면
`PLAN.md`의 "현재 스프린트" 섹션(P0·P1)만 보여주고 백로그는 줄 수만 요약.
## `add <text>`
백로그 적절한 카테고리에 `- [ ] <text>` 추가. 우선순위는 사용자에게 질문(기본 백로그).
## `done <pattern>`
해당 항목을 찾아서:
1. `PLAN.md`에서 제거
2. `PROGRESS.md` 타임라인 상단에 `- YYYY-MM-DD <유형> <항목 텍스트>` 추가
3. 변경사항 요약 보고
## 규칙
- 둘 다 같은 커밋에 포함되어야 함 (atomic). 단 커밋은 **자동 실행 금지** — 사용자 명시 요청 시만.
- 날짜는 오늘(`date +%F`).
$ARGUMENTS

View File

@@ -0,0 +1,22 @@
---
description: Show recent PROGRESS.md entries or add a completion entry
argument-hint: [add <type> <text> | snapshot | (empty)]
---
PROGRESS.md at project root 관리 커맨드.
## 인수 없으면
타임라인 최근 10건 + "현재 스냅샷" 섹션 요약.
## `add <type> <text>`
타임라인 **오늘 섹션 맨 위**에 `- <type> — <text>` 추가. `type``adr|wiki|guide|meta|raw|code|infra` 중 하나.
오늘 섹션이 없으면 `### YYYY-MM-DD` 헤더와 함께 새로 생성.
## `snapshot`
"현재 스냅샷" 섹션을 현재 저장소 상태 기반으로 재작성 (위키 페이지 수·ADR 수·가이드 수·cimery 코드 존재 여부).
## 규칙
- PLAN.md에서 제거된 항목은 여기에 추가되어야 함 (pair). `/plan done` 명령과 대칭.
- 날짜는 오늘(`date +%F`).
$ARGUMENTS

View File

@@ -0,0 +1,25 @@
---
description: Dispatch cimery-architect-researcher agent(s) to research a topic, optionally in parallel
argument-hint: <topic> | <topic1>; <topic2>; <topic3>
---
cimery 아키텍처 주제를 `cimery-architect-researcher` 에이전트로 심층 조사한다.
## 인수 파싱
- 세미콜론(`;`)으로 구분된 여러 주제면 **병렬 dispatch** (단일 메시지에 multiple Agent tool calls).
- 단일 주제면 1개 에이전트.
## 각 에이전트에 전달할 프롬프트 (자동 생성)
- 맥락 우선순위 알림 (PROGRESS·PLAN·dev-guide·ADR·wiki·메모리·웹)
- 주제
- 출력 형식: 비교표·추천·근거·Sources, 300~500 단어
## 결과 집계
모든 에이전트 리포트 수신 후:
1. 요약 테이블 제시 (주제별 추천 한 줄)
2. 상충 결정 있으면 명시
3. 사용자에게 "추천대로 확정할지 / 수정할지" 묻기
4. 확정 시 `/adr <주제>` 로 ADR 초안 작성 제안
## 주제
$ARGUMENTS