analyst

Transform vague requirements into proposal.md, spec.md, and task plans.

4|1|Updated Oct 8, 2025
One-click install
npx skills add https://github.com/deMGoncalves/documentation-first-approach --skill analyst-demgoncalves
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analyst
Source: https://github.com/deMGoncalves/documentation-first-approach/tree/main/.claude/skills/analyst
Command: npx skills add https://github.com/deMGoncalves/documentation-first-approach --skill analyst-demgoncalves

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Analyst Skill translates ambiguous change requests into structured planning artifacts, enabling predictable discovery, specification, and validation.

Core Features & Use Cases

  • Proposal generation: Create a formal change proposal outlining rationale, scope, and breaking changes.
  • Plan & criteria: Produce a detailed .agent-task.md and SMART scope with acceptance criteria.
  • Specification alignment: Ensure outputs map to Arc42/C4/BDD standards and reference relevant specs.

Quick Start

To begin, submit a clear requirement to the Analyst and request a Phase 1 plan. The tool will output a proposal.md, a .agent-task.md, and guidance for SMART scoping and validation.

Frequently Asked Questions about analyst

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

FAQPage Schema
How do I turn vague software requirements into a concrete task plan?

To turn vague requirements into a concrete task plan, you submit the proposed change to generate a formal proposal and a detailed .agent-task.md file. This process produces structured planning artifacts with SMART scope and acceptance criteria.

What is the best way to generate a formal change proposal with Arc42 and C4 alignment?

Generating a formal change proposal with Arc42 and C4 alignment involves analyzing proposed changes during the specification phase. This produces a machine-readable proposal.md that ensures traceability to architectural standards.

Can I use this process to validate specifications using BDD standards?

Yes, you can validate specifications using BDD standards through the final health assessment phase. The process ensures outputs map to BDD standards and reference relevant specs for traceability.

How do I start the discovery phase for an ambiguous change request?

To start the discovery phase for an ambiguous change request, submit a clear requirement and request a Phase 1 plan. The tool outputs a proposal.md, a .agent-task.md, and guidance for validation.

What outputs should I expect from software specification and planning?

From software specification and planning, you should expect a proposal.md, a .agent-task.md, and a final health assessment. These machine-readable outputs outline rationale, scope, and breaking changes.

Does this approach work without external dependencies for requirement analysis?

Yes, this approach works without external dependencies for requirement analysis. The process operates independently to transform ambiguous change requests into structured documentation and validation artifacts.