plan-writer

Generate structured implementation plans from design session outputs and briefs.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Kiwi-Home/ai-workflow --skill plan-writer-kiwi-home
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-writer
Source: https://github.com/Kiwi-Home/ai-workflow/tree/main/plugins/structured-workflows/skills/plan-writer
Command: npx skills add https://github.com/Kiwi-Home/ai-workflow --skill plan-writer-kiwi-home

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert design session outputs and briefs into a structured, actionable implementation plan that ties design decisions to ordered steps, agent responsibilities, quality gates, and deliverable artifacts so execution proceeds with clear responsibilities and safety checks.

Core Features & Use Cases

  • Standardized Plan Template: Produces a consistent plan with Prior Design Decisions, Approach, ordered Steps table, Quality Gates, Risks & Mitigations, and Acceptance Criteria to make reviews and execution deterministic.
  • Replacement Pattern Detection & Interleaving: Detects component-level replacement patterns and enforces interleaved create/delete ordering and dependency-safe deletions to avoid unsafe batching.
  • Workflow Integration & Agent Assignment: Maps steps to execution stages from workflow.yaml, resolves quality gates, and assigns agents by matching step needs to the agents_generated roster.
  • Use Case: Turn a design session for migrating an API or replacing a provider into a reviewed, gate-enforced implementation plan that an execution agent can follow.

Quick Start

Generate an implementation plan from design session notes, ensuring steps include agent assignments, mapped stages, and quality gates.

Frequently Asked Questions about plan-writer

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

FAQPage Schema
How do I convert design session notes into an actionable implementation plan?

To generate an implementation plan, you input design session outputs and briefs to bind design decisions to ordered steps, agent assignments, and quality gates, producing a structured template ready for execution agents to follow deterministically.

What is replacement pattern detection in implementation planning?

Replacement pattern detection identifies component-level replacements in your plan and enforces interleaved create/delete ordering alongside dependency-safe deletions, preventing unsafe batching and ensuring system stability during execution.

How do I map implementation steps to execution stages and assign agents?

Implementation steps are mapped to execution stages by integrating phases.execute.stages from workflow.yaml, resolving quality gates, and matching step requirements to available agents in the agents_generated roster for precise task delegation.

Can I use workflow.yaml to enforce quality gates in my implementation plan?

Yes, implementation plans integrate phases.execute.stages and quality_gates directly from workflow.yaml, enforcing safety checks and mapping deliverable artifacts to ensure execution proceeds with clear responsibilities and verified gate compliance.

What is the best way to structure an implementation plan for a provider migration?

The best way is using a standardized plan template featuring Prior Design Decisions, an ordered Steps table, Quality Gates, Risks & Mitigations, and Acceptance Criteria, ensuring the migration is reviewed and gate-enforced for execution agents.

Why does dependency safety matter when planning component replacements?

Dependency safety matters because unsafe batching of component deletions can break system integrity, so the plan enforces interleaved create/delete ordering to ensure replacements execute without disrupting dependent services or causing execution failures.