DV
Doc Versioning Discipline
🔵 Stable🕐 updated 2026-07-19
🔷 SkillSpec L3
pm-cowork
Keep living documents trustworthy over time — the status header (draft/active/superseded) that tells readers what they're holding, the change-log-for-decisions inside the doc, the supersession chain that kills zombie versions, and the review-date heartbeat. Use when asked which version of this doc is current, our wiki is full of stale pages, set up doc lifecycle rules, or people keep following the old process doc. Produces the status-header standard, the in-doc change log, the supersession protocol, and the staleness heartbeat.
What to give it
▸The doc population — what kinds of living docs (processes, policies, onboarding, architecture) and roughly how many; discipline scales to the estate, and a 30-doc wiki needs less machinery than a 3,000-page one
▸The pain, specifically — people following stale docs? Can't tell draft from decided? Two versions warring? The protocol emphasizes its actual complaint
▸The platform's powers — does the wiki support labels, ownership fields, redirects? The standard uses native features where they exist and header text where they don't
▸The owners' reality — who will actually review docs on the heartbeat; unowned discipline is a decree awaiting decay
✅ The bar it holds itself to
Every skill in this library self-verifies — these are this skill's own quality checks, straight from its definition.
✓Every living doc class is covered by the header standard
✓Change logs capture decisions with whys, not typo noise
✓Superseded docs point forward and inbound links were redirected
✓Drafts are labeled and out of main navigation
✓The heartbeat has cadences, a flag, and a sweep owner
⚠️ What it refuses to do
Do not rely on file dates as status — modified-yesterday says nothing about trustworthy-today
Do not delete superseded docs silently — broken links teach people to hoard copies, restarting the chaos
Do not log typos in the change log — noise trains readers to skip the signal
Do not let drafts share shelf space with actives — escaped drafts are the stealthiest wrong docs
Do not install the discipline without the sweep — headers without heartbeats are just prettier rot
Install
npx pm-claude-skills add --agent claude # or codex · cursor · gemini · hermes
# or one-line MCP (every skill, any client):
claude mcp add pm-skills -- npx -y pm-claude-skills-mcp
Related skills
🔌 Embed this skill
Drop this on your blog, docs, or site — it renders a "Run this skill" card:
<div data-pm-skill="doc-versioning-discipline"></div>
<script src="https://mohitagw15856.github.io/pm-claude-skills/embed.js" async></script>
💬 Discussion
Doc Versioning Discipline is one of 743 open-source professional AI agent skills — all SkillSpec L3.
Try them all in the browser · ⭐ Star on GitHub · Browse the full catalog