에이전트 협업 인프라 구축 — .claude/ 확장
All checks were successful
Publish ParaWiki / build-and-deploy (push) Successful in 29s
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:
19
.claude/commands/adr.md
Normal file
19
.claude/commands/adr.md
Normal 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을 읽어 중복·충돌 여부 확인.
|
||||
29
.claude/commands/cimery-start.md
Normal file
29
.claude/commands/cimery-start.md
Normal 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
24
.claude/commands/plan.md
Normal 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
|
||||
22
.claude/commands/progress.md
Normal file
22
.claude/commands/progress.md
Normal 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
|
||||
25
.claude/commands/research.md
Normal file
25
.claude/commands/research.md
Normal 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
|
||||
Reference in New Issue
Block a user