writing-plans

Generate Markdown implementation plans from project specifications.

2|1|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/ninjasitm/ai-assisted-dev-toolkit --skill writing-plans-ninjasitm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/ninjasitm/ai-assisted-dev-toolkit/tree/main/src/monorepo/.agents/skills/writing-plans
Command: npx skills add https://github.com/ninjasitm/ai-assisted-dev-toolkit --skill writing-plans-ninjasitm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use when you have a spec or requirements for a multi-step task, before touching code

Core Features & Use Cases

  • Document everything needed: which files to touch for each task, code, testing, docs they might need to check, how to test it.
  • DRY. YAGNI. TDD. Frequent commits.
  • Assume engineers know little about the toolset or problem domain.

Quick Start

Provide a feature name and its requirements, and I will generate a full implementation plan.

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 specifications into an actionable implementation plan?

To turn specifications into an implementation plan, provide a feature name and clear requirements. The tool generates a comprehensive Markdown plan with file-level instructions, test plans, and documentation prompts, saving it to docs/plans/YYYY-MM-DD-<feature-name>.md.

How do I break down a multi-step development task for engineers unfamiliar with the toolset?

To break down development tasks for unfamiliar toolsets, generate a plan that assumes little domain knowledge. It documents which files to touch, code to write, testing steps, and necessary documentation, enforcing DRY and YAGNI practices.

Can I generate a test-driven development plan that includes file-level instructions?

Yes, you can generate a test-driven development plan with file-level instructions. The output explicitly enforces TDD practices alongside detailed task breakdowns, specifying exact files to modify and how to test them.

What is the best way to document everything needed for a multi-step coding task before touching code?

The best way to document requirements before coding is creating a structured Markdown plan. It captures code snippets, testing protocols, and documentation references, ensuring frequent commits and clear task execution.

Does this implementation planning approach work with diverse languages and frameworks?

Yes, this implementation planning approach works across diverse languages and frameworks. It processes provided feature requirements to generate explicit, file-level development guidance regardless of the specific technology stack used.