refine-solution

Refines solution architecture documents based on sprint notes and design documents.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Refines and updates the solution architecture document to reflect what was built during a sprint and to close gaps between design and implementation.

Core Features & Use Cases

  • Align solution.md with sprint outcomes by updating sections §4–§10, recording changes, and logging risks and ADRs.
  • Incorporate sprint artifacts (sprint notes, ADRs, design packages) to keep the architecture narrative accurate.
  • Provide a concise refinement session summary to capture changes and decisions.

Quick Start

Apply the refinement to the current solution.md using the latest sprint notes.

Frequently Asked Questions about refine-solution

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

FAQPage Schema
How do I update a solution architecture document after a sprint?

To update a solution architecture document after a sprint, refine sections like the building-block view, runtime view, and data model using sprint notes and design packages. This aligns the architecture narrative with actual sprint outcomes.

What is solution architecture refinement and when should I apply it?

Solution architecture refinement is the process of updating the design document to reflect what was built. Apply this refinement at the end of a sprint, phase, or epic to close gaps between the initial design and implementation.

How do I log new architecture decisions and risks after a development phase?

To log new architecture decisions and risks after a development phase, append entries to the ADR log and risk register within the solution document. This captures changes made during the sprint and records associated technical decisions.

Can I use sprint notes to update my building-block and runtime views?

Yes, you can use sprint notes to update building-block and runtime views. The refinement workflow incorporates sprint artifacts to keep the architecture narrative accurate by applying changes across sections §4 through §10.

What is the best way to track architecture changes across multiple sprints?

The best way to track architecture changes across multiple sprints is to enforce a five-step refinement workflow at the end of each sprint. This updates the document version and appends a refinement session summary to track historical changes.

Do I need a design package to refine my solution architecture?

You need sprint notes and design documents to refine your solution architecture effectively. These artifacts provide the necessary implementation details to update the frontmatter, data model, and risk register accurately.