skills.rest
daddia
daddiaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

refine-docs

Promote sprint-end design decisions to ADRs and generate a refine-session file.

1|Updated Apr 25, 2026
Search Tags:#architecture#documentation#refinement#adr#sprint-end#solution.md#refine-session
One-click install
npx skills add https://github.com/daddia/space --skill refine-docs-daddia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refine-docs
Source: https://github.com/daddia/space/tree/main/.agents/skills/refine-docs
Command: npx skills add https://github.com/daddia/space --skill refine-docs-daddia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams conduct a focused sprint-end documentation pass by promoting design decisions into durable ADR records and generating a refine-session that captures outcomes and decisions.

Core Features & Use Cases

  • ADR triage: identify candidate design decisions that deserve formal documentation and traceability.
  • Solution.md updates: integrate promoted ADRs into the prescribed ADR log and align with existing architecture records.
  • Design archival: clean up WP-local design sections by archiving superseded content with audit-friendly references.

Quick Start

Promptly run the refine-docs workflow on the current work package to generate a refine-session.md and update the associated solution.md and ADR artifacts.

Frequently Asked Questions about refine-docs

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

FAQPage Schema
How do I promote sprint-end design decisions into formal ADRs?▼

To promote sprint-end decisions into ADRs, this skill triages design candidates, integrates them into the ADR log, and updates solution.md. It also archives superseded design sections with audit-friendly references and outputs a refine-session file capturing work package outcomes.

What is the best way to archive superseded design sections after a sprint?▼

Archiving superseded design sections requires preserving archival comments and generating audit-friendly references. This skill cleans up work package-local design sections during a sprint-end pass, ensuring superseded content is moved while maintaining traceability.

How does a refine-session capture sprint outcomes and ADR changes?▼

A refine-session captures outcomes by recording promoted ADRs, solution.md updates, and work package scope. The skill generates this file using Read, Write, Glob, and Grep tools to execute actions, ensuring all sprint-end decisions and archival references are formally documented.

Do I need an existing solution.md file to run ADR triage and refinement?▼

An existing solution.md is required to integrate promoted ADRs into the prescribed log and align with existing architecture records. The skill updates this file directly during the sprint-end pass, archiving superseded design sections with audit-friendly references.

Can I use this documentation refinement workflow for any work package scope?▼

This workflow applies to any work package scope at the end of a sprint or work cycle. It triages ADR candidates, updates solution.md, and outputs a refine-session file that explicitly references the work package scope, ensuring sprint-end documentation remains accurate.

Related Skills

Explore More Design & Creative Skills→
daddiadaddia
1

write-adr

Create ADR-NNNN.md files from solution.md with a provided template.

Community
Advanced
Happy-Technologies-LLCHappy-Technologies-LLC
34

adr-summarization

Summarize Architecture Decision Records from ServiceNow into executive-ready narratives.

Official
Advanced
JiliarJiliar
1

okr-sprint-alignment

Maps quarterly OKRs to backlog items and sprint goals.

Community
Advanced
harishgovardhandamodarharishgovardhandamodar

documentation-and-adrs

Record architectural decisions and project documentation with ADR templates and verification checklists.

Community
Basic