PlaygroundCatalog › Doc Versioning Discipline
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.

▶ Run it free — no key needed 📝 Grade your existing draft View SKILL.md ↗

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