dev-investigation

Name: dev-investigation
Availability: InStock
Author: nagasakah

Analyze setup.yaml and design-document to generate investigation reports with UML diagrams.

Updated Feb 8, 2026

Search Tags:#documentation #investigation #uml #design-document #setup.yaml #dev-investigation

Ready to run

npx skills add https://github.com/NagasakaH/dev-process --skill dev-investigation

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: dev-investigation
Source: https://github.com/NagasakaH/dev-process/tree/main/.claude/skills/development/dev-investigation
Command: npx skills add https://github.com/NagasakaH/dev-process --skill dev-investigation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the systematic investigation of development tasks by inspecting setup.yaml and the design-document, producing structured results for each target repository and updating the design document's investigation section.

Core Features & Use Cases

Ingest setup.yaml and design-document to drive repository-wide investigations.
Produce detailed investigation reports with UML diagrams under docs/{target_repo}/dev-investigation/.
Update design-document to reflect investigation results and recommendations.

Quick Start

Feed setup.yaml and the design-document, then run dev-investigation to generate and attach the investigation findings under docs/{target_repo}/dev-investigation and update the design document.

Frequently Asked Questions about dev-investigation

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

FAQPage Schema

How do I automate repository-level investigation for development tasks?▼

Automating repository-level investigation involves reading background context from setup.yaml and analyzing the design-document. This skill systematically inspects these inputs to produce detailed findings and update the design document's investigation section automatically.

Can I generate UML diagrams automatically from a design-document investigation?▼

Yes, generating UML diagrams during an investigation is supported. The skill produces detailed investigation reports under docs/{target_repo}/dev-investigation, which include UML diagrams to visually document the findings and system architecture.

What is the best way to update a design-document with investigation findings?▼

The best way to update a design-document with findings is to systematically process the investigation results and append them to the document's investigation section. This ensures background context and recommendations are structurally captured for future reference.

Do I need a setup.yaml file to perform a systematic development investigation?▼

Yes, a setup.yaml file is required. The investigation process specifically reads description.background from setup.yaml to acquire the necessary repository-level background context before generating findings and updating the design-document.

How does background context from setup.yaml drive the investigation process?▼

Background context from setup.yaml drives the investigation by providing the foundational information needed to systematically analyze the repository. The skill reads this context to ensure generated reports and UML diagrams accurately reflect the development task environment.

Are there limitations when using design-document updates for repository-wide investigations?▼

This approach is limited to repository-level investigations requiring updates to existing design documents. It depends on ingesting setup.yaml and a design-document, making it unsuitable for investigations lacking these predefined structural inputs.