11-DOCS-discover

Discover documentation requirements for code changes and produce a docs-outline.md blueprint.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/medtrics/medtrics-acumen --skill 11-docs-discover
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 11-DOCS-discover
Source: https://github.com/medtrics/medtrics-acumen/tree/main/templates/shared/skills/11-DOCS-discover
Command: npx skills add https://github.com/medtrics/medtrics-acumen --skill 11-docs-discover

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the process of identifying what documentation needs to be written or updated for code changes, preventing documentation gaps and ensuring comprehensive coverage.

Core Features & Use Cases

  • Progressive Discovery: Executes three passes to systematically identify documentation targets.
  • Scope Definition: Focuses documentation efforts only on code changed in the current branch.
  • Blueprint Generation: Creates a docs-outline.md file detailing all documentation requirements before writing begins.
  • Use Case: After implementing a new feature, use this Skill to generate a clear plan for writing developer docs, client-facing guides, and updating inline code comments, ensuring nothing is missed.

Quick Start

Run the 11-DOCS-discover skill to generate a documentation outline for recent code changes.

Frequently Asked Questions about 11-DOCS-discover

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

FAQPage Schema
How do I discover what documentation needs updating after code changes?

A documentation discovery process scopes your current branch against main to identify affected features, functions, and tables. It produces a docs-outline.md blueprint detailing all required updates, preventing gaps across developer docs and client-facing guides.

What is a documentation blueprint for developer docs?

A documentation blueprint is a structured outline file that maps all required documentation targets for code changes. It categorizes updates for developer docs, client guides, and inline comments by auditing modified functions and cross-feature flows.

How do I scope documentation efforts to only modified code?

Scoping documentation to modified code involves comparing the current branch against main. This isolates changed feature areas and functions, ensuring documentation efforts target only updated code rather than the entire repository.

What's the best way to audit cross-feature documentation requirements?

Auditing cross-feature documentation requirements requires a progressive three-pass discovery approach. It builds a skeleton outline, expands it with specific function targets, and performs a final cross-feature audit to map interconnected flows comprehensively.

Can I generate a documentation outline for inline code comments and client guides?

Yes, a documentation outline can target inline code comments, client-facing guides, and developer docs simultaneously. The discovery process identifies specific documentation categories required across all affected code changes on your branch.

When do I need a documentation discovery process for code changes?

You need a documentation discovery process after implementing new features or modifying code on a branch. It prevents documentation gaps by generating a comprehensive blueprint of required updates before any writing begins.