implementation-workflow

Execute code changes in isolated worktrees with todo-driven task breakdown.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/zcawood-mie/agentz --skill implementation-workflow-zcawood-mie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: implementation-workflow
Source: https://github.com/zcawood-mie/agentz/tree/main/skills/implementation-workflow
Command: npx skills add https://github.com/zcawood-mie/agentz --skill implementation-workflow-zcawood-mie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enforces a disciplined, minimal-change implementation cycle that prevents drive-by edits and ensures work is performed in isolated worktrees so reviewers can easily verify that every change serves the plan.

Core Features & Use Cases

  • Structured Phases: Breaks tasks into parse/understand, gather context, execute, test/debug, and report-back phases for predictable progress.
  • Worktree & Change Discipline: Requires edits in worktrees only and mandates minimal, plan-focused changes to keep diffs meaningful.
  • Autonomous Verification: Encourages use of built-in search tools, simple shell commands for exploration, and an autonomous test-and-debug loop before reporting.
  • Use Case: Implement a new API endpoint by creating a worktree, decomposing the ticket into tracked todos, editing only required files, running tests and debugging until green, and then summarizing results.

Quick Start

Create a dedicated worktree for the ticket, break the plan into tracked todos, implement only the required changes, run tests and debug until passing, and then report back with a summary and observations.

Frequently Asked Questions about implementation-workflow

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

FAQPage Schema
How do I enforce a minimal-change implementation workflow for feature development?

A minimal-change implementation workflow enforces worktree-only edits and todo-driven task breakdown to keep diffs meaningful. It breaks feature development into structured phases: parse context, gather details, execute changes, test, and report back.

What is a worktree-based development workflow and when should I use it?

A worktree-based development workflow isolates feature implementation, testing, and debugging cycles in dedicated worktrees. Use it when you need disciplined, repeatable code changes that prevent drive-by edits and allow reviewers to easily verify every change serves the plan.

How to break down a feature plan into tracked todos for isolated code changes?

Break down a feature plan by decomposing the ticket into tracked todos during the parse and gather-context phases. Execute only the required edits in a dedicated worktree, maintaining minimal, plan-focused changes throughout the implementation cycle.

Can I run an autonomous test-and-debug loop before reporting code changes?

Yes, an autonomous test-and-debug loop runs tests and debugs until passing before reporting back. Use built-in code search tools and simple single-purpose shell commands for exploration during this cycle to verify implementation correctness.

Does this implementation workflow require any specific testing frameworks or dependencies?

No specific testing frameworks or dependencies are required. The workflow uses built-in code search tools and simple shell commands for exploration, applying to repository development work across small scoped changes, testing, and debugging cycles.

Why should I avoid drive-by edits when implementing a new API endpoint?

Avoiding drive-by edits ensures worktree-only changes remain minimal and plan-focused, keeping diffs meaningful for reviewers. This disciplined approach guarantees every code change directly serves the implementation plan and passes the test-debug cycle.