docs-analysis

Analyze project documentation to identify synchronization gaps with code changes.

Updated Feb 27, 2026
One-click install
npx skills add https://github.com/takayatomose/tas-agent-skills --skill docs-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-analysis
Source: https://github.com/takayatomose/tas-agent-skills/tree/main/.agents/skills/docs-analysis
Command: npx skills add https://github.com/takayatomose/tas-agent-skills --skill docs-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures project documentation is systematically read, maintained, and updated so that documentation never lags behind code changes and implementation decisions.

Core Features & Use Cases

  • Context Discovery: Read and summarize files in the docs/ directory to provide business, architecture, and API context before work begins.
  • Documentation Sync: Trace which documentation files are impacted by code changes (APIs, architecture, workflows, schemas) and prioritize updates.
  • Quality Gate: Treat documentation updates as part of the same iteration and mark tasks done only when related docs are verified and updated.

Quick Start

Read and summarize all files under the docs/ directory, identify which documents are affected by the planned code changes, and produce a prioritized list of required documentation updates.

Frequently Asked Questions about docs-analysis

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

FAQPage Schema
How do I keep documentation synchronized with code changes during refactoring?

Documentation synchronization is achieved by tracing links from modified code to files under the docs/ directory, mapping impacted API and architecture documents, and treating required documentation updates as part of the same iteration.

What is documentation context discovery before starting feature work?

Documentation context discovery involves reading and summarizing files under the docs/ directory to extract business, architecture, and API context before beginning feature work or refactoring.

How do I identify which docs need updates when APIs or schemas change?

Identify affected documents by tracing code changes to linked files in the docs/ directory, then prioritize updates based on modified APIs, schemas, workflows, and architecture to ensure technical writing remains accurate.

Can I use a docs directory structure to enforce documentation maintenance as a quality gate?

Yes, you can enforce documentation maintenance as a quality gate by treating documentation updates as part of the same iteration and marking tasks complete only when related docs are verified and updated within the docs directory.

What's the best way to map impacted architecture documentation during code changes?

The best way to map impacted architecture documentation is to analyze the docs/ directory, trace dependencies between modified code and architecture documents, and produce a prioritized list of required documentation updates.

Why does project documentation lag behind implementation decisions after API updates?

Project documentation lags behind implementation decisions when updates are not enforced within the same iteration as API changes, creating synchronization gaps between actual code behavior and written technical context.