How does it track unanswered technical questions?

The skill maintains a Question Tracking System within an analysis-state.md file, categorizing questions by technical, process, scope, and stakeholder impact.

What is the SEAMS analysis framework?

SEAMS is a systematic lens used by this skill to evaluate Structure, Execution, Assumptions, Mismatches, and Stakeholder perspectives within your project documentation.

Can this skill handle large, multi-domain projects?

Yes, the skill features a 'Complex Mode' specifically designed for multi-domain specs, generating hierarchical A-Spec and B-Spec documents with full traceability.

What kind of output does the Specification Refiner produce?

Depending on the complexity, it produces refined specification documents (Draft status), traceability matrices, and a comprehensive analysis state file.

Does it require manual confirmation at each step?

Yes, the skill uses a 'Gate' system requiring user approval after each phase (Ingest, Analyze, Present, etc.) to ensure the AI's understanding aligns with your goals.

Specification Refiner

Name: Specification Refiner
Author: ddunnock

byddunnock

•

Productivity & Workflow

Refines project specifications, architectural designs, and requirements through systematic gap analysis and iterative validation.

About

The Specification Refiner is a comprehensive tool designed to transform ambiguous project plans and architectural designs into production-ready specifications. By employing structured analysis frameworks like SEAMS (Structure, Execution, Assumptions, Mismatches, Stakeholders) and Critical Path Analysis, it identifies hidden risks, technical assumptions, and architectural mismatches. Whether managing simple single-domain documents or complex multi-domain hierarchies, this skill ensures full traceability and stakeholder alignment through a rigorous 7-phase workflow that includes iterative feedback loops and persistent state management.

Key Features

Automated generation of A-Spec and B-Spec document hierarchies
Persistent analysis state tracking and question management
1 GitHub stars
Dual-framework analysis using SEAMS and Critical Path methodologies
Requirements Traceability Matrix (RTM) generation for complex projects
Multi-mode processing tailored to document complexity

Use Cases

Reviewing initial product requirements to identify edge cases and technical blockers
Auditing complex project plans for dependency bottlenecks and single points of failure
Validating architectural designs against implementation constraints and assumptions

About

Key Features

Automated generation of A-Spec and B-Spec document hierarchies
Persistent analysis state tracking and question management
1 GitHub stars
Dual-framework analysis using SEAMS and Critical Path methodologies
Requirements Traceability Matrix (RTM) generation for complex projects
Multi-mode processing tailored to document complexity

Use Cases

Reviewing initial product requirements to identify edge cases and technical blockers
Auditing complex project plans for dependency bottlenecks and single points of failure
Validating architectural designs against implementation constraints and assumptions