fix: Enforce opencode run for headless dispatch — never use claude CLI

[marcusquinn]

Summary

• Adds explicit rule in AGENTS.md and pulse.md: ALWAYS use opencode run for dispatch, NEVER claude or claude -p
• Agents with a "Claude Code" system prompt identity repeatedly default to the wrong CLI, which silently fails
• This has been fixed before but keeps regressing — the new wording is direct and explains why the rule exists

Summary by CodeRabbit

• Documentation

  • Updated agent dispatch and worker execution guidelines with explicit standardized command-line interface requirements.

• Chores

  • Reinforced dispatch command rules across multiple configuration sections to improve system consistency, enhance reliability, and prevent potential execution failures during worker dispatch.

[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!

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 06c4893 and f119212.

📒 Files selected for processing (2)

• .agents/AGENTS.md
• .agents/scripts/commands/pulse.md

---

Walkthrough

This PR adds explicit dispatch rules to agent documentation files, mandating the use of opencode run CLI for worker dispatch operations while explicitly prohibiting claude and related CLI variants to prevent silent failures.

Changes

Cohort / File(s)	Summary
Dispatch Rule Enforcement .agents/AGENTS.md, .agents/scripts/commands/pulse.md	Added explicit rules requiring opencode run CLI for all worker dispatch operations and explicitly forbidding claude, claude -p, and other CLI variants to prevent silent failures. Rules inserted in headless/dispatch guidance sections with example snippets.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• t1160: Dual-CLI Architecture — OpenCode primary + Claude Code CLI fallback #2231: Implements dual-CLI architecture with opencode primary and claude fallback, directly contradicting this PR's enforcement of opencode-only dispatch.
• t1022: Make AGENTS.md tool-agnostic #1329: Modifies the same AGENTS.md dispatch/CLI guidance lines; this PR enforces "opencode run only" while that PR replaces OpenCode references, causing direct conflicts.
• t1283: Context optimisation pass 3 — tighten language across always-loaded files #2048: Updates AGENTS.md headless/dispatch guidance with wording preferences for opencode CLI, aligned with but predating this PR's explicit enforcement rules.

Suggested labels

needs-review

Poem

🎯 Dispatch with clarity, no ambiguity—
OpenCode runs the show, no Claude anomaly!
Silent failures banished with a rule so bright,
One CLI to rule them, one path done right.

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the main change: enforcing opencode run for headless dispatch and prohibiting claude CLI usage, which directly matches the modifications across both AGENTS.md and pulse.md.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch fix/dispatch-cli-identity

---

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.}

[augmentcode]

🤖 Augment PR Summary

Summary: Clarifies headless dispatch instructions to consistently use OpenCode’s runtime CLI.

Changes:

• Updates .agents/AGENTS.md and pulse.md to explicitly require opencode run and forbid claude/claude -p to prevent silent dispatch failures caused by prompt-identity regressions.

_{🤖 Was this summary useful? React with 👍 or 👎}

[augmentcode]

Review completed. No suggestions at this time.

Comment augment review to trigger a new review at any time.

[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, 90 code smells

�[0;34m[INFO]�[0m Recent monitoring activity:
Thu Feb 26 04:07:07 UTC 2026: Code review monitoring started
Thu Feb 26 04:07:08 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 90

📈 Current Quality Metrics

• BUGS: 0
• CODE SMELLS: 90
• VULNERABILITIES: 0

Generated on: Thu Feb 26 04:07:10 UTC 2026

---

Generated by AI DevOps Framework Code Review Monitoring

[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