docs-stale-check

Community

Detect doc drift before it ships.

Authorgmanch94
Version1.0.0
Installs0

System Documentation

What problem does it solve?

It prevents teams from publishing outdated documentation that no longer matches the current Agora codebase, reducing confusion during onboarding and audits.

Core Features & Use Cases

  • Doc drift punch lists: Generates a line-level set of drift candidates in the specified documentation surfaces instead of rewriting content automatically.
  • Source-of-truth verification: Cross-checks lifecycle states/steps, compensator targets, API endpoints, ADR references, Make targets, module paths, environment variables, and schema fields against the authoritative code locations.
  • Release and PR hygiene: Helps keep PRDs, runbooks, and architecture diagrams aligned after changes to saga, API, agents, models, config, alembic migrations, and CI/workflow expectations.
  • Freshness and status accuracy: Flags missing or stale "Last reviewed against code" headers and incorrect test-count or shipped-vs-planned status narratives.

Quick Start

Use the docs-stale-check skill to scan README and PRD/runbook/architecture documents and produce a punch list of file:line drift candidates.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: docs-stale-check
Download link: https://github.com/gmanch94/agora/archive/main.zip#docs-stale-check

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.