implement-from-plan

Implements software plans with chunked approvals, test splits, and CI-aware check-ins.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/pulak999/ai-tooling --skill implement-from-plan-pulak999
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: implement-from-plan
Source: https://github.com/pulak999/ai-tooling/tree/main/ai-assistant-kit/claude-skills/implement-from-plan
Command: npx skills add https://github.com/pulak999/ai-tooling --skill implement-from-plan-pulak999

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a written plan or spec into working code often goes wrong through skipped reviews, ambiguous requirements, silent long coding stretches, and untested pushes. This Skill enforces a disciplined implementation workflow so plan execution stays reviewed, tested, and communicated at every step. ## Core Features & Use Cases - Pre-implementation review: Reads the full plan, runs a 3-phase code review, cross-references plan vs. codebase, and resolves all ambiguities before any code is written. - Per-chunk approval workflow: Decomposes the plan into small testable chunks, presenting each with a code plan and a local-test vs. CI test split recommendation for explicit approval. - Structured check-ins and CI awareness: Uses a fixed check-in format after every chunk, pushes with plan-referenced commit messages, monitors GitHub Actions status, and hard-stops on failures. - Use Case: You hand the AI a design doc for a new feature and say "implement this" — it reviews the codebase, updates CLAUDE.md/ARCH.md/TODO.md, then implements chunk by chunk with your approval at each stage. ## Quick Start Implement the feature described in docs/plan.md, reviewing the codebase first and checking in with me after each chunk.

Frequently Asked Questions about implement-from-plan

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

FAQPage Schema
How do I implement a plan file with an AI coding assistant?

Reference the plan file and ask the assistant to implement it. The skill reads the full plan, reviews the codebase, updates project docs, then decomposes the work into chunks that each require your explicit approval before any code is written.

How should I split tests between local unit tests and CI workflows?

Write fast, dependency-free logic tests as local unit tests, and reserve CI workflow checks for environment-sensitive, cross-platform, or secrets-requiring verification. The skill presents a recommended split for each chunk and waits for your approval, keeping the two layers complementary rather than duplicated.

What happens when CI fails during plan implementation?

The skill stops immediately, reports the failure in a structured check-in, and does not proceed until you decide how to handle it. It never pushes with failing local tests and always checks CI status on the previous push before starting the next chunk.

Does this skill work when the plan is ambiguous or incomplete?

No — ambiguity triggers a hard stop. If an interface is undefined, error handling is unspecified, or plan sections contradict each other, the skill asks you for clarification before writing any code rather than making assumptions.

What project documentation gets updated during implementation?

The skill creates or updates CLAUDE.md with build instructions and conventions, ARCH.md with architecture and data flow, and TODO.md with ordered actionable tasks. On completion it appends a structured entry to LOG.md covering features, files changed, functions, and data structures.