qshanx/docs-governance

해결하는 문제

AI가 코드 작성을 도울 때 코드는 재생성 비용이 저렴해지지만, 그 뒤에 있는 추론—왜 결정이 내려졌는지, 테스트가 무엇을 증명하는지, 어떤 영역이 위험한지—은 손실됩니다. 새로운 세션이나 에이전트는 결국 동일한 구조를 재발견하게 되고, README는 낡아지며 아키텍처 근거는 사라집니다. docs-governance는 프로젝트 문서를 확인된 컨텍스트, 결정, 인계 증거를 보존하는 작은 시스템으로 취급하여 좋은 작업이 세션을 넘어 생존하고 재사용 가능한 프로젝트 역량이 되도록 합니다.

작동 방식

더 많은 문서를 작성하도록 강요하는 대신, 플러그인은 각각 단일 책임을 가진 4개의 파일로 구성된 얇은 문서 스파인을 설정합니다: 지속적인 규칙(CLAUDE.md), 내비게이션 및 건드리지 말아야 할 영역(CLAUDE_MAP.md), 현재 상태 및 우선순위(PROJECT_STATUS.md), 그리고 추가 전용 프로젝트 기록(PROJECT_LOG.md). 가능한 경우 기존 소스를 재사용하고 기존 PRD/Spec 파일을 권위 있는 것으로 유지합니다. 시스템은 Claude Code, Codex 또는 ChatGPT에서 호출할 수 있는 일련의 집중된 스킬을 통해 작동합니다—예: 감사, 아키텍처 문서, 일일 유지 관리, 에이전트용 작성. 감사는 기본적으로 읽기 전용입니다. 설정은 훅을 암시적으로 설치하거나 Git을 초기화하거나 커밋하거나 푸시하지 않습니다. 시스템은 Markdown을 진실의 원천으로 사용하며, 선택적으로 재구성 가능한 SQLite 인덱스(gitignore됨)를 포함합니다.

대상 사용자

이것은 Claude Code, Codex 또는 ChatGPT와 같은 도구를 사용하여 장기 AI 지원 프로젝트를 운영하는 팀과 개인을 위한 것입니다. 여러 에이전트나 세션이 프로젝트 규칙, 결정, 검증 증거에 대한 일관된 이해를 공유해야 할 때, 그리고 세션 간에 컨텍스트를 잃지 않으려 할 때 특히 유용합니다.

주요 특징

• 기본적으로 읽기 전용 감사: /governance-audit는 자동 재작성이 아닌 보고서를 생성합니다.
• 각 파일에 명확한 단일 책임이 있는 얇은 문서 스파인.
• 기존 PRD/Spec 파일과 기존 내비게이션을 재사용합니다. 확장은 선택 사항으로 유지됩니다.
• 선택적 SQLite 인덱스는 재구성 가능하고 gitignore됩니다. Markdown은 진실의 원천으로 남습니다.
• 아키텍처 문서, 변경 영향, 계약 우선 협업, 모듈 회귀를 위한 집중된 스킬을 포함합니다.
• 에이전트 친화적으로 작성됨: 점진적 공개, 완료 기준, AI가 읽는 문서에 대한 로컬 최종 검사.