design-with-traceability

Generate technical solution architecture tagged with REQ-* identifiers from validated requirements.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/foolishimp/ai_sdlc_method --skill design-with-traceability
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-with-traceability
Source: https://github.com/foolishimp/ai_sdlc_method/tree/main/gemini-code/plugins/design-skills/skills/design-with-traceability
Command: npx skills add https://github.com/foolishimp/ai_sdlc_method --skill design-with-traceability

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Actuator creates a technical solution architecture from validated REQ-* requirements, ensuring traceability across components, APIs, and data models.

Core Features & Use Cases

  • Component Design: Proposes services and modules aligned to requirements.
  • API Contracts: Defines endpoints and interfaces mapped to REQ-*.
  • Data Models: Sketches schemas and relationships with traceability.
  • Traceability: Tags all design artifacts with REQ-* keys.

Quick Start

Design aAuth service architecture that implements REQ-F-AUTH-001 and REQ-NFR-SEC-001 with traceable artifacts.

Frequently Asked Questions about design-with-traceability

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

FAQPage Schema
How do I map requirements to architecture components and APIs?

Map requirements to architecture by generating traceable technical designs that tag all components, APIs, and data models with REQ-* keys. This ensures each architectural element connects explicitly to its source requirement, creating a verifiable chain from business rules through functional and non-functional requirements to implementation artifacts.

What's the best way to maintain traceability across design artifacts?

Maintain traceability by systematically tagging design artifacts—services, endpoints, schemas, and interactions—with REQ-* identifiers linked to validated requirements. This practice prevents design drift, simplifies compliance verification, and makes requirement changes easier to propagate through the architecture.

Can I design APIs and data models from validated requirements?

Yes. From validated REQ-* requirements, you can generate API contracts with traceable endpoint definitions and data model schemas with relationship specifications. Each design artifact receives REQ-* tagging so its origin requirement and coverage are immediately visible.

Do I need requirements validated before starting architecture design?

Yes. This Skill operates on validated REQ-* requirements as input. Pre-validation ensures requirements are complete, consistent, and ready for architecture mapping, preventing rework when non-functional and business-rule requirements emerge during design.

How do functional and non-functional requirements affect component design?

Functional requirements drive service and module boundaries—what the system does. Non-functional requirements (security, performance, scalability) shape component interactions, data model choices, and API contracts. Both are tagged in the resulting architecture so design decisions remain auditable.

What happens if a requirement isn't covered in the architecture?

Uncovered requirements create gaps in traceability. By tagging all components, APIs, and data models with REQ-* keys, missing coverage becomes visible immediately, triggering design iteration or requirement clarification before implementation begins.