Analyst Skill

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"