Engineering
oh-my-claude avatar

oh-my-claude

Activates Prometheus planning mode for structured requirement gathering, codebase research, and task planning within Claude Code.

Introduction

The Plan Skill (Prometheus) is a sophisticated multi-agent orchestration tool designed to transition Claude Code from an active implementer to a structured architect. By entering this mode, users initiate a professional planning session that separates requirement gathering from implementation, preventing premature coding and ensuring alignment between user objectives and architectural reality.

Prometheus acts as an interviewer, creating dedicated draft files (.sisyphus/drafts/{topic}.md) to document requirements, decisions, research findings, and notes in real-time. It leverages the native Claude Code 'Explore' subagent to perform codebase analysis, identifying patterns, existing code, and potential conflicts before any actual work begins. Users remain in full control, iterating on the plan until they explicitly request the generation of a final work plan, which is then stored in .sisyphus/plans/{topic}.md.

  • Multi-Agent Orchestration: Integrates with the broader oh-my-claude agent ecosystem, utilizing dedicated planning agents to ensure comprehensive scope definition.
  • Requirement Gathering: Facilitates a structured, interview-based workflow to clarify objectives, success criteria, and constraints.
  • Codebase Discovery: Automatically triggers codebase research to ground the planning process in the reality of existing project structures.
  • Plan Generation: Produces detailed, actionable work plans including context summaries, objectives, verification strategies, task flows, and TODO lists.
  • Draft Lifecycle: Manages the lifecycle of a planning session, including file creation, incremental updates, and cleanup post-plan generation.
  • Tool Integration: Utilizes dedicated MCP tools (draft_create, draft_read, draft_update, etc.) to maintain state and context across sessions.
  • Verification-Ready: Ensures that generated plans include explicit verification strategies and success criteria, setting the stage for TDD and auto-verification workflows.

Users should invoke the skill using the @plan or /plan trigger followed by their topic. This skill is ideal for complex features, architectural changes, or refactoring tasks where upfront analysis is required to reduce implementation risk. Maintain clarity during the interview phase by providing specific feedback on objectives and constraints to ensure the generated plan is highly accurate and directly actionable by subsequent implementation agents.

Repository Stats

Stars
7
Forks
1
Open Issues
1
Language
Shell
Default Branch
main
Sync Status
Idle
Last Synced
May 4, 2026, 01:32 AM
View on GitHub