spec-execution

Execute specification documents through planned waves of parallel and sequential changes.

35|4|Updated Dec 18, 2024
One-click install
npx skills add https://github.com/wellcrafted-dev/wellcrafted --skill spec-execution-wellcrafted-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-execution
Source: https://github.com/wellcrafted-dev/wellcrafted/tree/main/.claude/skills/spec-execution
Command: npx skills add https://github.com/wellcrafted-dev/wellcrafted --skill spec-execution-wellcrafted-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the process of implementing specification documents by breaking down the work into manageable waves of parallel and sequential changes, ensuring a clean git history and verifiable progress.

Core Features & Use Cases

  • Wave-based Implementation: Executes tasks in planned waves, committing code and spec updates after each wave.
  • Sub-agent Orchestration: Leverages sub-agents for individual tasks to maintain focused context and improve results.
  • Spec Synchronization: Updates the specification document to reflect completed tasks and any implementation deviations.
  • Use Case: When given a complex feature specification, this Skill will plan, execute, and track the implementation in iterative steps, providing a clear audit trail of progress.

Quick Start

Use the spec-execution skill to implement the specification found in the file 'specs/new-feature.md'.

Frequently Asked Questions about spec-execution

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

FAQPage Schema
How do I automate specification implementation with a clean git history?

Automating specification implementation with a clean git history is achieved by executing tasks in planned waves and committing code after each wave. This approach breaks down complex feature specifications into manageable parallel and sequential changes, ensuring verifiable progress.

How does wave-based task execution work for complex feature specifications?

Wave-based task execution works by planning parallel and sequential changes for complex feature specifications. Each wave is implemented, verified through type-checking and testing, and then committed to git, while the specification document is synchronized to reflect completed tasks and deviations.

Do I need sub-agent orchestration to execute specification documents?

Yes, sub-agent orchestration is required to execute specification documents. Leveraging sub-agents for individual tasks maintains focused context during implementation, which improves results and ensures methodical, wave-by-wave execution of the defined specification.

What is the best way to track implementation progress for detailed planning documents?

The best way to track implementation progress for detailed planning documents is to update the specification document after each execution wave. This synchronization reflects completed tasks and deviations, providing a clear audit trail alongside incremental git commits.

Can I execute a specification file without manual type-checking and testing steps?

No, executing a specification file includes built-in verification steps like type-checking and testing after each wave. These verification steps are automatically applied during the implementation process to ensure code quality before committing the changes to git.

When should I avoid using an automated spec execution workflow?

You should avoid automated spec execution workflows when a detailed planning document or defined specification is not available. This methodical, wave-by-wave execution approach requires a structured specification file to plan, execute, and track implementation effectively.