# Documentation Sync Loop

> Documentation Sync Loop. Goal: keep docs truthful — no drift between code and the docs/guardrails that agents rely on.

- Skill: `andersonlimahw/documentation-sync-loop` (Agent Skill)
- Install (CLI): `npx skillmds@latest add andersonlimahw/documentation-sync-loop`
- Raw SKILL.md: https://api.skillmd.com/api/skills/andersonlimahw/documentation-sync-loop/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: Andersonlimahw (https://skillmd.com/u/andersonlimahw)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/andersonlimahw/documentation-sync-loop

---


# Documentation Sync Loop

**Goal:** keep `docs/` truthful — no drift between code and the docs/guardrails that agents rely on.
**Cadence:** per merge / weekly.

## Phase 0 · IDEA
- Detect drift via git logs and `/graphify` comparing changed modules vs their docs.
- Candidate drifts: new repositories with no rules, renamed folders, outdated guardrails.
- **verify:** concrete list of drifted docs.

## Phase 1 · PLAN
- Inline plan: list `<doc path> → <action>`.
- **verify:** mapped to concrete actions.

## Phase 2 · IMPLEMENT
- Use `llm-wiki-curator` to enforce LLM-wiki standards (front-matter on all .md, regenerate llms.txt).
- Update specific rules/guardrails that drifted.
- **verify:** valid front-matter on touched docs; `llms.txt` generated.

## Phase 3 · TEST
- Validate link and structure integrity.
- Run `rtk npm run build:docs`.
- **verify:** zero broken links; docs build succeeds.

## Phase 4 · QUALITY GATE
- `rtk npm run build:docs` must pass (mirrors CI).
- **verify:** docs build green.

## Phase 5 · SHIP
- Create PR: "docs: weekly sync".
- Check CI jobs.
- **verify:** CI green (esp. Build Documentation).

## Phase 6 · REFLECT
- Append to `ITERATION_LOG.md`: which docs drifted and why.
- If same doc keeps drifting, create a hook or reminder (Never-Repeat).
- **verify:** recurring drift sources flagged for automation.