Pko89403 Zeroalign Rec Docs Manager

docs-manager

Graphify-first 지식 레이어(graphify-out/)와 human-owned source corpus(raw/), 그리고 저장소 루트 문서/하네스 진입점(README.md, AGENTS.md, .github/copilot-instructions.md, .agents/policies/local-adaptation.md, .agents/skills/graphify-manager/SKILL.md)을 함께 관리하는 스킬이다.

When to Use

• raw/ 아래 설계 source, ADR, 외부 문서를 추가/정리할 때
• graphify-out/GRAPH_REPORT.md를 검토해 하네스/README 반영이 필요한지 점검할 때
• verified full refresh 결과를 루트 graphify-out/로 동기화할 때
• 코드/CLI/워크플로 변경 후 사용자-facing 문서와 하네스 규칙을 한 번에 정리할 때

Procedure

Step 0: 스키마 로드

항상 프로젝트 루트의 AGENTS.md를 먼저 읽는다. raw/ source corpus 모델, graphify-out/ generated output, auto-refresh 규칙이 이 파일에 정의되어 있다.

sync/update 작업이라면 추가로 아래 파일을 함께 읽는다.

• raw/README.md
• graphify-out/GRAPH_REPORT.md (존재 시)
• graphify-out/graph.json (존재 시)
• README.md
• .github/copilot-instructions.md
• .agents/policies/local-adaptation.md
• .agents/skills/graphify-manager/SKILL.md

Operation: Raw Source Maintenance

raw/를 Graphify source corpus 관점에서 유지한다.

1. raw/design/adr/에 ADR을 추가하거나 갱신한다
2. raw/design/notes/에 설계 노트/개요를 추가하거나 갱신한다
3. raw/external/에 논문/데이터셋/모델/실험 자료를 정리한다
4. .agents/policies/, .agents/playbooks/는 Graphify source가 아니므로 source corpus와 섞지 않는다

Operation: Graph Sync

Graphify artifact를 재생성하고 committed knowledge layer를 갱신한다.

1. code-only drift면 scripts/graphify_code_refresh.sh를 실행한다
2. raw/ source가 바뀌었거나 full refresh가 필요하면 아래 순서를 사용한다
   • scripts/graphify_prepare_corpus.sh
   • scripts/graphify_full_refresh.py
   • scripts/graphify_verify_full_refresh.py
   • scripts/graphify_sync_staged.sh
3. graphify-out/BUILD_INFO.json의 mode와 verified를 확인한다

Operation: Graph Review

Graphify 산출물을 사람이 읽는 문서와 하네스 규칙에 연결한다.

1. graphify-out/GRAPH_REPORT.md를 읽는다
2. 새 핵심 노드, community, drift를 확인한다
3. 아래 문서 반영이 필요한지 판단한다
   • README.md
   • AGENTS.md
   • .github/copilot-instructions.md
   • .agents/policies/local-adaptation.md
   • .agents/skills/graphify-manager/SKILL.md
   • .github/pull_request_template.md와 PR workflow 문구

Operation: Sync

코드/CLI/워크플로 변경 뒤 문서와 하네스 규칙을 한 번에 동기화한다.

1. 변경 범위를 파악한다
2. raw/와 graphify-out/GRAPH_REPORT.md 사이 드리프트를 확인한다
3. 아래 파일에 새 워크플로/명령/규칙을 반영한다
   • README.md
   • AGENTS.md
   • .github/copilot-instructions.md
   • .agents/policies/local-adaptation.md
   • .agents/skills/graphify-manager/SKILL.md
   • .github/pull_request_template.md 관련 운영 규칙

Quality Checks

• raw/ 구조가 source corpus 역할에 맞게 유지되는가?
• graphify-out/graph.html, GRAPH_REPORT.md, graph.json이 존재하는가?
• README.md, AGENTS.md, .github/copilot-instructions.md, .agents/policies/local-adaptation.md, .agents/skills/graphify-manager/SKILL.md가 raw/ 모델과 일치하는가?
• PR 생성 규칙이 .github/pull_request_template.md 기준과 일치하는가?
• .agents/policies/, .agents/playbooks/가 Graphify source처럼 취급되고 있지 않은가?

Key Conventions

• Source corpus: raw/
• Generated graph: graphify-out/
• Graph refresh entrypoint: scripts/graphify_code_refresh.sh
• Full refresh flow: scripts/graphify_prepare_corpus.sh -> scripts/graphify_full_refresh.py -> scripts/graphify_verify_full_refresh.py -> scripts/graphify_sync_staged.sh

Source: pko89403/ZeroAlign-Rec — distributed by TomeVault.