writing-plans

Convert project specs into structured implementation plans with file paths and tests.

Updated Jan 19, 2026
One-click install
npx skills add https://github.com/DaFum/github-repository-vi --skill writing-plans-dafum
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/DaFum/github-repository-vi/tree/main/skills/writing-plans
Command: npx skills add https://github.com/DaFum/github-repository-vi --skill writing-plans-dafum

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams translate vague specs into concrete, auditable implementation plans, reducing miscommunication and rework.

Core Features & Use Cases

  • Structured planning: Converts requirements into a step-by-step plan with file touches, tests, and commits.
  • Dedicated worktree workflow: Enforces a disciplined approach by using a separate worktree to brainstorm and capture plans.
  • Documentation-driven: Saves plans to docs/plans with a clear header and task granularity and supports TDD-style steps.

Quick Start

Create a new plan using the skill to draft an implementation plan from a given spec, then save it under docs/plans with the date suffix, and review the plan before coding.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I turn project specs into a structured implementation plan?

To turn project specs into an implementation plan, you can generate a step-by-step roadmap with explicit file paths, tests, and version-control steps. This enforces a dedicated worktree workflow and saves the structured plan under docs/plans.

What is a dedicated worktree workflow for implementation planning?

A dedicated worktree workflow for implementation planning separates brainstorming and plan capture from your main branch. It enforces a disciplined approach by using an isolated git worktree to draft and structure actionable tasks before any coding begins.

How do I add TDD-style steps to my task breakdown documentation?

You can add TDD-style steps to your task breakdown by generating a fixed plan template that explicitly lists required tests alongside file touches and commits. This ensures test-driven development steps are auditable within the saved plan.

Does this planning approach support complex multi-step tasks across documentation and code?

Yes, this planning approach supports complex multi-step tasks across code, testing, and documentation. It provides clear task granularity, auditable decisions, and repeatable workflows to reduce miscommunication and rework.

Can I use git worktrees to brainstorm and capture implementation plans?

Yes, you can use git worktrees to brainstorm and capture implementation plans. The process enforces a dedicated worktree workflow, ensuring plan generation happens in an isolated environment before saving the final roadmap to docs/plans.