agent-wiki
어떤 정보 공간이든 git 기반 워크스페이스 인터페이스로 만들고 관리한다. 문서 유형(애자일, IA, 기술 문서 등)에 구애받지 않는다. 이 스킬의 핵심은 AGENTS.md — 에이전트가 워크스페이스를 읽고 작업할 때 따르는 동적 길잡이.
모드 감지
실행 전 아래 순서로 모드를 결정하고, 해당 workflow 파일을 Read하여 절차를 따른다.
| 조건 | 모드 | workflow 파일 |
|---|---|---|
| "help"/"사용법"/"뭐야"/"어떤 걸 할 수 있어" 등 스킬 자체 질문 | GUIDE | workflow/guide-mode.md |
| URL 인수 + "연결"/"서브모듈"/"connect" 키워드 | CONNECT | workflow/connect-mode.md |
| "read"/"읽어줘"/"내용 파악"/"분석해줘" 단독 요청 | READ | workflow/read-mode.md |
"update"/"업데이트"/"수정"/"추가" 요청 또는 CWD에 AGENTS.md 있음 | UPDATE | workflow/update-mode.md |
| "create"/"새로 만들어줘"/"위키 만들어줘"/"초기화" 또는 그 외 | CREATE | workflow/create-mode.md |
워크스페이스 구조
agent-wiki는 내용 구조를 강제하지 않는다. 최소 공통 파일만 생성한다:
[project]-wiki/
├── AGENTS.md ← 워크스페이스 길잡이 (동적 생성, 읽기 순서 + 구조 설명)
├── README.md ← 워크스페이스 소개
├── .gitignore ← 에이전트 캐시 등 제외
└── ... ← 실제 문서 (유형 자유)
AGENTS.md 원칙:
- 짧게 — 내용을 담는 곳이 아니라 길잡이
- 읽기 순서 명시 — 에이전트가 어디서 시작할지 바로 알 수 있어야 함
- 구조 설명 — 각 파일/폴더의 역할을 한 줄씩
- 작업 안내 — 이 워크스페이스의 규칙·패턴 (있다면)
참고 파일
Workflow
| 파일 | 역할 |
|---|---|
workflow/guide-mode.md | 스킬 안내 (GUIDE) |
workflow/create-mode.md | 워크스페이스 초기화 (CREATE) |
workflow/connect-mode.md | 서브모듈 연결 (CONNECT) |
workflow/read-mode.md | 위키 내용 파악 (READ) |
workflow/update-mode.md | 문서 변경 (UPDATE) |
Templates
| 파일 | 역할 |
|---|---|
templates/agents-md.md | AGENTS.md 구조 가이드 |
templates/README.md | README 구조 가이드 |
templates/.gitignore | 기본 .gitignore |
References
| 파일 | 역할 |
|---|---|
references/wiki-agents-guide.md | 워크스페이스 이름 규칙 + 기반 파일 작성 규칙 |