writing-plans

Outline goals, architecture, and tasks in a structured plan file.

28|1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/Jamie-Cui/magent --skill writing-plans-jamie-cui
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/Jamie-Cui/magent/tree/main/skills/writing-plans
Command: npx skills add https://github.com/Jamie-Cui/magent --skill writing-plans-jamie-cui

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams outline multi-step work specifications and requirements before touching code, ensuring a clear roadmap and shared understanding.

Core Features & Use Cases

  • Header-driven planning: capture goals, architecture, and tech stack in a concise plan.
  • File Map & Tasks: enumerate files to create or modify and define actionable tasks with steps.
  • Templates & Reuse: save plans to a standard location for easy reuse across projects.

Quick Start

Create a new plan by saving it to docs/plans/YYYY-MM-DD-<feature>.md and fill in the header, file map, and tasks.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I plan complex features before coding to ensure proper task sequencing?

To plan complex features before coding, outline your goals, architecture, and tech stack in a plan header, then define a file map and actionable task sequence saved to a standard markdown file path for team alignment.

What is the best way to document multi-step requirements and workflows for refactoring?

Documenting multi-step requirements for refactoring involves creating a structured plan with a header capturing goals and architecture, a file map for modifications, and sequential actionable steps saved to a reusable markdown template.

Can I use standard templates for feature development planning across different projects?

Yes, you can use standard templates for feature development planning by saving plans to a fixed file path like docs/plans/YYYY-MM-DD-feature.md, enabling consistent documentation and reuse across multiple projects.

Do I need to define a file map when outlining requirements for a complex bug fix?

Yes, defining a file map is necessary when outlining requirements for a complex bug fix to explicitly enumerate files that need modification, ensuring precise task execution and clear documentation.

What should be included in a development plan to maintain shared understanding across teams?

A development plan should include a header with goals, architecture, and tech stack, a file map detailing files to create or modify, and a sequence of actionable tasks to maintain shared understanding across teams.

When should I avoid using structured plans for task documentation?

Structured plans for task documentation are unnecessary for simple, single-step changes that do not require architecture outlines, file maps, or precise task sequencing to execute correctly.