create-solution-design

Produce a structured solution design document for GitHub issues before implementation.

10|2|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/thermiteau/maverick --skill create-solution-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-solution-design
Source: https://github.com/thermiteau/maverick/tree/main/skills/create-solution-design
Command: npx skills add https://github.com/thermiteau/maverick --skill create-solution-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides teams to produce a rigorous, pre-implementation solution design, ensuring alignment, risk awareness, and clear scope before any code is written.

Core Features & Use Cases

  • Structured workflow for GitHub issues and tasks, guiding requirements capture, codebase exploration, affected areas identification, and validation.
  • Reusable design templates and a formal design structure to improve reviewability and reduce rework.
  • Use Case: When starting a task, generate a design document that outlines the approach, dependencies, and acceptance criteria to inform implementation.

Quick Start

Plan the design for a given issue by outlining requirements, exploring the codebase, and listing affected areas before coding.

Frequently Asked Questions about create-solution-design

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

FAQPage Schema
How do I create a solution design document before coding a new feature?

To create a solution design, you capture requirements, explore the codebase, identify affected areas, and validate the approach. This produces a formal design document outlining the approach, dependencies, and acceptance criteria to inform implementation.

What is the best way to plan architecture for GitHub issues before implementation?

Planning architecture for GitHub issues involves a structured workflow of requirements capture, codebase exploration, risk assessment, and validation. This ensures alignment, risk awareness, and clear scope before any code is written.

How do I identify affected codebase areas when starting a software task?

To identify affected codebase areas, you explore the project structure during the solution design phase. This guides the identification of dependencies and affected components, ensuring clear scope and reducing rework before implementation begins.

Does solution design planning work with GitHub task workflows?

Yes, solution design planning applies directly to GitHub issues and tasks. It enforces capturing requirements and producing a formal design document that can be reviewed and used by existing workflows to guide implementation.

Why should I produce a pre-implementation design document for software projects?

Producing a pre-implementation design document ensures alignment, risk awareness, and clear scope before coding. It improves reviewability by providing reusable templates and a formal structure, which reduces rework during implementation.