One-click install
npx skills add https://github.com/KMakayee/playbook --skill issue-implement-kmakayee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-implement
Source: https://github.com/KMakayee/playbook/tree/main/.claude/skills/issue-implement
Command: npx skills add https://github.com/KMakayee/playbook --skill issue-implement-kmakayee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns a previously approved issue plan into working code safely by executing each planned phase, validating results, and running a full code review to catch defects and gaps before you commit.

Core Features & Use Cases

  • Phase-by-phase implementation: Executes the plan in order for issue #N while keeping changes minimal and scoped to what the plan specifies.
  • Plan adherence and resume support: Verifies plan presence/finality, resumes from the first unchecked success criteria, and updates plan checkmarks as work completes.
  • Structural mismatch recovery: Detects structural plan/code mismatches and triggers a targeted re-research via Codex (scoped to the specific mismatch) instead of blindly continuing.
  • Uncommitted review loop: Runs Codex code review over the full uncommitted working tree diff and applies vetted fixes inline, then performs a final test/lint pass.
  • Issue workflow integration: Updates tasks/issues.md status to In Progress and later to Implemented, leaving the final single commit to /auto-issues (pipeline) or /issue-finish (standalone).

Quick Start

Run issue-implement for issue 12 by invoking: /issue-implement 12.

Frequently Asked Questions about issue-implement

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

FAQPage Schema
How do I execute an approved issue implementation plan phase by phase?

To execute an approved implementation plan, invoke the Skill with the target issue number. It applies phase-scoped code changes sequentially, verifies results against success criteria, and updates task checkmarks without making git commits.

What do I need before starting issue implementation with code review?

Starting issue implementation requires finalized tasks/research-issue-N.md and tasks/plan-issue-N.md files. The Skill performs read-only integrity checks to verify plan presence and finality before executing any code changes.

How does phase-by-phase development handle structural mismatches between plan and code?

Handling structural mismatches involves detecting plan/code divergences and triggering targeted re-research via Codex. Instead of blindly continuing, the Skill scopes re-research to the specific mismatch to realign the implementation.

Can I resume implementation from a partially completed phase?

Yes, you can resume implementation from a partially completed phase. The Skill locates the first unchecked success criteria in the plan file and resumes execution from that exact point, updating checkmarks as remaining work completes.

Does the implementation workflow run test and lint verification on uncommitted changes?

Yes, test and lint verification runs on the full uncommitted working tree diff. After applying vetted fixes from Codex code review inline, the Skill performs a final test and lint pass to catch defects before any commit.

Why are my issue implementation changes not committed automatically?

Changes remain uncommitted because the Skill delegates the final single commit to downstream actions. It updates tasks/issues.md status to Implemented, leaving the commit to /auto-issues pipelines or /issue-finish for standalone workflows.