omc-plan

Generate structured work plans with ADRs, acceptance criteria, and implementation steps.

1|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/OliverOuyang/shuhe-work-skills --skill omc-plan-oliverouyang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: omc-plan
Source: https://github.com/OliverOuyang/shuhe-work-skills/tree/main/skills/plan
Command: npx skills add https://github.com/OliverOuyang/shuhe-work-skills --skill omc-plan-oliverouyang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns vague or underspecified project requests into structured, testable, and actionable work plans so teams can start implementation with clarity and reduced rework.

Core Features & Use Cases

  • Adaptive mode selection: automatically chooses interview, direct, consensus (RALPLAN-DR), or review flow based on request specificity.
  • Consensus-driven quality gates: Planner → Architect → Critic loop with re-review iterations, ADR generation, and enforced testable acceptance criteria.
  • Safe handoff and state management: writes and clears ralplan state, preserves plans in .omc/plans/, and invokes execution skills (team/ralph) for implementation handoffs.
  • Use Case: Scope a high-risk data migration by interviewing stakeholders, produce a RALPLAN-DR summary, iterate with Architect/Critic, and hand off an approved plan to the team orchestrator.

Quick Start

Use the plan skill to create a consensus work plan for migrating the billing service with high-risk data and rollback requirements.

Frequently Asked Questions about omc-plan

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

FAQPage Schema
How do I turn vague project ideas into executable work plans with clear acceptance criteria?

Executable work plans are generated from vague ideas through iterative interviews or direct planning, producing testable acceptance criteria, ADRs, and file-referenced implementation steps. The system automatically adapts its mode based on the specificity of your initial request.

What is the best way to scope high-risk software migrations and ensure team consensus?

Scoping high-risk migrations uses a consensus-driven quality gate loop involving a Planner, Architect, and Critic. This iterative process generates a RALPLAN-DR summary and enforces testable acceptance criteria before approving any architectural design or migration plan.

How do I generate Architecture Decision Records for complex software engineering projects?

Architecture Decision Records are generated automatically during the consensus review process. The Planner, Architect, and Critic loop iterates on the design to ensure quality before producing the final ADRs alongside structured, file-referenced implementation steps.

Can I use automatic mode selection for requirements gathering instead of manual interviews?

Automatic mode selection chooses between interview, direct, consensus, or review flows based on request specificity. If your project requirements are already detailed, the system bypasses manual interviews and directly generates a structured, actionable work plan.

How does state lifecycle management work when handing off plans to execution skills?

State lifecycle management writes and clears ralplan states while preserving approved plans in the .omc/plans/ directory. This ensures structured handoffs to execution skills like team or ralph orchestrators for immediate implementation.

What are the limitations of using automated planning for organizational change management?

Automated planning requires sufficient initial context to select the correct mode, and while it supports organizational projects, complex change management may still need extensive manual interview iterations to capture all stakeholder requirements accurately before generating the final plan.