plan-protocol

Create multi-phase implementation plans with YAML frontmatter and citation integration.

Updated Nov 3, 2019
One-click install
npx skills add https://github.com/gil0mendes/dotfiles --skill plan-protocol-gil0mendes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-protocol
Source: https://github.com/gil0mendes/dotfiles/tree/main/configs/opencode/skill/plan-protocol
Command: npx skills add https://github.com/gil0mendes/dotfiles --skill plan-protocol-gil0mendes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a standardized, auditable format for creating and managing complex implementation plans, ensuring clarity, traceability, and adherence to research-based decisions.

Core Features & Use Cases

  • Structured Planning: Enforces a consistent markdown format with YAML frontmatter, phased progress, and hierarchical tasks.
  • Decision Traceability: Integrates citations (ref:delegation-id) to link plan decisions directly to their research sources.
  • Progress Tracking: Utilizes clear status markers for phases and tasks, including a single ← CURRENT marker for active work.
  • Use Case: When starting a new software feature that requires research and multiple development phases, use this Skill to create a plan that clearly outlines the goal, context, decisions, and step-by-step progress, with every significant decision linked back to the research that informed it.

Quick Start

Use the plan_save command with the provided markdown format to create a new implementation plan.

Frequently Asked Questions about plan-protocol

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

FAQPage Schema
How do I create a structured implementation plan with decision traceability?

To create a structured implementation plan with decision traceability, use a standardized Markdown format with YAML frontmatter, phased progress markers, and hierarchical tasks. Integrate citations using `ref:delegation-id` to link plan decisions directly to their research sources.

What is the best way to track multi-phase project progress in Markdown?

Tracking multi-phase project progress in Markdown requires using specific status markers for phases and tasks. Designate active work with a single `← CURRENT` marker alongside YAML frontmatter to maintain clear, auditable progress across hierarchical implementation steps.

How do I link research sources to project management decisions?

Link research sources to project management decisions by integrating citations directly into your implementation plan. Use the `ref:delegation-id` formatting rule within your Markdown structure to ensure every significant decision is connected to its research-based rationale.

Can I use YAML frontmatter for software feature planning and tracking?

Yes, you can use YAML frontmatter for software feature planning and tracking. It enforces consistent formatting for multi-phase implementation plans, providing a structured foundation for project tracking, hierarchical task management, and decision traceability.

Does this planning approach require any specific dependencies or environments?

No, this planning approach requires no external dependencies. It operates independently using standard Markdown formatting and YAML frontmatter to manage implementation plans, requiring only adherence to specific formatting rules for frontmatter and phase status.

When should I not use a standardized Markdown format for implementation plans?

You should not use a standardized Markdown format for implementation plans when your project lacks a research-based rationale or multi-phase development requirements. The structure enforces decision traceability and hierarchical task management, which adds overhead for simple, linear tasks.