discovery-tree-workflow

What problem does it solve?

This Skill eliminates the chaos of complex, opaque project planning and tracking. It replaces rigid, upfront planning with an emergent, outcome-focused approach, making work visible and coordinating agents efficiently. It frees you from manual task lists and provides a clear, hierarchical view of progress, ensuring that work evolves with discovery.

Core Features & Use Cases

• Outcome-Driven Planning: Focus on "what will be true" rather than "how to make it true," empowering implementing agents and ensuring verifiable results.
• Just-in-Time & Emergent Breakdown: Start with minimal detail and grow the work breakdown structure organically as discoveries are made, reducing wasted upfront planning and adapting to new information.
• Agent Coordination & Visual Status: Clearly define work units (beads) for implementing agents, track progress visually, and ensure everyone sees the current state at a glance, fostering seamless collaboration.
• Use Case: When starting a new feature like "User Authentication System," use this skill to define the root epic and initial outcomes (e.g., "User can sign in," "Invalid credentials show error"). As development progresses, new requirements or complexities are discovered, they are added to the tree, keeping the project visible and adaptable without needing to re-plan from scratch.

Quick Start

To start a new project, create a root epic and bead: bd create "Users can securely access their accounts" -t epic -p 1 --json bd create "User authentication system [root]" -t task -p 1 --json bd dep add <root-bead-id> <epic-id> -t parent-child