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 | 워크스페이스 이름 규칙 + 기반 파일 작성 규칙 |