LLM–WIKI GOVERNANCE

LLM-WIKI Governance — 소스 인용과 문서 검토 기록

01 / 연결

코드가 바뀌어도,근거는 이어지도록.

AI 문서의 소스 인용과 검토 기록을 연결하는 오픈 소스 CLI.

스크롤하여 연결을 따라가세요

연결
START IN YOUR REPOSITORY

첫 연결을 만드세요.

파일을 하나도 쓰지 않습니다. 만들어질 문서 목록과 다음 단계만 출력합니다.

npx llm-wiki-governance@latest quickstart --dry-run
  • v1.42.0
  • MIT 라이선스
  • Node.js 18.18 이상
  • 런타임 의존성 없음
  • AI 모델 없이 동작
모든 명령과 주의 사항

먼저 아무것도 쓰지 않는 미리보기로 시작하세요. 각 명령이 파일을 바꾸는지, 설치가 필요한지 함께 적었습니다. 모든 명령은 v1.42.0에서 직접 실행해 확인했습니다.

개발 의존성으로 설치

파일을 씁니다 · 설치 없이 실행
npm install -D llm-wiki-governance

package.json과 lock 파일, node_modules를 바꿉니다. 이후에는 npx llm-wiki로 실행합니다.

문서 뼈대 만들기

파일을 씁니다 · 설치 없이 실행
npx llm-wiki-governance quickstart --write --agent claude

docs/llm-wiki/ 문서 뼈대, lite 모드로 설정된 llm-wiki.config.json, CLAUDE.md, 에이전트용 스킬과 프롬프트 파일을 만듭니다. Codex를 쓴다면 --agent codex를 쓰세요.

구조와 인용 검사

읽기 전용 · 설치 후 실행
npx llm-wiki validate

frontmatter 구조와 인용이 해석되는지 검사합니다. 아무것도 쓰지 않습니다.

검토 대기 목록 보기

읽기 전용 · 설치 후 실행
npx llm-wiki review

needs_review 문서를 위험도 순으로 나열하고, 승인 가능한 문서와 막힌 문서를 구분합니다.

읽어 본 문서 하나 승인

파일을 씁니다 · 설치 후 실행
npx llm-wiki review --approve docs/llm-wiki/project-profile.md

그 문서의 frontmatter에 status: verified, reviewed_by, reviewed_at을 기록합니다. 직접 읽고 확인한 문서에만 쓰세요.

변경 점검 켜기

파일을 씁니다 · 설치 후 실행
npx llm-wiki mode set standard --write

llm-wiki.config.json의 모드만 바꿉니다. 문서는 만들거나 고치거나 승격하지 않습니다. 이때부터 impact와 drift가 경고를 보고합니다.

PR에서 재검토할 문서 찾기

읽기 전용 · 설치 후 실행
npx llm-wiki impact --since origin/main

기준 ref 이후 바뀐 소스를 인용하는 verified 문서를 나열합니다. lite에서는 아무것도 검사하지 않고 통과합니다.

패키지를 설치하지 않은 곳에서 npx llm-wiki를 실행하지 마세요. 같은 이름의 무관한 npm 패키지가 있습니다. 설치 전에는 npx llm-wiki-governance를 씁니다.

KEEP THE JUDGMENT HUMAN

근거를 남기고, 판단은 직접.

검사를 통과했다는 것이 문서가 맞다는 뜻은 아닙니다. 다음은 v1.42.0 README가 직접 밝히는 한계입니다.

선택해서 비교하는 별도 데모

설명용 시뮬레이션입니다. 여러분의 저장소에 연결되지 않습니다.

다른 파일을 고르면 적용한 변경은 되돌려집니다.

return items.reduce((s, i) => s + i.price, 0);
—billing.md그대로● verified
—shipping.md그대로● verified

아직 바꾼 파일이 없습니다.

파일을 고르고 변경 적용을 누르면, 그 변경을 인용하는 문서와 CI 결과가 여기에 나옵니다.

실제 CLI 출력 보기

실제 v1.42.0 캡처 · 이 파일 변경 적용 후의 출력

$ npx llm-wiki impact --since main --mode standard
- result: warning
- governance_mode: standard
- changed_files: 1
- impacted_verified_docs: 1

## Documents to re-review
| Document | Changed source it cites |
| --- | --- |
| `docs/llm-wiki/domains/billing.md` | `src/invoice.js` |

## Findings
- [warning] impact.source_changed docs/llm-wiki/domains/billing.md: Verified document depends on src/invoice.js, which changed in this diff, but the document is unchanged; re-review and update it or downgrade to needs_review.
exit 0
검토 과정의 명령과 실제 출력

예시: src/invoice.js가 바뀐 뒤 billing.md를 다시 검토하는 과정입니다. 명령과 출력은 v1.42.0을 실제로 실행한 결과입니다.

drift는 날짜 기준입니다. reviewed_at 이후에 커밋된 변경을 봅니다.

$ npx llm-wiki review --approve docs/llm-wiki/domains/billing.md --reviewer maintainer
- approved: 0
- refused: 1

## Refused
- docs/llm-wiki/domains/billing.md: already verified
exit 
$ npx llm-wiki drift --downgrade --mode standard
- run: downgrade
- drifted_verified_docs: 1
- downgraded: 1

## Drift (evidence.stale)
- [warning] evidence.stale docs/llm-wiki/domains/billing.md: Verified document references src/invoice.js, which changed after 2026-10-27; re-review and update it or downgrade to needs_review.

## Downgraded
- docs/llm-wiki/domains/billing.md: downgrade verified → needs_review; refresh last_updated.
exit 0
$ npx llm-wiki review --approve docs/llm-wiki/domains/billing.md --reviewer maintainer
- approved: 1
- refused: 0

## Approved (-> verified)
- docs/llm-wiki/domains/billing.md: verified (reviewed_by maintainer)
exit 
$ npx llm-wiki impact --since main --mode strict
- result: pass
- governance_mode: strict
- impacted_verified_docs: 0

## Documents to re-review
- none
exit 0
문장이 참인지 확인하지 않습니다

인용이 해석되는지만 확인합니다. 문장이 맞는지는 여전히 검토자가 판단합니다. 숫자를 틀리게 고친 문서도 통과할 수 있습니다.

누가 승인했는지 증명하지 못합니다

reviewed_by는 승인 명령에 넘긴 이름입니다. 에이전트 이름을 agentReviewers에 등록하면 통계에서 따로 셉니다.

문서를 대신 써 주지 않습니다

CLI는 뼈대를 만들고, 검사하고, 프롬프트를 출력합니다. 내용은 사람이나 에이전트가 씁니다. README에 기록된 작은 실험(외부 저장소 1개, 모델 1개, 과제 6개)에서는 채우지 않은 위키가 위키가 없을 때보다 결과가 나빴습니다.

변경 감지는 대부분 파일 단위입니다

줄 범위와 Markdown 섹션 인용만 영역 단위로 좁혀집니다. 날짜 기반 drift는 승인한 날 커밋된 변경을 보지 못할 수 있습니다.

계획 승인은 구현 승인이 아닙니다

요구사항 문서를 승인하면 계획을 승인한 것입니다. impact.plan_changed는 다시 볼 파일을 알려 줄 뿐, 코드가 요구사항을 충족한다는 것을 보여 주지 않습니다.

의미 검색도, 호스팅 서비스도 아닙니다

검색은 BM25 키워드 순위입니다. 임베딩이나 색인 서비스는 없고, CLI는 스스로 네트워크 요청을 보내지 않습니다.

OPEN SOURCE. OPEN TO YOUR NEXT CHANGE.

다음 변경을 위한 연결.

MIT 라이선스로 공개된 무료 도구이고, 개인 개발자가 유지보수합니다. 버그 제보와 질문은 GitHub에 남겨 주세요.

소스 저장소 ↗문서 ↗처음으로 ↑