design

Define architecture decisions, component decomposition, and interface contracts for software projects.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture decisions, component decomposition, and interface contracts are defined and traced to support SDLC governance.

Core Features & Use Cases

  • Stepwise design workflow from open questions to decisions, with persistence in design docs.
  • Supports component decomposition, interface contracts, and shared-state planning across modules.
  • Provides governance through DEC records, design validation steps, and traceability.

Quick Start

Run /gse:design to begin architecture design for the current sprint and generate the design artefact.

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 software projects?

To document architecture decisions, use a stepwise design workflow that captures open questions, records decisions as DEC records, and persists them in structured design docs. This process ensures traceability and governance across your software development lifecycle.

What is component decomposition and interface contract planning?

Component decomposition and interface contract planning involve breaking down system modules and defining shared-state boundaries across microservices. This creates structured specifications that guide system integration and architecture governance.

Can I use this for sprint planning and design reviews?

Yes, you can use this for sprint planning and design reviews. It applies to both CLI and agent-based workflows, providing design validation steps and gate-based decisions to support architecture governance during these activities.

How do I create a decision journal for microservices integration?

Create a decision journal for microservices by running the design workflow to generate design artifacts. It captures interface specifications and applies gate-based decisions to trace architecture choices across modules.

Does this work with agent-based workflows and CLI environments?

Yes, this works with agent-based workflows and CLI environments. It supports architecture governance and design artifact persistence across both modes, allowing flexible integration into your existing development processes.

What are the limitations of gate-based architecture governance?

Gate-based architecture governance requires strict adherence to design validation steps and DEC records. While it ensures traceability, it may introduce overhead for smaller projects that do not need structured decision journals or complex interface specifications.