What is the benefit of the TDD requirement in the generated plans?

It enforces a Test-Driven Development workflow by mandating that any agent following the plan must write and pass tests before marking a task as complete, ensuring higher code reliability.

Will this skill overwrite my existing plans?

No, the skill uses a strict timestamped naming convention (YYYY-MM-DD-HHmm) for every new file to ensure a clear audit trail and prevent accidental data loss.

What kind of validation does the Plan Refinement skill perform?

It validates plans against several parameters including problem/solution scope, grouped file references, technical decisions, and Implementation Plan tasks with Given/When/Then acceptance criteria.

Does this skill write actual application code?

No, Plan Refinement is documentation-only. It specifically generates markdown plan files in your ./docs/plan/ directory to guide subsequent coding tasks.

Plan Refinement

Name: Plan Refinement
Author: AndersHalo

byAndersHalo

0•

开发者工具

Refines and documents structured AI execution plans with mandatory validation loops and TDD-first requirements.

Plan Refinement is a specialized utility for Claude Code designed to bridge the gap between conceptual requirements and production-ready implementation. It enforces a rigorous, documentation-only workflow that translates complex features into detailed markdown checklists stored within your repository's documentation. By requiring mandatory gap analysis, TDD-first execution rules, and a strict verification loop, this skill ensures that AI agents have clear, validated instructions before a single line of application code is written, significantly reducing architectural drift and implementation errors.

主要功能

01Interactive verification loops that ensure user confidence before finalized documentation is written

020 GitHub stars

03Automated gap analysis covering UI designs, task granularity, and architectural dimensions

04Standardized plan generation with YAML front matter and automated timestamp versioning

05Strict validation against technical parameters including file grouping and acceptance criteria

06Mandatory TDD (Test-Driven Development) and dev-context-first execution rules in every plan

使用场景

01Standardizing implementation plans across teams to ensure consistent TDD and documentation practices

02Performing structural gap analysis on existing plans to identify missing edge cases or technical decisions

03Converting high-level feature requests into actionable, step-by-step developer checklists

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add andershalo/halo-ai-dev-tools plan-refinement

For use in Claude.ai and ChatGPT

Download Skill