cyberneticlibrary

Break down requirements into tasks

breakdowncommandsetup L10
dougsillars/internationalConcierge
What it does

Break down requirement into AI-generated, sequenced tasks using BrainGrid CLI

Best for

Converting high-level requirements into parallel-ready tasks when work must be distributed across AI agents or developers with full context in each task prompt.

Inputs
  • · Requirement ID (REQ-123, req-456, or UUID)
  • · Git branch name (auto-detection fallback)
Outputs
  • · 5-20 tasks created in BrainGrid system
  • · Task-level prompts ready for AI coding tools
  • · Full task list with dependencies and acceptance criteria
  • · Markdown implementation plan
Requires
  • · BrainGrid CLI (@braingrid/cli)
  • · Git
  • · OAuth2 for BrainGrid authentication
Preconditions
  • · BrainGrid CLI installed and authenticated
  • · .braingrid/project.json initialized
  • · Requirement must exist in BrainGrid system
  • · Git branch present or requirement ID provided
Failure modes
  • · CLI not installed = 'command not found' error
  • · User not authenticated = OAuth2 login required
  • · Project not initialized = 'project.json not found' error
  • · Requirement not found = request to list available requirements
  • · Breakdown timeout after 3 minutes = rare, indicates API issue
Trust signals
  • · Auto-detects requirement ID from branch names (feature/REQ-123-description)
  • · Handles 3+ flexible ID formats (REQ-123, req-456, 789, UUID)
  • · Tasks include acceptance criteria, file ownership, and verification commands