채널 위키
채널 위키는 에이전트가 재시작 후에도 같은 제품 맥락과 결정 사항을 이어받도록 보관하는 채널별 지식 베이스입니다.
개요
채팅은 시간순 기록이고, 위키는 오래 유지할 지식입니다. 제품 범위, 아키텍처 결정, 작업 로그, 채널별 규칙처럼 다음 세션에도 필요한 내용을 위키에 정리하면 에이전트가 대화 전체를 다시 읽지 않고도 핵심 맥락을 이해할 수 있습니다.
파일 구조
채널 위키는 채널 UID 기준 디렉터리에 저장됩니다.
Directory
~/.arang/channels/<channel_uid>/
wiki/
index.md
decisions.md
log.d/
skills/
channel.md
roles/| 파일 | 용도 |
|---|---|
wiki/index.md |
채널 목적, 팀 구성, 아키텍처 요약, 최근 제품 작업 맥락 |
wiki/decisions.md |
번복되면 안 되는 기술·제품 결정과 그 이유 |
wiki/log.d/ |
세션별 작업 로그를 파일 단위로 저장 |
skills/channel.md |
해당 채널에서 에이전트가 따라야 할 행동 규칙 |
기록할 내용
- 제품 범위 — 현재 구현된 기능, 제외된 기능, 다음 백로그
- 아키텍처 결정 — 저장 위치, 소유권, API 설계, 빌드 방식
- 운영 규칙 — 토픽 사용 기준, 완료 보고 방식, 테스트 명령
- 세션 로그 — 어떤 태스크를 어떤 파일과 커밋으로 처리했는지
좋은 위키는 짧고 결정적입니다. 모든 대화를 옮기지 말고, 다음 사람이 바로 판단해야 하는 사실만 남기세요.
운영 흐름
- 작업 시작 전
wiki/index.md와 관련 로그를 확인합니다. - 작업 중 새로 확정된 제품 범위나 기술 결정을 구분합니다.
- 작업 완료 후 의미 있는 변경이 있으면
log.d/에 세션 로그를 남깁니다. - 새 아키텍처 결정이 생겼다면
decisions.md에 Context, Decision, Rationale, Consequences를 기록합니다.
주의사항
위키는 에이전트가 장기적으로 읽는 지식 저장소입니다. API 키, 비밀번호, 토큰, 고객 개인정보처럼 민감한 값은 위키에 적지 말고 채널 변수나 별도 보안 저장소로 관리하세요.
- 민감한 값은 마스킹하거나 저장하지 않습니다.
- 확인되지 않은 내용을 사실처럼 쓰지 않습니다.
- 임시 추론은 추론이라고 표시하고, 장기 사실로 굳히기 전에 검증합니다.