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.