write-solution

Generate arc42-lite solution.md documents with ADR references and graduation criteria.

1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/daddia/space --skill write-solution
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-solution
Source: https://github.com/daddia/space/tree/main/.agents/skills/write-solution
Command: npx skills add https://github.com/daddia/space --skill write-solution

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill generates a structured architecture solution document that communicates system context, quality goals, building blocks, data contracts, cross-cutting concepts, and architectural decisions for a domain or platform.

Core Features & Use Cases

  • Structured output: produces a complete arc42-lite style solution.md with sections §1–§11 tailored to the target scope.
  • Stage flexibility: supports stub (Phase 0) and full (Phase 2+) modes, enabling rapid scaffolding or production-grade documentation.
  • ADR integration: references architectural decisions and provides placeholders for not-yet-written ADRs.

Quick Start

Provide the target domain or product and select the stub or full stage to generate a ready-to-commit architecture solution document.

Frequently Asked Questions about write-solution

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

FAQPage Schema
How do I generate an architecture solution document for a new domain?

To generate an architecture solution document, provide the target domain or product and select a stub or full stage to produce a structured solution.md aligned with arc42-lite sections and ADR references.

What is the arc42-lite structure for solution design documentation?

The arc42-lite structure for solution design maps system context, quality goals, building blocks, data contracts, and cross-cutting concepts across sections §1–§11, integrating architectural decision records within the solution document.

Can I create a stub architecture document for early phase project scaffolding?

Yes, you can create a stub architecture document by selecting Phase 0 mode, which enables rapid scaffolding of solution design with placeholders for not-yet-written ADRs and incomplete coverage.

How do I document architecture decisions and boundaries in a solution.md file?

You document architecture decisions and boundaries by generating a frontmatter-enriched solution.md that provides a complete narrative mapping constraints, graduation criteria, and references to specific architectural decisions.

When should I use full phase mode instead of stub mode for architecture documentation?

Use full phase mode when you need production-grade architecture documentation with complete coverage of building blocks and data contracts, whereas stub mode suits early Phase 0 rapid scaffolding with placeholder ADRs.

Does the solution document generator support both domain-level and product-level scopes?

Yes, the solution document generator supports both domain-level and product-level scopes, producing tailored arc42-lite structured output that aligns architecture decisions and constraints to the specified target scope.