ywc-spec-ready

Loop validation and amendment cycles until all specification findings are resolved.

8|1|Updated May 13, 2026
One-click install
npx skills add https://github.com/yongwoon/ywc-agent-toolkit --skill ywc-spec-ready
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ywc-spec-ready
Source: https://github.com/yongwoon/ywc-agent-toolkit/tree/main/claude-code/skills/ywc-spec-ready
Command: npx skills add https://github.com/yongwoon/ywc-agent-toolkit --skill ywc-spec-ready

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, gh, and includes references (resource) components.

What problem does it solve?

This Skill solves the problem of incomplete or non-compliant technical specifications by automatically driving them through a validation and refinement loop until they are fully ready for task generation.

Core Features & Use Cases

  • Multi-iteration Convergence: Automatically runs validation and applies amendments until all Critical and Warning findings are resolved.
  • Safety Guardrails: Prevents infinite loops and cost blow-outs with iteration caps, advisor budget tracking, and convergence stall detection.
  • Use Case: When a spec produced by ywc-plan still contains open warnings or critical findings, use this Skill to iteratively refine the document until it meets the strict requirements for decomposition into actionable tasks.

Quick Start

Use the ywc-spec-ready skill to converge the specification file located at docs/ywc-plans/feature.md until it reaches a fully validated state.

Frequently Asked Questions about ywc-spec-ready

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

FAQPage Schema
How do I automate specification validation and amendment until all findings are resolved?

To automate specification validation, you loop validation and amendment cycles until all Critical and Warning findings are resolved. This iterative convergence drives technical specifications to a fully task-ready state before implementation begins.

How does convergence stall detection work for technical specifications?

Convergence stall detection identifies when iterative validation and amendment cycles stop making progress toward resolving findings. It acts as a safety guardrail alongside iteration caps and budget tracking to prevent infinite loops during specification refinement.

Do I need python3 and gh to run automated spec convergence workflows?

Yes, you need python3 and gh installed because the automated spec convergence workflow depends on them to execute programmatic spec reviews and apply amendments iteratively until the documentation meets task-ready requirements.

What is the best way to resolve open warnings in a technical specification before task generation?

The best way to resolve open warnings is to run an automated convergence loop that validates the specification and applies amendments iteratively. This multi-iteration process ensures all critical and warning findings are cleared for decomposition.

When do I need to use an automated spec convergence loop in software development?

You need automated spec convergence when a technical specification produced during planning still contains open warnings or critical findings, requiring iterative refinement to meet strict requirements before generating actionable development tasks.

Why does specification convergence stop before all findings are resolved?

Specification convergence stops before all findings are resolved due to safety guardrails like iteration caps, advisor budget tracking, or stall detection. These constraints prevent infinite loops and cost blow-outs during the automated validation and amendment cycles.