convez.ai
Skill
SwiftyJourney

requirements-engineering-skill

SwiftyJourney/requirements-engineering-skill

Ver no GitHub
InicialPluginScore · de 0 a 100

Turn vague requirements into testable specs: BDD narratives, use cases, payload contracts, flowcharts, and dependency diagrams - Agent Skill

Instalação

$npx convez-ai SwiftyJourney/requirements-engineering-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
6
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

Requirements Engineering Agent Skill

License: MIT Agent Skills

A Claude Code skill that transforms vague or incomplete requirements into well-defined, testable specifications using BDD, Use Cases, Model Specs, Payload Contracts, flowcharts, and architecture diagrams.

Who is this for?

Anyone who encounters vague requirements and needs to transform them into implementable specifications:

  • Product Managers defining feature requirements
  • Software Teams bridging business and technical needs
  • Developers needing clear specs before writing code
  • Technical Writers structuring project documentation

Installation

Install via skills.sh:

npx skills add SwiftyJourney/requirements-engineering-skill

Compatible Agents

What the Skill Covers

The 7 Feature Specification Artifacts

Every feature specification includes these artifacts:

  1. BDD Narrative — Define who, what, why per user type
  2. Acceptance Criteria — Given/When/Then scenarios
  3. Use Cases — Step-by-step system behavior (Data/Primary/Error/Cancel)
  4. Model Specs — Property/Type tables for domain entities
  5. Payload Contract — HTTP method + path + response JSON
  6. Flowchart — Decision flow with error branches
  7. Architecture Diagram — Module dependency graph

The 6-Step Process

  1. Identify — Recognize vague requirements
  2. Clarify — Ask Who/What/Where/When/Why/How
  3. Specify BDD — Write narratives and acceptance criteria
  4. Define Use Cases — Procedural steps with cancel courses
  5. Model & Contract — Property/Type tables and JSON payloads
  6. Visualize & Document — Diagrams and feature specification

Key Patterns

  • Cancel courses — First-class cancellation requirements for async operations
  • Separation of concerns — Extract focused use cases (Load vs Validate vs Cache)
  • Domain language alignment — Consistent terminology across all artifacts
  • Incremental feature development — Self-contained feature blocks
  • Living specification — Requirements evolve with code

Skill File Structure

requirements-engineering/
├── SKILL.md                             # Hub + diagnostic table + gotchas + reference router
└── references/
    ├── bdd-narratives.md                # BDD stories, narratives, acceptance criteria
    ├── use-cases.md                     # Use case structure, courses, CQS, separation of concerns
    ├── model-specs-and-contracts.md     # Model specs, payload contracts, abstract core, JSON examples
    ├── diagrams.md                      # Flowcharts, four-type dependency notation, architecture, state
    ├── domain-language.md               # Terminology alignment, ubiquitous language, renaming
    └── feature-specification-workflow.md # End-to-end workflow, traceability
evals/                                   # Trigger eval queries + output-quality test cases

Related Skills

  • iOS Architecture Expert — Clean modular architecture: composition root, protocol boundaries, generic presenters, Swift 6 concurrency
  • SwiftUI Expert — SwiftUI view code: state, composition, performance, animations, accessibility
  • SwiftUI ⇄ UIKit Interop — Bridge SwiftUI and UIKit: hosting controllers, representables, data across the boundary
  • Swift Language Expert — Non-obvious Swift language & standard-library techniques

Credits

Requirements methodology and artifact format distilled from a real-world iOS case study (an image-feed app) whose README documents the canonical BDD narratives, use cases, payload contracts, and dependency diagrams.

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados