Architect Refinement Skill

Refine software user stories with architectural patterns and ready/done criteria.

1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/michsindlinger/specwright --skill architect-refinement-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Architect Refinement Skill
Source: https://github.com/michsindlinger/specwright/tree/main/.claude/skills/architect-refinement
Command: npx skills add https://github.com/michsindlinger/specwright --skill architect-refinement-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a structured approach to the technical refinement of user stories, ensuring architectural consistency and adherence to project standards.

Core Features & Use Cases

  • Technical Refinement: Guides the process of analyzing requirements, defining architectural patterns, and specifying implementation details (WAS/WIE/WO).
  • Definition of Ready/Done: Establishes clear criteria for when a story is ready for development and when it is considered complete.
  • Architecture Standards: Documents and enforces layered architecture principles and naming conventions.
  • Use Case: When a new feature is proposed, this skill helps the architect or developer break it down into actionable technical tasks, define the necessary code changes, and ensure it aligns with the existing 3-tier architecture.

Quick Start

Use the Architect Refinement Skill to guide the technical refinement of a new user story.

Frequently Asked Questions about Architect Refinement Skill

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

FAQPage Schema
How do I refine user stories for a 3-tier architecture?

Refine user stories for a 3-tier architecture by applying a structured framework that analyzes requirements, defines architectural patterns, and specifies layer responsibilities to ensure consistent software design and code quality.

What is technical refinement in software design?

Technical refinement in software design is the process of breaking down user stories into actionable technical tasks, defining necessary code changes, and ensuring alignment with existing layered architecture and development standards.

How do I establish definition of ready and done criteria for software development?

Establish definition of ready and done criteria by setting clear benchmarks for when a user story is ready for development and when it is considered complete, ensuring adherence to project standards and technical implementation details.

Can I use this skill to enforce naming conventions across backend and frontend components?

Yes, you can enforce naming conventions across backend and frontend components, as the framework documents project structure and maintains architectural consistency for backend, frontend, and shared components within a layered architecture.

What is the best way to align new features with existing layered architecture?

Align new features with existing layered architecture by using a structured refinement process that specifies implementation details, enforces architecture standards, and documents layer responsibilities for the proposed functionality.

Does technical refinement require specifying implementation details for user stories?

Yes, technical refinement requires specifying implementation details by defining what needs to be done, how it should be implemented, and where the code changes occur within the 3-tier architecture to maintain consistency.