위키 (Wiki)

위키는 프로젝트의 백과사전입니다. 나무가 프로젝트의 구조를 보여준다면, 위키는 구조만으로는 알 수 없는 내용을 담습니다. 각 부분이 어떻게 동작하는지, 지켜야 할 규칙은 무엇인지, 프로젝트에서 쓰는 말이 무슨 뜻인지 같은 것들입니다. 위키는 AI 에이전트가 쓰고, 사람은 앱의 Wiki 화면에서 읽습니다.

목차

위키 문서들은 하나의 목차로 이어집니다. 맨 위에 개요가 있고, 그 아래로 장(개념·구성·운영·용어 등)과 항목이 차례로 놓입니다. 앱의 Wiki 화면은 이 순서대로 번호를 붙여 보여주므로, 처음부터 차례로 읽으면 프로젝트 전체를 파악할 수 있습니다.

새 위키를 시작할 때 에이전트는 프로젝트 성격(웹 서비스·앱 서비스·라이브러리)에 맞는 권장 목차를 참고합니다.

문서의 모양

모든 문서는 같은 뼈대를 따릅니다.

• 도입: 이 문서가 다루는 대상이 무엇인지 한두 문장
• 스펙: 지금 어떻게 동작하는지
• 규칙: 지켜야 할 약속
• 주(각주): 배경·경위·메모. 본문을 가볍게 두려고 문서 끝으로 내립니다

문서마다 종류(개요·개념·구성요소·규칙·용어)가 있고, 제목은 ‘결제’, ‘배포’처럼 짧은 이름으로 씁니다. 형식에서 벗어나면 에이전트가 쓰는 즉시 경고를 받아 스스로 고칩니다.

기록

문서를 고칠 때마다 이전 내용이 리비전으로 남아 언제든 되돌릴 수 있습니다. 위키는 작업 일지가 아니라 “지금 어떻게 되어 있는가”를 적는 곳이라, 내용이 바뀌면 덧붙이지 않고 해당 문장을 고쳐 씁니다.