# Pko89403 Zeroalign Rec Docs Manager > docs-manager - Skill: `tomevault-io/pko89403-zeroalign-rec-docs-manager` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/pko89403-zeroalign-rec-docs-manager` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/pko89403-zeroalign-rec-docs-manager/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/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](https://github.com/pko89403/ZeroAlign-Rec) — distributed by [TomeVault](https://tomevault.io).