TDD Development Orchestrator

VerifiedSafe

Orchestrates TDD-based development workflow with test-first planning, Obsidian vault storage, and sequential execution with status tracking. Acts as project manager delegating tasks to specialized agents.

Sby Skills Guide Bot
DevelopmentAdvanced
406/2/2026
Claude Code
#tdd#workflow#project-management#test-first

Recommended for

Our review

Orchestrates a TDD-based development workflow from planning to execution, with step splitting, Obsidian vault saving, and delegation to specialized agents.

Strengths

  • Structured TDD planning (Red → Green → Refactor)
  • Automatic breakdown into trackable steps
  • Task delegation to agents via tmux commands
  • Progress tracking via a YAML workflow file

Limitations

  • Requires tmux setup and specialized agents (plan-on-md, plan-steps-split, proceed-by-step)
  • Relies on user confirmation for delegated steps
  • Does not handle conflicts or mid‑course bug fixes
When to use it

When you need to enforce a rigorous TDD workflow with progress tracking and delegation for a complex feature.

When not to use it

For quick changes or simple fixes that don’t warrant planning and step splitting.

Security analysis

Safe
Quality score80/100

The skill only uses tmux commands to delegate tasks to other agents and creates a local YAML file with hardcoded content. Branch name derivation extracts a numeric identifier, avoiding injection. No destructive, exfiltrating, or obfuscated actions.

No concerns found

Examples

Plan a new feature with TDD
Implement a user authentication module using TDD. Create a plan with Red-Green-Refactor steps.
Save approved plan to Obsidian
Save the approved TDD plan to my Obsidian vault using the /plan-on-md tool.
Execute steps sequentially
Execute the planned TDD steps one by one using /proceed-by-step.

name: dev description: Orchestrate TDD-based development workflow – plan with test-first approach, save to Obsidian vault, split into trackable steps, and execute sequentially with status tracking. Acts as project manager, delegating tasks to specialized agents. allowed-tools: Bash(tmux:*)

Dev orchestrator

要件と簡単な仕様を元にTDDベースの計画を作成し、各stepに分割する。stepごとに実行し、完全な実装を目指す。

Requirements

  • Follow user's instructions ($ARGUMENTS)
  • Your main role is the project manager so assign tasks to other agents as far as possible

Procedure

  1. Setup: Initialize workflow state

    • Derive {branch_name} from current git branch (same rule as plan-on-md: feature/#468468)
    • Create docs/{branch_name}/dev-workflow.yaml:
      save:
        status: Ready
      split:
        status: Pending
      execute:
        status: Pending
      
    • This MUST be done BEFORE entering plan mode
  2. Plan (execute yourself): Create TDD implementation plan using EnterPlanMode

    • Follow the TDD structure defined in tdd-plan.md — Red → Green → Refactor order
    • Get user approval via ExitPlanMode
  3. Save: Store the approved plan in Obsidian vault

    • Update YAML: save: In progress
    • Use tmux list-panes to find an available shell pane
    • Send: tmux send-keys -t <pane> 'claude "/plan-on-md"' Enter
    • Tell the user: "plan-on-md を別ペインに委譲しました。完了したら教えてください"
    • User confirms completion → Update YAML: save: Done, split: In progress
  4. Split: Break the plan into individual step files

    • Send: tmux send-keys -t <pane> 'claude "/plan-steps-split"' Enter
    • Tell the user: "plan-steps-split を別ペインに委譲しました。完了したら教えてください"
    • User confirms completion → Update YAML: split: Done, execute: In progress
  5. Execute: Run steps sequentially

    • Send: tmux send-keys -t <pane> 'claude "/proceed-by-step"' Enter
    • Tell the user: "proceed-by-step を別ペインに委譲しました。完了したら教えてください"
    • User confirms completion → Update YAML: execute: Done

IMPORTANT: Workflow State

A PreToolUse hook reads docs/{branch_name}/dev-workflow.yaml and injects the current workflow phase. The hook finds the first phase with status: Ready and directs you to execute that phase. After plan approval, your NEXT action is determined by the YAML status, not by implementing code directly. Status values follow status.md: Ready / In progress / In review / Pending / Done

Related skills