design

Document architecture decisions and component interfaces for GSE-One sprints.

4|1|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/nicolasguelfi/gensem --skill design-nicolasguelfi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design
Source: https://github.com/nicolasguelfi/gensem/tree/main/gse-one/plugin/skills/design
Command: npx skills add https://github.com/nicolasguelfi/gensem --skill design-nicolasguelfi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design decisions and architecture governance for the GSE-One plugin, ensuring consistent interfaces, scalable components, and traceable decisions across sprints.

Core Features & Use Cases

  • Scope analysis guidance to identify components and cross-cutting concerns.
  • Component decomposition and explicit interfaces to prevent architectural drift.
  • DEC-based decision recording to capture rationale and traceability for future audits.

Quick Start

Run the GSE-One design workflow to draft an architecture plan for the current sprint.

Frequently Asked Questions about design

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

FAQPage Schema
How do I document architecture decisions for a sprint?

To document architecture decisions for a sprint, use a DEC-based governance approach to capture rationale and traceability. This ensures design constraints like non-circular dependencies and security considerations are recorded for future audits.

What is component decomposition and how does it prevent architectural drift?

Component decomposition is the process of breaking down system modules into explicit interfaces and boundaries. It prevents architectural drift by defining clear interactions and enforcing design constraints like avoiding shared state across components.

How do I analyze scope and identify cross-cutting concerns for module design?

Scope analysis identifies components and cross-cutting concerns by evaluating sprint requirements. It guides the breakdown of modules into explicit interfaces and DEC records, ensuring all dependencies and security considerations are traceable.

Can I use this for sprint-level design activities across multiple modules?

Yes, this approach is applicable to sprint-level design activities across modules. It guides scope analysis, component breakdown, interface definition, and traceable DEC records while persisting artifacts in designated directories.

What are the limitations of using DEC-based governance for design constraints?

DEC-based governance requires strict adherence to enforced design constraints, including non-circular dependencies and shared state limitations. It may not suit projects lacking clear module boundaries or those needing rapid, unrecorded architectural changes.

Why does architecture governance require persisting artifacts in specific directories?

Architecture governance requires persisting artifacts in specific directories to maintain traceability and ensure design decisions are accessible for future audits. This practice enforces consistent interfaces and scalable components across sprints.