Skip to content

fix: update deprecated Plan+ agent references to Build+#229

Merged
marcusquinn merged 4 commits intomainfrom
fix/deprecate-plan-plus-agent-refs
Jan 25, 2026
Merged

fix: update deprecated Plan+ agent references to Build+#229
marcusquinn merged 4 commits intomainfrom
fix/deprecate-plan-plus-agent-refs

Conversation

@marcusquinn
Copy link
Copy Markdown
Owner

@marcusquinn marcusquinn commented Jan 25, 2026

Summary

  • Fix list-todo, save-todo, and show-plan commands that were broken because they referenced the deprecated Plan+ primary agent in their frontmatter
  • Update all remaining stale Plan+ references across 9 files to use Build+ (the unified agent) or @plan-plus (the subagent) as appropriate
  • Preserve historical references in TODO.md, PLANS.md, and CHANGELOG.md

Context

PR #226 consolidated Plan+ and AI-DevOps into Build+ as the unified coding agent. However, several files still referenced Plan+ as a primary agent, causing the /list-todo command (and other planning commands) to error out when trying to route to a non-existent primary agent.

Changes

File Change
list-todo.md agent: Plan+agent: Build+
save-todo.md agent: Plan+agent: Build+
show-plan.md agent: Plan+agent: Build+
conversation-starter.md Updated section headers and agent references
add-new-mcp-to-aidevops.md Removed Plan+ from primary agent lists
troubleshooting.md Updated test examples
context-guardrails.md Reference @plan-plus subagent
opencode.md Updated examples and config references
README.md Updated agent structure description

Not Changed (Intentionally)

  • plan-plus.md - Already correctly describes itself as a subagent
  • architecture.md - Historical context ("consolidates the former Plan+") is accurate
  • onboarding.md - Already uses correct @plan-plus subagent reference
  • TODO.md, PLANS.md, CHANGELOG.md - Historical records preserved

Summary by CodeRabbit

  • Documentation

    • Updated agent listings, examples, and guides to present @plan-plus as a planning-only subagent and Build+ as the default planner/implementer; expanded implementation task guidance and added Documentation Review.
  • Configuration

    • Swapped examples and templates to use Build+ in command/testing scenarios; @plan-plus shown as optional/read-only.
  • Troubleshooting & Commands

    • Updated test invocation examples and command metadata to reference Build+ instead of Plan+.

✏️ Tip: You can customize this high-level summary in your review settings.

Plan+ was consolidated into Build+ (PR #226) but several files still
referenced Plan+ as a primary agent. This caused the list-todo command
to fail by routing to a non-existent primary agent.

Changes:
- list-todo, save-todo, show-plan: agent frontmatter Plan+ → Build+
- conversation-starter: Plan+ section → Build+ deliberation mode
- add-new-mcp-to-aidevops: remove Plan+ from primary agent lists
- troubleshooting, opencode: update test examples to Build+
- context-guardrails: reference @plan-plus subagent instead
- README: update agent structure description

Historical references in TODO.md, PLANS.md, CHANGELOG.md preserved.
plan-plus.md (the subagent itself) left unchanged - already correct.
@gemini-code-assist
Copy link
Copy Markdown

Summary of Changes

Hello @marcusquinn, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request refines the agent architecture by updating references to the Plan+ agent, which was previously consolidated into Build+. The changes ensure that commands relying on the Plan+ agent now correctly route to Build+, and that documentation and configuration consistently reflect Build+ as the unified primary agent and @plan-plus as its dedicated subagent for planning-only tasks. This resolves functional issues and improves clarity following the agent consolidation.

Highlights

  • Command Fixes: Resolved issues with list-todo, save-todo, and show-plan commands by updating their primary agent reference from Plan+ to Build+.
  • Agent Reference Unification: Standardized agent references across 9 files, replacing deprecated Plan+ with Build+ for primary agent roles and @plan-plus for subagent roles.
  • Historical Preservation: Ensured that historical records in TODO.md, PLANS.md, and CHANGELOG.md retain their original Plan+ references where appropriate.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Jan 25, 2026

Note

Other AI code review bot(s) detected

CodeRabbit has detected other AI code review bot(s) in this pull request and will avoid duplicating their findings in the review comments. This may lead to a less comprehensive review.

Walkthrough

Plan+ is demoted from a main agent to a planning-only subagent named @plan-plus. Documentation, command front-matter, and generation scripts were updated to reference @plan-plus and to reassign command/testing responsibilities to Build+.

Changes

Cohort / File(s) Summary
Agent Add-MCP Documentation
​.agent/aidevops/add-new-mcp-to-aidevops.md
Removed Plan+ from main agents list; introduced @plan-plus as a planning-only subagent (Optional); removed Plan+ from the generate-opencode-agents.sh snippet.
Troubleshooting & Context Docs
​.agent/aidevops/troubleshooting.md, ​.agent/tools/context/context-guardrails.md
Switched helper test invocation and examples from Plan+ to Build+; clarified guardrail wording to mention @plan-plus subagent/read-only contexts.
Agent Command Front-Matter
​.agent/scripts/commands/list-todo.md, ​.agent/scripts/commands/save-todo.md, ​.agent/scripts/commands/show-plan.md
Updated front-matter agent values from Plan+Build+.
OpenCode / Opencode Tools
​.agent/tools/opencode/opencode.md
Replaced Plan+ references with Build+ in test/permission examples; renamed Plan+ read-only subsections/JSON keys to @plan-plus.
Conversation / Workflow Docs
​.agent/workflows/conversation-starter.md
Replaced Plan+ prompts/labels with Build+ (now “Build+ deliberation mode”); added Documentation Review and a detailed Implementation (Build+) task list and guidance.
Agent Generation Script & README
​.agent/scripts/generate-opencode-agents.sh, README.md
Adjusted generate script messaging to present Plan+/AI-DevOps as subagents; updated README agent table to list @plan-plus as a planning-only subagent and indicate Build+ handles planning by default.

Sequence Diagram(s)

(omitted — changes are documentation/configuration and do not introduce multi-component control-flow.)

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~9 minutes

Possibly related PRs

Poem

🛠️ Plan+ now wears a subtler name, @plan-plus in the crew,
Build+ takes the planning wheel and charts the work anew.
Docs updated, scripts aligned, front-matter sings in tune,
Subagents hush, commands march on — DevOps hums to its rune. ✨

🚥 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 clearly and accurately summarizes the main change: updating deprecated Plan+ references to Build+, which aligns with the PR's core objective.
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 docstrings

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

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

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request effectively addresses the deprecation of the Plan+ agent by replacing its references with Build+ or @plan-plus as appropriate. The changes are consistent across all modified files, fixing broken commands and updating documentation to reflect the new agent architecture. I have one minor suggestion to improve the clarity of the agent structure description in the README.md file.

README.md Outdated
### Agent Structure

- 15 primary agents (Plan+, Build+, SEO, Marketing, etc.)
- 15 primary agents (Build+, SEO, Marketing, etc.) with @plan-plus subagent for planning-only mode
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

This line states there are '15 primary agents', but with the removal of Plan+ (a primary agent) and the clarification that @plan-plus is a subagent, this count is no longer accurate for primary agents. The table on line 1239 lists 15 agents in total, including @plan-plus. To improve clarity and avoid confusion for users, I suggest removing the specific count from this summary line.

Suggested change
- 15 primary agents (Build+, SEO, Marketing, etc.) with @plan-plus subagent for planning-only mode
- Primary agents (Build+, SEO, Marketing, etc.) with @plan-plus subagent for planning-only mode

@github-actions
Copy link
Copy Markdown
Contributor

🔍 Code Quality Report

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

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

�[0;34m[INFO]�[0m Recent monitoring activity:
Sun Jan 25 22:21:09 UTC 2026: Code review monitoring started
Sun Jan 25 22:21:09 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 447
Sun Jan 25 22:21:10 UTC 2026: Qlty - 0 issues found, auto-formatting applied
Sun Jan 25 22:21:12 UTC 2026: Codacy analysis completed with auto-fixes

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 447
  • VULNERABILITIES: 0

Generated on: Sun Jan 25 22:22:36 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

@augmentcode
Copy link
Copy Markdown

augmentcode bot commented Jan 25, 2026

🤖 Augment PR Summary

Summary: Replaces deprecated Plan+ primary-agent references with Build+/@plan-plus to prevent broken agent routing.

Changes:

  • Fixes planning slash commands (list-todo, save-todo, show-plan) by pointing them at Build+.
  • Updates OpenCode/MCP/guardrail/docs examples to use Build+ or @plan-plus as appropriate.
  • Intentionally preserves historical mentions in archival planning/changelog docs.

🤖 Was this summary useful? React with 👍 or 👎

Copy link
Copy Markdown

@augmentcode augmentcode bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review completed. 3 suggestions posted.

Fix All in Augment

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


# Test agent permissions
~/.aidevops/agents/scripts/opencode-test-helper.sh test-agent Plan+
~/.aidevops/agents/scripts/opencode-test-helper.sh test-agent Build+
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This doc now shows opencode-test-helper.sh test-agent Build+, but the helper script’s own show_help() examples still reference test-agent Plan+, which can lead to conflicting guidance. Consider aligning the examples so users aren’t unsure which agent name is expected.

Other Locations
  • .agent/aidevops/troubleshooting.md:251

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎

| Name | File | Purpose | MCPs Enabled |
|------|------|---------|--------------|
| Plan+ | `plan-plus.md` | Planning with semantic search, writes to TODO.md/todo/ | context7, augment, repomix |
| @plan-plus | `plan-plus.md` | Planning-only subagent (Build+ handles planning by default) | context7, augment, repomix |
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the “Main Agents” table, the @plan-plus row is described as a “subagent”, which conflicts with the section label (and the earlier “primary agents … with @plan-plus subagent” line). Consider clarifying whether @plan-plus is meant to be tab-selectable as a main agent or only @mentionable.

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎

>
> **Main Agents Available**:
> Plan+, Build+, Accounts, AI-DevOps, Content, Health, Legal, Marketing,
> Build+, Accounts, AI-DevOps, Content, Health, Legal, Marketing,
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This prompt asks about “main agents and subagents”, but the “Main Agents Available” list no longer includes the planning-only option that’s referenced later as @plan-plus, which makes the example a bit inconsistent for enablement decisions. Consider either listing @plan-plus under subagents here or adjusting the wording to match the list.

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎

@github-actions
Copy link
Copy Markdown
Contributor

🔍 Code Quality Report

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

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

�[0;34m[INFO]�[0m Recent monitoring activity:
Sun Jan 25 22:24:25 UTC 2026: Code review monitoring started
Sun Jan 25 22:24:25 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 447
Sun Jan 25 22:24:26 UTC 2026: Qlty - 0 issues found, auto-formatting applied
Sun Jan 25 22:24:28 UTC 2026: Codacy analysis completed with auto-fixes

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 447
  • VULNERABILITIES: 0

Generated on: Sun Jan 25 22:25:51 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

…rID TypeError

OpenCode iterates all agent entries and tries to resolve model.providerID
even for disabled agents. Since Plan+ and AI-DevOps have no model config,
this causes: TypeError: undefined is not an object (evaluating 'input.model.providerID')

Fix: Stop emitting {"disable": true} entries for Plan+ and AI-DevOps in
the generator script. They exist only as subagents (@plan-plus, @AIDevops)
and don't need primary agent entries at all. OpenCode's built-in build/plan
agents still need disable entries since they'd otherwise appear by default.
@github-actions
Copy link
Copy Markdown
Contributor

🔍 Code Quality Report

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

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

�[0;34m[INFO]�[0m Recent monitoring activity:
Sun Jan 25 22:33:39 UTC 2026: Code review monitoring started
Sun Jan 25 22:33:39 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 447
Sun Jan 25 22:33:39 UTC 2026: Qlty - 0 issues found, auto-formatting applied
Sun Jan 25 22:33:41 UTC 2026: Codacy analysis completed with auto-fixes

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 447
  • VULNERABILITIES: 0

Generated on: Sun Jan 25 22:35:05 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

The providerID TypeError is not caused by disabled agent entries.
Reverting to original behavior while investigating the actual cause.
@sonarqubecloud
Copy link
Copy Markdown

@github-actions
Copy link
Copy Markdown
Contributor

🔍 Code Quality Report

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

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

�[0;34m[INFO]�[0m Recent monitoring activity:
Sun Jan 25 22:38:58 UTC 2026: Code review monitoring started
Sun Jan 25 22:38:58 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 447
Sun Jan 25 22:38:58 UTC 2026: Qlty - 0 issues found, auto-formatting applied
Sun Jan 25 22:39:00 UTC 2026: Codacy analysis completed with auto-fixes

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 447
  • VULNERABILITIES: 0

Generated on: Sun Jan 25 22:40:28 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant