t274: Supervisor auto-decomposition of #plan tasks

[marcusquinn]

Summary

Implements supervisor auto-decomposition of #plan tasks in Phase 0. This closes the loop: plan → auto-decompose → auto-dispatch subtasks → workers execute → self-improving pipeline.

Changes

Strategy 3: #plan Task Detection (lines 12631-12691)

• Detects tasks with #plan tag AND → [todo/PLANS.md#anchor] reference
• Checks if task already has subtasks (e.g., t001.1, t001.2)
• Skips tasks that are already decomposed
• Extracts PLANS.md anchor from task line
• Adds task to supervisor with metadata: plan_anchor=...,needs_decomposition=true
• Immediately dispatches decomposition worker

dispatch_decomposition_worker Function (lines 12505-12591)

• Special worker with EXPLICIT permission to edit TODO.md
• Reads PLANS.md section using the extracted anchor
• Analyzes plan structure (phases, milestones, deliverables)
• Generates subtasks with:
  • Hierarchical IDs (t001.1, t001.2, etc.)
  • 2-space indentation
  • #auto-dispatch tags for autonomous execution
  • Estimates from plan
  • Dependencies (blocked-by:) for sequential phases
• Inserts subtasks immediately after parent task in TODO.md
• Commits directly to main (planning-only change)
• Logs to ~/.aidevops/logs/decomposition-worker-{task_id}.log

Integration with Existing Workflow

1. Phase 0 (Auto-Pickup): Now has 3 strategies:

   • Strategy 1: #auto-dispatch tagged tasks
   • Strategy 2: "Dispatch Queue" section tasks
   • Strategy 3 (NEW): #plan tasks without subtasks

2. Decomposition Worker:

   • Runs in background (non-blocking)
   • Uses Claude CLI for AI-powered decomposition
   • Tracks worker PID in supervisor metadata
   • Exception to worker TODO.md restriction (documented in prompt)

3. Auto-Dispatch Loop:

   • Plan task detected → decomposed into subtasks
   • Subtasks have #auto-dispatch → picked up by Strategy 1
   • Workers execute subtasks autonomously
   • Self-improving pipeline completes the loop

Testing

• ✅ Bash syntax validation (bash -n)
• ✅ ShellCheck validation (no violations)
• ✅ Verified detection patterns match existing TODO.md format
• ✅ Confirmed integration with existing Phase 0 strategies

Example Workflow

Before (manual decomposition required):

- [ ] t300 Email Testing Suite #plan → [todo/PLANS.md#2026-02-10-email-testing-suite] ~2h

After (automatic decomposition):

- [ ] t300 Email Testing Suite #plan → [todo/PLANS.md#2026-02-10-email-testing-suite] ~2h
  - [ ] t300.1 Email Design Test agent + helper script ~35m #auto-dispatch
  - [ ] t300.2 Email Delivery Test agent + helper script ~35m #auto-dispatch blocked-by:t300.1
  - [ ] t300.3 Email Health Check enhancements ~15m #auto-dispatch blocked-by:t300.2
  - [ ] t300.4 Cross-references + integration ~10m #auto-dispatch blocked-by:t300.3

Related

• Closes the loop described in t274
• Integrates with existing auto-dispatch (t128.5)
• Respects worker TODO.md restrictions (t173) with explicit exception
• Uses uncertainty decision framework (t176) in decomposition prompt

[gemini-code-assist]

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

[github-actions]

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 46 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Wed Feb 11 02:19:52 UTC 2026: Code review monitoring started
Wed Feb 11 02:19:53 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 46

📈 Current Quality Metrics

• BUGS: 0
• CODE SMELLS: 46
• VULNERABILITIES: 0

Generated on: Wed Feb 11 02:19:56 UTC 2026

---

Generated by AI DevOps Framework Code Review Monitoring

[github-actions]

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 46 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Wed Feb 11 02:21:15 UTC 2026: Code review monitoring started
Wed Feb 11 02:21:16 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 46

📈 Current Quality Metrics

• BUGS: 0
• CODE SMELLS: 46
• VULNERABILITIES: 0

Generated on: Wed Feb 11 02:21:19 UTC 2026

---

Generated by AI DevOps Framework Code Review Monitoring

[github-actions]

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 46 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Wed Feb 11 02:25:08 UTC 2026: Code review monitoring started
Wed Feb 11 02:25:09 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 46

📈 Current Quality Metrics

• BUGS: 0
• CODE SMELLS: 46
• VULNERABILITIES: 0

Generated on: Wed Feb 11 02:25:11 UTC 2026

---

Generated by AI DevOps Framework Code Review Monitoring

[github-actions]

🔍 Code Quality Report

�[0;35m[MONITOR]�[0m Code Review Monitoring Report

�[0;34m[INFO]�[0m Latest Quality Status:
SonarCloud: 0 bugs, 0 vulnerabilities, 46 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Wed Feb 11 02:26:28 UTC 2026: Code review monitoring started
Wed Feb 11 02:26:29 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 46

📈 Current Quality Metrics

• BUGS: 0
• CODE SMELLS: 46
• VULNERABILITIES: 0

Generated on: Wed Feb 11 02:26:32 UTC 2026

---

Generated by AI DevOps Framework Code Review Monitoring

[gemini-code-assist]

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[coderabbitai]

Warning

Rate limit exceeded

@marcusquinn has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 14 minutes and 27 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feature/t274

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}