sync-docs
Check Pieceful docs, ADRs, roadmap, task board, and code for drift or contradictions and report them. Use for /sync-docs or before a milestone checkpoint.
SKILL.md.claude/skills/sync-docs/SKILL.md
GitHub/sync-docs: find drift
- Compare:
- requirements ↔ feature specs: every F-xx has a spec or a "not written" entry
- feature specs ↔ tasks ↔ roadmap: milestones and statuses agree
- ADRs ↔ docs: accepted decisions are reflected; nothing contradicts them
- docs ↔ code (from M0): structure, commands, API, data model
- links: every relative link resolves
- public voice: no personal or raw notes in public docs
- Report a short list:
file: problem → suggested fix. Most severe first. - Fix only after the owner agrees, and only what they approve. Don't commit.