writing-plans

Generate implementation plans with file paths, tests, and commands.

4|1|Updated Apr 4, 2024
One-click install
npx skills add https://github.com/maraxen/praxis --skill writing-plans-maraxen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/maraxen/praxis/tree/main/.agent/skills/writing-plans
Command: npx skills add https://github.com/maraxen/praxis --skill writing-plans-maraxen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Write comprehensive implementation plans assuming the engineer has zero context for our codebase and questionable taste. Document everything they need to know: which files to touch for each task, code, testing, docs they might need to check, how to test it. Give them the whole plan as bite-sized tasks. DRY. YAGNI. TDD. Frequent commits.

Core Features & Use Cases

  • Provides a structured framework to translate a feature spec into a concrete plan, including file touchpoints, tests, and documentation.
  • Enforces best practices: DRY, YAGNI, TDD, and frequent commits.
  • Supports saving plans to a conventional location and reusing worktrees for iterative brainstorming.

Quick Start

Create a new implementation plan for a feature and save it under docs/plans/YYYY-MM-DD-<feature-name>.md

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I turn feature specs into actionable implementation plans?

To turn feature specs into actionable implementation plans, generate a standardized structure with bite-sized tasks, explicit file paths, testing steps, and example commands, ensuring zero-context guidance for developers.

What is the best way to break a feature into tasks, tests, and milestones?

The best way to break a feature into tasks, tests, and milestones is enforcing a standardized plan structure that documents every action, file touchpoint, and validation step required to reproduce the work.

How does test-driven development fit into task breakdown documentation?

Test-driven development fits into task breakdown documentation by enforcing TDD practices alongside DRY and YAGNI principles, ensuring each bite-sized task includes explicit testing steps and frequent commits.

Can I save implementation plans to a conventional location for iterative brainstorming?

Yes, you can save implementation plans to a conventional location like docs/plans/YYYY-MM-DD-<feature-name>.md and reuse worktrees to support iterative brainstorming across multi-step tasks.

Do I need to specify file touchpoints when generating multi-step task plans?

Yes, you need to specify file touchpoints when generating multi-step task plans so engineers with zero codebase context know exactly which files to touch, check, and test for each milestone.

Why should I use standardized plan structures for feature implementation?

You should use standardized plan structures for feature implementation to provide zero-context guidance, preventing assumptions about codebase familiarity and ensuring all actions, tests, and documentation are explicitly defined.