skills.rest
deMGoncalves
deMGoncalvesCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

Analyst Skill

Generates architectural blueprints and project plans from natural-language inputs.

4|1|Updated Oct 8, 2025
Search Tags:#specification#project planning#requirements analysis#ADR#BDD#C4 model#Arc42#system health
One-click install
npx skills add https://github.com/deMGoncalves/arq-specs-template --skill analyst-skill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Analyst Skill
Source: https://github.com/deMGoncalves/arq-specs-template/tree/main/.claude/skills/analyst
Command: npx skills add https://github.com/deMGoncalves/arq-specs-template --skill analyst-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the initial discovery and detailed specification phases of a project, ensuring that requirements are clearly understood, scope is well-defined, and detailed specifications (BDD scenarios, architectural views) are created systematically. It prevents ambiguity and rework by establishing a solid foundation.

Core Features & Use Cases

  • Requirements Analysis & Proposal Creation: Understands the "why" and "what" of a proposed change, assesses its complexity (LOW/MEDIUM/HIGH), identifies breaking changes, and generates a proposal.md document.
  • Detailed Specification (Arc42 + C4 + BDD + ADR): Creates comprehensive spec.md documents, adapting the Arc42 structure based on complexity, incorporating C4 diagrams, BDD scenarios (Given-When-Then), and Architecture Decision Records (ADRs).
  • System Health Assessment: Evaluates the system for "deterioration signals" (rigidity, fragility, immobility, viscosity) to identify potential architectural issues early.
  • Use Case: When a new feature is proposed, this Skill first creates a proposal.md to clarify the problem and assess complexity. If approved, it then generates a detailed spec.md with BDD scenarios and architectural views, providing a clear blueprint for development.

Quick Start

To initiate the planning phase for a new feature: @skill analyst "Adicionar validação de CPF no cadastro de usuários"

Frequently Asked Questions about Analyst Skill

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

FAQPage Schema
How do I create a requirements specification with BDD scenarios and architectural views?▼

Requirements specifications combine behavior-driven development (BDD) with architectural documentation. This Skill generates spec.md documents using Arc42 structure, C4 diagrams, and Given-When-Then scenarios to create a comprehensive blueprint that bridges business requirements and system design.

What's the best way to assess project scope and identify risks during discovery?▼

During discovery, analyze proposals for complexity (LOW/MEDIUM/HIGH), breaking changes, and requirements clarity. This Skill evaluates scope systematically, assesses risks, and produces proposal.md artifacts that define SMART goals and acceptance criteria before detailed specification begins.

How do I detect architectural deterioration in my system early?▼

System health assessment identifies deterioration signals—rigidity, fragility, immobility, and viscosity—that indicate architectural issues. Evaluating these patterns early prevents technical debt accumulation and guides specification decisions for new features.

Can I use Architecture Decision Records (ADRs) within my specification workflow?▼

Yes. ADRs document architectural decisions and trade-offs systematically. This Skill integrates ADRs into spec.md during the specification phase, ensuring decisions are explicit, traced, and available for future reference alongside BDD scenarios and C4 models.

What's the difference between the proposal phase and specification phase?▼

Phase 1 (proposal) clarifies the problem, assesses complexity, and generates proposal.md to gain approval. Phase 3 (specification) produces detailed spec.md with BDD scenarios, Arc42 documentation, C4 diagrams, and ADRs, creating the development blueprint.

Do I need to maintain rules files to use this Skill effectively?▼

Yes. The Skill references .claude/rules and existing specifications to maintain consistency and context. These rules files ensure specifications align with project standards and reduce rework during implementation.

Related Skills

Explore More Product & Management Skills→
rpelizzarpelizza

pelizzai-domain-modeling

Maps project-specific domain logic and architectural constraints for AI agents.

Community
Intermediate
wfukatsuwfukatsu
5

generate-test-specs

Generate Markdown/JSON test specs from design artifacts in reports/06_implementation.

Community
Advanced
Imad-OuteImad-Oute
2

mh-cto-sdlc-acceptance-test-suite

Design BDD-style acceptance test suites from user-defined criteria.

Community
Advanced
GDSDNGDSDN
3

brownfield-create-story

Consolidate scattered documentation into implementation-ready stories with acceptance criteria and risk assessments.

Community
Advanced