writing-plans

Create implementation plans with file changes, test strategies, and milestones.

30|2|Updated Mar 3, 2022
One-click install
npx skills add https://github.com/lie5860/ak-guess --skill writing-plans-lie5860
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/lie5860/ak-guess/tree/main/.agents/skills/writing-plans
Command: npx skills add https://github.com/lie5860/ak-guess --skill writing-plans-lie5860

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates thorough implementation plans from complex specs or multi-step requirements to prevent scope creep and miscommunication.

Core Features & Use Cases

  • Generate step-by-step task breakdowns with file-level changes, testing strategy, and milestones.
  • Define a dedicated worktree and plan storage locations to keep context isolated.
  • Facilitate collaboration and handoffs by exporting a consistent plan document.

Quick Start

Provide a detailed implementation plan for a given feature, focusing on tasks, roles, and acceptance criteria.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I create an implementation plan for complex software features to prevent scope creep?

You can create an implementation plan by decomposing multi-step requirements into task lists with file-level changes, testing strategies, and milestones. This plan-first execution approach applies DRY, YAGNI, and TDD principles to prevent scope creep and miscommunication.

What is task decomposition in software engineering and when do I need it?

Task decomposition is breaking complex specs into step-by-step tasks with defined file changes, test strategies, and milestones. You need it when executing multi-step requirements to prevent scope creep and ensure clear handoffs between product managers and developers.

How do I map out file changes and test strategies before coding a new feature?

Map out file changes and test strategies by generating an implementation plan that defines task lists, acceptance criteria, and milestones. The plan adheres to TDD principles and maps specific file modifications and tests in a dedicated worktree to isolate context.

Does plan-first execution work for managing multi-step requirements in an isolated worktree?

Plan-first execution works for multi-step requirements by defining a dedicated worktree and plan storage locations. This isolates context while generating task breakdowns with file changes, testing strategies, and milestones for product managers and developers.

What's the best way to document software project handoffs for developers and product managers?

The best way to document project handoffs is exporting a consistent plan document generated from complex specs. This document outlines tasks, roles, acceptance criteria, and milestones, facilitating collaboration and preventing miscommunication during multi-step feature execution.

Why should I use a dedicated worktree for project management and task planning?

You should use a dedicated worktree for task planning to keep context isolated during multi-step feature execution. It defines plan storage locations and maps file changes, ensuring implementation plans adhere to DRY, YAGNI, and TDD principles without interference.