skills.rest
ddunnock
ddunnockCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

specification-refiner

Analyze and refine specifications using the SEAMS gap-analysis framework.

10|5|Updated Jan 2, 2026
Search Tags:#architecture#specification#requirements#clarification#traceability#gap-analysis#SEAMS
One-click install
npx skills add https://github.com/ddunnock/claude-plugins --skill specification-refiner
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: specification-refiner
Source: https://github.com/ddunnock/claude-plugins/tree/main/skills/specification-refiner
Command: npx skills add https://github.com/ddunnock/claude-plugins --skill specification-refiner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) and references (resource) components.

What problem does it solve?

The Specification Refiner helps teams systematically analyze, validate, and refine complex specifications, architectures, and plans by exposing gaps, ambiguities, and misalignments early in the lifecycle.

Core Features & Use Cases

  • SEAMS-guided gap analysis: Structure, Execution, Assumptions, Mismatches, and Stakeholders are analyzed to surface gaps.
  • Sequential Clarification: Phase-by-phase questioning to reduce cognitive load and preserve persisting context across iterations.
  • Multi-domain coverage: Supports cross-domain requirements, tracing, and phased refinement with an auditable history.
  • Use Case: Given a draft spec, run a multi-phase analysis to generate A-Spec artifacts, with optional B-Spec generation and traceability.

Quick Start

To start, load a specification, trigger Phase 0 ASSESS, and follow the CLARIFY prompts. The system will guide you through ingestion, analysis, clarification, presentation, iteration, synthesis, and validation.

Frequently Asked Questions about specification-refiner

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

FAQPage Schema
How do I find gaps and ambiguities in a complex software specification?▼

Specification refinement uses the SEAMS gap-analysis framework to analyze Structure, Execution, Assumptions, Mismatches, and Stakeholders, systematically surfacing hidden misalignments early in the lifecycle.

What is the SEAMS framework for requirements clarification?▼

The SEAMS framework for requirements clarification analyzes Structure, Execution, Assumptions, Mismatches, and Stakeholders. It uses sequential, phase-by-phase questioning to reduce cognitive load and maintain traceability across iterations.

How do I generate traceable A-Spec and B-Spec artifacts from a draft architecture plan?▼

Generate traceable A-Spec and B-Spec artifacts by loading a draft plan into a phased specification refiner. Trigger Phase 0 ASSESS, follow the sequential CLARIFY prompts, and synthesize the outputs to maintain an auditable history.

Does specification refinement work for cross-domain requirements tracing?▼

Specification refinement supports cross-domain requirements tracing by using persistent memory to maintain context across iterations, systematically analyzing multi-domain coverage to expose gaps and validate alignment.

Can I integrate knowledge MCP for standards grounding during specification analysis?▼

You can integrate a knowledge MCP for standards grounding during specification analysis when available. This integration anchors the gap-analysis framework to established standards while outputting validated draft artifacts.

What is the best way to maintain context during phased architecture validation?▼

The best way to maintain context during phased architecture validation is using a refiner with persistent memory. It preserves context across iterations from ASSESS through VALIDATE, ensuring sequential clarification reduces cognitive load.

Related Skills

Explore More Software Engineering Skills→
Orda-by-MoveOrda-by-Move

lab-init

Generates configuration and baseline tracking files for new webnovel projects.

Official
Advanced
mistakeknotmistakeknot
3

interpath

Generate product artifacts from project state, issue trackers, and Git history.

Community
Advanced
wesuuuwesuuu

gap_analysis

Analyze Runbook app capabilities against industry benchmarks and output prioritized GAP_ANALYSIS.md.

Community
Advanced
macaughmacaugh
5

Static Vulnerability Analysis

Detects injection, memory safety and authorization flaws in multiple languages.

Community
Advanced