writing-plans

Generate multi-step implementation plans from approved designs or requirements.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Write comprehensive implementation plans for multi-step tasks starting from an approved design or requirements. This skill ensures the engineer has a complete roadmap before touching code, reducing rework and miscommunication.

Core Features & Use Cases

  • Multi-perspective design/plan reviews: Surface gaps from product, security, maintainability, UX, and architecture perspectives using codex exec.
  • Discovery Log integration: Preserve conversation history and decisions for traceability.
  • Plan documentation: Generate task lists, touched files, tests, docs, and commit steps to implement the design.
  • Auto-fix loop before implementation: Iterate until Critical or Important issues are resolved or escalated.

Quick Start

Provide an approved design or requirements and generate a complete, executable 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 plan multi-step software implementations from approved requirements?

To plan multi-step software implementations, you provide an approved design or requirements to generate a complete roadmap. This process produces structured task breakdowns, touched files lists, tests, and commit steps to reduce engineering rework and miscommunication before touching code.

What is multi-perspective design review in software planning?

Multi-perspective design review in software planning surfaces gaps across product, security, maintainability, UX, and architecture perspectives. It iteratively evaluates the implementation plan to ensure critical issues are resolved or escalated before any code is written.

How do I break down a design document into executable engineering tasks?

Breaking down a design document into executable engineering tasks involves generating detailed implementation plans that specify touched files, tests, and documentation. It aligns task lists with the discovery log to preserve conversation history and ensure traceability throughout execution.

Can I integrate TDD workflow steps into my implementation plan?

Yes, you can integrate TDD workflow steps into your implementation plan. The planning process generates structured task lists that include tests and commit records, ensuring test-driven development artifacts are produced and kept aligned with the design documentation.

Does this planning approach work for complex tasks requiring architecture and security reviews?

Yes, this planning approach works for complex tasks requiring architecture and security reviews. It applies to engineering tasks that need thorough planning and structured breakdown across multiple perspectives, using an auto-fix loop to resolve critical issues before implementation begins.

What is a discovery log and how does it help with traceability in implementation planning?

A discovery log preserves conversation history and decisions for traceability during implementation planning. It ensures that generated artifacts like design documents, implementation plans, and commit records remain aligned with the original requirements and ongoing project decisions.