writing-plans

Generate implementation plans with tasks, file paths, tests, and quantitative metrics.

2|Updated Sep 30, 2025
One-click install
npx skills add https://github.com/krzemienski/shannon-framework --skill writing-plans-krzemienski
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-plans
Source: https://github.com/krzemienski/shannon-framework/tree/main/skills/writing-plans
Command: npx skills add https://github.com/krzemienski/shannon-framework --skill writing-plans-krzemienski

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires serena, and includes references (resource) components.

What problem does it solve?

Writing plans create comprehensive, self-contained implementation steps for engineers with zero context, including quantitative analysis, exact file paths, code examples, validation gates, and MCP requirements.

Core Features & Use Cases

  • Quantified implementation plans (complexity scores, tasks)
  • Exact file paths and code examples
  • Validation gates between steps
  • Explicit MCP requirements
  • Structured plan handoff documentation

Quick Start

Use writing-plans to generate a complete, self-contained implementation plan for a new feature.

Frequently Asked Questions about writing-plans

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

FAQPage Schema
How do I generate implementation plans with exact file paths and code examples?

Implementation plans provide step-by-step tasks with real file paths, runnable code samples, and quantitative metrics like complexity scores and duration estimates. This Skill generates self-contained plans when you have design finalized but need precise execution steps, validation gates, and MCP requirements for handoff to engineers with zero context.

What should I include in an implementation plan before handing off to engineers?

Comprehensive plans include header templates, exact file paths for all changes, code examples for each component, validation gates between milestones, complexity and risk scores, backend/data/frontend/DevOps breakdowns, and explicit MCP requirements. This ensures engineers can execute without clarification.

Can implementation plans include quantitative analysis and validation gates?

Yes. Plans integrate Shannon quantitative analysis across architecture layers, assign complexity and duration metrics to each task, define validation gates between steps, and specify MCP dependencies. This transforms design into measurable, gated execution phases.

How do I structure implementation plans for backend, data, frontend, and DevOps work?

Plans break tasks across all four layers with layer-specific file paths, code examples, and metrics. Each layer includes its own validation gates and dependencies, allowing parallel execution while maintaining coordination points and cross-layer requirements.

When should I use implementation plans instead of ad-hoc task lists?

Use implementation plans when design is complete, multiple engineers need context-free execution, quantified risk and complexity matter for scheduling, or you need documented handoff with validation checkpoints. Plans eliminate ambiguity when distributing work across teams.

Do implementation plans work with MCP-driven workflows?

Yes. Plans explicitly list MCP requirements and integrate them into task sequences and validation gates. This ensures MCP dependencies are clear before execution begins and validation gates confirm MCP interactions succeed.