Docs Guide

docs/는 위키 운영 규칙과 절차를 모아둔 디렉터리입니다. 지식 문서는 wiki/, 변경하지 않는 원본은 raw/에 두고 운영 설명만 여기서 관리합니다.

탐색 관계

이 저장소는 아래 흐름으로 읽는 것이 가장 자연스럽습니다.

• 전역 탐색: ../index.md에서 전체 문서군과 도메인 허브를 찾습니다.
• 도메인 탐색: wiki/domain-*.md 허브에서 프로젝트 묶음을 따라갑니다.
• 운영 탐색: 이 docs/ 허브에서 ingest, lint, verification 절차를 찾습니다.

즉, index.md는 전체 지도, wiki/domain-*.md는 도메인 지도, docs/는 운영 규칙 모음입니다.

핵심 문서

• domain-expansion-priorities.md : 도메인 유지 보강 우선순위
• domain-ingest-pattern.md : 도메인 묶음 확장 패턴
• web-publishing.md : MkDocs/Vercel 공개 절차
• oci-static-hosting.md : OCI VM에 정적 사이트를 직접 서빙하는 절차
• ingest-checklist.md : 새 raw 소스 변환 절차
• lint-checklist.md : 링크와 구조 점검 절차
• frontmatter-schema.md : wiki/ 메타데이터 규칙
• index-maintenance.md : index.md 배치 규칙
• log-maintenance.md : log.md 기록 규칙
• term-expansion-workflow.md : 확장 후보 추출 절차
• term-expansion-candidates.md : 현재 후보 backlog
• verification-rules.md : 위키 검증 기준

보조 문서

• superpowers/plans/ : 도구·운영 자동화 구현 계획 메모

사용 원칙

• 새 운영 규칙은 먼저 이 디렉터리에 추가합니다.
• index.md와 AGENTS.md에는 이 허브나 핵심 문서를 함께 연결합니다.
• 위키 탐색 구조가 바뀌면 wiki/README.md와 이 문서를 함께 갱신합니다.
• 구조를 바꾼 뒤에는 make verify를 우선 돌립니다.
• python3 scripts/find_term_candidates.py --include-docs를 쓰면 운영 메모까지 읽어 확장 후보를 찾습니다.