spec-to-plan

Convert converged spec frames into buildable task plans with acceptance criteria.

112|6|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/agentculture/culture --skill spec-to-plan-agentculture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-to-plan
Source: https://github.com/agentculture/culture/tree/main/.claude/skills/spec-to-plan
Command: npx skills add https://github.com/agentculture/culture --skill spec-to-plan-agentculture

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It prevents turning a converged spec into an actionable build plan by converting “what to build” into “how to build” with explicit tasks, coverage targets, honesty-gated acceptance criteria, and an export only after convergence.

Core Features & Use Cases

  • Spec→plan transformation: Seeds a plan from a converged frame and adds tasks that collectively cover every coverage target (confirmed claims + honesty conditions).
  • TDD-style task contracts: Lets you add acceptance criteria per task, record dependencies, and ensure each task is objectively checkable.
  • Risk and convergence gating: Parks genuine unknowns as first-class risks and blocks export until the plan converges against the live source frame.
  • Scheduling metadata for parallel execution: Emits deterministic dependency waves suitable for fanning tasks out to a workforce (without performing orchestration itself).

Quick Start

Ask the agent to run spec-to-plan with the move status to see the current gaps and the single recommended next step.

Frequently Asked Questions about spec-to-plan

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

FAQPage Schema
How do I convert a spec into an actionable build plan?

To convert a spec into an actionable build plan, you seed a plan from a converged frame and add tasks that collectively cover every confirmed claim and honesty condition. This ensures each task has objective acceptance criteria and explicit dependencies.

How do I write acceptance criteria for build tasks using TDD?

Writing acceptance criteria for build tasks using TDD involves adding task contracts that are objectively checkable. You record dependencies for each task and ensure every task maps directly to a coverage target derived from the spec.

How does dependency graph scheduling work for parallel task execution?

Dependency graph scheduling for parallel execution emits deterministic dependency waves based on recorded task dependencies. It organizes tasks into sequential waves suitable for fanning out to a workforce without performing the orchestration itself.

When should I gate a build plan export for unresolved risks?

You should gate a build plan export when genuine unknowns exist, parking them as first-class risks. The export is blocked until the plan converges against the live source frame, ensuring no unresolved risks remain before building starts.

What is a converged spec frame in workflow orchestration?

A converged spec frame in workflow orchestration is the finalized 'what to build' specification. It serves as the required input for generating a build plan, ensuring all confirmed claims and honesty conditions are established before task mapping begins.

Can I use spec-to-plan without a converged source frame?

No, you cannot use spec-to-plan without a converged source frame. The tool requires a converged frame to enforce convergence and export invariants, preventing the generation of a build plan from an incomplete or unresolved specification.