writing-plans

Translate project specs into step-by-step implementation plans with file mappings.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translate a project spec into a meticulous, step-by-step implementation plan for multi-step tasks.

Core Features & Use Cases

  • Clear task decomposition: breaks complex work into focused, testable tasks with inputs and outputs.
  • Plan-driven development: embeds testing, documentation, and architecture guidance into the plan to guide implementation.
  • Use Case: when starting a new feature with unclear scope, generate a plan detailing touched files, tests, docs, and milestones.

Quick Start

Provide a project spec and I will generate a complete, step-by-step 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 a step-by-step implementation plan?

To turn project specifications into an implementation plan, provide the spec to generate a fixed structure with task boundaries, testing strategy, documentation, and milestones. This decomposes complex workflows into focused, testable tasks with explicit inputs and outputs.

What is task decomposition for complex project workflows?

Task decomposition breaks complex project workflows into focused, testable tasks with explicit inputs and outputs. It enforces concrete file mappings and global constraints so engineers can implement multi-step features with confidence across evolving codebases.

How do I plan testing and documentation milestones for a new feature?

To plan testing and documentation milestones for a new feature, generate a plan-driven development document that embeds architecture guidance, test strategies, and doc requirements. This ensures all touched files and milestones are detailed before implementation begins.

Can I generate an implementation plan for an evolving codebase with unclear scope?

Yes, you can generate an implementation plan for evolving codebases with unclear scope. The process translates ambiguous project specs into meticulous, stepwise plans detailing touched files, tests, docs, and milestones to guide engineers through complex multi-step tasks.

What's the best way to structure an implementation plan for multi-step tasks?

The best way to structure an implementation plan for multi-step tasks is using a fixed plan format that enforces global constraints, explicit task boundaries, testing strategy, and concrete file mappings. This guarantees engineers implement with confidence and clear direction.