documentation-nag

Synchronize documentation with code changes using MANIFEST tag indices.

1|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/saxonthune/carta --skill documentation-nag
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation-nag
Source: https://github.com/saxonthune/carta/tree/main/.claude/skills/documentation-nag
Command: npx skills add https://github.com/saxonthune/carta --skill documentation-nag

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents documentation from drifting out of sync with the codebase after changes, so teams and AI agents can trust what the docs say.

Core Features & Use Cases

  • Change-scoped analysis: Uses a dedicated analysis script to identify what changed (by package and new/removed exports/hooks/components) and scopes which docs to verify.
  • Manifest-driven doc mapping: Reads the workspace MANIFEST tag index to map code-change areas to the specific documentation refs that should be checked.
  • Content-based doc-vs-code reconciliation: Reads docs holistically, then spot-checks the corresponding code to detect missing features, outdated behavior, and incomplete tables.
  • Always-on reconciliation: Reconciles barrel-file export tables and MCP tool registrations against what the relevant architecture/tool inventory docs claim, even when Phase 1 didn’t indicate changes.

Quick Start

Use the documentation-nag skill in the Carta workspace to analyze recent code changes, verify the affected .carta documentation via MANIFEST mappings, and generate precise edit instructions (including evidence and section targets) for updating stale docs.

Frequently Asked Questions about documentation-nag

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep documentation synchronized with code changes without relying on git history?

To keep documentation synchronized with code changes, this skill performs content-based detection to identify changed packages, exports, and components, mapping them to relevant doc references via MANIFEST tag indices for accurate verification.

What is the best way to verify documentation claims against actual code behavior?

Verifying documentation claims against code behavior involves reading docs holistically, spot-checking corresponding code, and reconciling barrel-file export tables and MCP tool registrations to detect missing features or outdated behavior.

How do I map changed code exports to specific documentation sections that need updates?

Mapping changed code exports to documentation sections requires reading the workspace MANIFEST tag index, which links code-change areas like new or removed hooks to the specific documentation references that must be checked.

Does documentation synchronization work for reconciling barrel exports and architecture tool inventory docs?

Documentation synchronization explicitly supports barrel export reconciliation by cross-checking barrel-file export tables and MCP tool registrations against architecture and tool inventory docs, even when initial change analysis indicates no modifications.

How do I generate provenance-backed edit instructions for stale repository documentation?

Generating edit instructions for stale repository documentation involves structured gap reporting that provides precise section targets and evidence-backed instructions for updating outdated docs based on current code behavior.

When do I need deterministic, evidence-based documentation reconciliation in my workflow?

Deterministic, evidence-based documentation reconciliation is needed in repository maintenance workflows where docs must stay accurate, requiring full-doc reading before section-level validation and content-based detection rather than relying on git history.