What is a Shipyard implementation plan?

It is a structured Markdown document using XML tags to define tasks, file changes, and verification steps, allowing AI agents to systematically execute code changes.

What happens after the plan is created?

The skill saves the plan to a dedicated documentation directory and offers two execution paths: immediate agent-driven iteration or a separate parallel batch session.

Can I use these plans with multiple agents?

Yes, the structured format is specifically designed for handoff to builder agents or parallel execution sessions via the shipyard-executing-plans skill.

How does this skill improve code quality?

It enforces Test-Driven Development (TDD) by requiring failing tests to be written and verified before any implementation code is added to the project.

Shipyard Implementation Planner

Name: Shipyard Implementation Planner
Author: lgbarn

bylgbarn

•

Productivity & Workflow

Generates structured, test-driven implementation plans that break complex features into executable, bite-sized tasks for AI agents.

The Shipyard Implementation Planner is designed to bridge the gap between high-level requirements and actual code execution. It translates specifications into a standardized, XML-structured roadmap that follows strict Test-Driven Development (TDD) principles. By documenting exact file paths, providing boilerplate code, and defining explicit verification commands, this skill ensures that downstream builder agents have zero ambiguity. It is a critical component of the Shipyard workflow, facilitating disciplined project management and high-quality software delivery through granular, 2-5 minute task breakdowns.

Key Features

01Explicit file path and code snippet documentation for context-free builders

02XML-structured task generation for automated agent execution

03Standardized verification commands and expected output definitions

04Strict Test-Driven Development (TDD) workflow integration

05Granular task decomposition into 2-5 minute executable steps

0638 GitHub stars

Use Cases

01Translating a feature specification into a sequence of actionable coding tasks

02Preparing structured worktrees for parallel AI builder agent execution

03Establishing technical roadmaps for complex refactoring or new module development

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lgbarn/shipyard shipyard-writing-plans

For use in Claude.ai and ChatGPT

Download Skill