Skip to content

Conversation

@marcusquinn
Copy link
Owner

Summary

  • Add build-agent and agent-review to Plan+ subagents list
  • Enables agent design discussions during planning mode before implementation

Why

When users discuss agent design in Plan+ mode, they should have awareness of:

  • build-agent - Agent design patterns, instruction budgets, MCP config, progressive disclosure
  • agent-review - Systematic review checklist, improvement proposals, self-assessment triggers

Previously these subagents were only available in Build+ mode, but planning discussions often happen first.

Changes

  • .agent/plan-plus.md: Added new "Agent design" category with build-agent and agent-review subagents

Add build-agent and agent-review to Plan+ subagents list so users can
discuss agent design patterns during planning mode before implementation.
@gemini-code-assist
Copy link

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 integrates specialized agent design subagents, build-agent and agent-review, into the Plan+ mode. This enhancement allows for critical agent design considerations to be addressed earlier in the planning phase, providing users with relevant guidance on patterns, configurations, and review processes before development begins.

Highlights

  • Agent Design Subagents: The build-agent and agent-review subagents have been added to the Plan+ subagents list.
  • Enhanced Planning Discussions: This change enables agent design discussions to occur during the planning mode, prior to implementation, providing relevant guidance earlier in the development cycle.
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
Contributor

coderabbitai bot commented Jan 21, 2026

Warning

Rate limit exceeded

@marcusquinn has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 28 minutes and 15 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.

📥 Commits

Reviewing files that changed from the base of the PR and between 08013bd and f0e8795.

📒 Files selected for processing (1)
  • .agent/plan-plus.md

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.

@sonarqubecloud
Copy link

@github-actions
Copy link

🔍 Code Quality Report

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

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

�[0;34m[INFO]�[0m Recent monitoring activity:
Wed Jan 21 01:06:12 UTC 2026: Code review monitoring started
Wed Jan 21 01:06:13 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 324
Wed Jan 21 01:06:13 UTC 2026: Qlty - 0 issues found, auto-formatting applied
Wed Jan 21 01:06:15 UTC 2026: Codacy analysis completed with auto-fixes

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 324
  • VULNERABILITIES: 0

Generated on: Wed Jan 21 01:06:56 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

@marcusquinn marcusquinn merged commit 6c88edd into main Jan 21, 2026
9 checks passed
Copy link

@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

The pull request effectively integrates build-agent and agent-review into the Plan+ subagents list, creating a new "Agent design" category within .agent/plan-plus.md. This enhancement directly supports the stated goal of facilitating agent design discussions earlier in the planning phase. The changes are well-formatted and maintain consistency with the existing structure of the markdown file.

@augmentcode
Copy link

augmentcode bot commented Jan 21, 2026

🤖 Augment PR Summary

Summary: Exposes agent-design guidance during Plan+ so planning discussions can reference agent composition patterns and review checklists before implementation.

Changes:

  • Added an Agent design section to Plan+ subagents with build-agent and agent-review.

🤖 Was this summary useful? React with 👍 or 👎

Copy link

@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. 2 suggestions posted.

Fix All in Augment

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

- best-practices
# Agent design
- build-agent
- agent-review
Copy link

Choose a reason for hiding this comment

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

agent-review is write/edit-capable, and OpenCode subagents don’t inherit the parent agent’s permission restrictions; adding it to Plan+ could unintentionally re-enable non-planning writes unless Plan+ can’t spawn/call it or permissions are constrained elsewhere.

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎

- code-standards
- best-practices
# Agent design
- build-agent
Copy link

Choose a reason for hiding this comment

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

build-agent’s frontmatter doesn’t declare a tools: block, so its actual capabilities may differ from what Plan+ expects (and from guidance in the build-agent docs that subagents should declare tool permissions).

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎

marcusquinn added a commit that referenced this pull request Jan 21, 2026
- feat: add readme-helper.sh for dynamic count management (#131)
- feat(plan-plus): add agent design subagents for planning discussions (#132)
- docs: improve README maintainability and add AI-CONTEXT block (#130)

Also fixes version-manager.sh to accept dynamic GitHub release badges.
marcusquinn added a commit that referenced this pull request Jan 21, 2026
…132)

Add build-agent and agent-review to Plan+ subagents list so users can
discuss agent design patterns during planning mode before implementation.
marcusquinn added a commit that referenced this pull request Jan 21, 2026
- feat: add readme-helper.sh for dynamic count management (#131)
- feat(plan-plus): add agent design subagents for planning discussions (#132)
- docs: improve README maintainability and add AI-CONTEXT block (#130)

Also fixes version-manager.sh to accept dynamic GitHub release badges.
marcusquinn added a commit that referenced this pull request Jan 21, 2026
* docs: improve README maintainability and add AI-CONTEXT block

- Remove hardcoded version badge (2.66.0) - use dynamic GitHub release badge
- Remove hardcoded lines of code badge - goes stale quickly
- Add AI-CONTEXT block with quick reference for AI assistants
- Fix Architecture section: remove duplicates, add proper structure
- Update MCP badge to 20+ (approximate count)

These changes follow maintainability guidelines from workflows/readme-create-update.md

* fix: update version validator to accept dynamic GitHub release badge

The validator now recognizes the dynamic GitHub release badge
(img.shields.io/github/v/release) as the preferred approach over
hardcoded version badges that go stale.

This aligns with README maintainability guidelines that recommend
avoiding hardcoded counts and versions.

* fix: use approximate counts in AI-CONTEXT and Architecture sections

Address CodeRabbit review feedback:
- Change '14 main agents' to '~15 main agents' (approximate)
- Change '130+ helper scripts' to '100+ helper scripts' (round number)

This ensures counts remain accurate longer without frequent updates.

* style: use h3 headings in AI-CONTEXT block for better semantic structure

Address Gemini Code Assist feedback:
- Change 'Key Commands' from bold to ### heading
- Change 'Agent Structure' from bold to ### heading

This improves machine readability and semantic consistency.

* fix: make remaining agent count approximate

Missed one hardcoded '14 domain agents' at line 892.
Changed to '~15 domain agents' for consistency.

* 🤖 AUTO-FIX: Apply code quality improvements

  ✅ AUTOMATED FIXES:
  - Applied Qlty auto-formatting
  - Fixed common shellcheck issues
  - Updated code quality standards

  🔍 ANALYSIS:
  - SonarCloud: 323 code smells
  - Codacy: Analysis completed
  - Qlty: Auto-formatting applied

  Generated by: GitHub Actions Code Review Monitoring

* feat(plan-plus): add agent design subagents for planning discussions (#132)

Add build-agent and agent-review to Plan+ subagents list so users can
discuss agent design patterns during planning mode before implementation.

* feat: add readme-helper.sh for dynamic count management (#131)

* feat: add readme-helper.sh for dynamic count management

- New script: readme-helper.sh with commands:
  - counts: Show current agent/script counts
  - check: Verify if README counts are stale
  - update: Update README counts (with --apply flag)

- Updated full-loop.md: Added README check step for aidevops repo
- Updated readme-create-update.md: Added dynamic counts guidance
- Updated readme.md command: Added helper script reference

This enables automated README maintenance and prevents count staleness.

* fix: address review feedback for readme-helper.sh

- Remove unnecessary SC2034 shellcheck disable (Gemini feedback)
- Add caching for count functions to avoid repeated find calls (Gemini)
- Guard for missing directories, return 0 instead of failing (Augment)
- Align rounding logic between check and update commands (Augment)
  - Both now use round_scripts() and round_subagents() functions
  - Consistent output: 150+ subagents, 130+ scripts

* style: add blank lines before fenced code blocks

Fix Codacy markdown linting issues in full-loop.md and readme-create-update.md

* 🤖 AUTO-FIX: Apply code quality improvements

  ✅ AUTOMATED FIXES:
  - Applied Qlty auto-formatting
  - Fixed common shellcheck issues
  - Updated code quality standards

  🔍 ANALYSIS:
  - SonarCloud: 324 code smells
  - Codacy: Analysis completed
  - Qlty: Auto-formatting applied

  Generated by: GitHub Actions Code Review Monitoring

* chore(release): bump version to 2.67.0

- feat: add readme-helper.sh for dynamic count management (#131)
- feat(plan-plus): add agent design subagents for planning discussions (#132)
- docs: improve README maintainability and add AI-CONTEXT block (#130)

Also fixes version-manager.sh to accept dynamic GitHub release badges.

* 🤖 AUTO-FIX: Apply code quality improvements

  ✅ AUTOMATED FIXES:
  - Applied Qlty auto-formatting
  - Fixed common shellcheck issues
  - Updated code quality standards

  🔍 ANALYSIS:
  - SonarCloud: 328 code smells
  - Codacy: Analysis completed
  - Qlty: Auto-formatting applied

  Generated by: GitHub Actions Code Review Monitoring

* fix: consolidate version validation to single source of truth (#133)

- Update validate-version-consistency.sh with aidevops.sh, package.json, marketplace.json checks
- Refactor version-manager.sh to call standalone validator instead of duplicate logic
- Add validation after marketplace.json sed update to catch silent failures
- Update auto-version-bump.sh with complete file list

Fixes issue where version-manager.sh had its own validation logic that
drifted from validate-version-consistency.sh (used by CI), causing
release v2.67.0 to fail initially when PR #130 updated only the
standalone script.

* docs: add changelog entry for version validation fix

* chore(release): bump version to 2.67.1

* 🤖 AUTO-FIX: Apply code quality improvements

  ✅ AUTOMATED FIXES:
  - Applied Qlty auto-formatting
  - Fixed common shellcheck issues
  - Updated code quality standards

  🔍 ANALYSIS:
  - SonarCloud: 328 code smells
  - Codacy: Analysis completed
  - Qlty: Auto-formatting applied

  Generated by: GitHub Actions Code Review Monitoring

* fix: handle dynamic GitHub release badge in version-manager.sh (#134)

The README.md now uses a dynamic GitHub release badge instead of a
hardcoded version badge. The version-manager.sh was still trying to
update the hardcoded badge and failing when it wasn't found, which
caused it to return early before updating marketplace.json.

Changes:
- Check for dynamic badge (img.shields.io/github/v/release) first
- Skip README update if dynamic badge is used (GitHub handles it)
- Only update hardcoded badge if present
- Warn if no version badge found (non-fatal)

This fixes the issue where marketplace.json wasn't being updated
during releases because the README validation failed first.

* docs: add changelog entry for dynamic badge fix

* chore(release): bump version to 2.67.2

* docs: add /add-skill command to README

- Add /add-skill to Meta/Improvement slash commands table
- Add 'Importing External Skills' section under Cross-Tool Compatibility
- Document supported formats (SKILL.md, AGENTS.md, .cursorrules)
- Document features (conflict detection, version tracking, symlinks)

* style: add blank line before heading in CHANGELOG (MD022)

---------

Co-authored-by: GitHub Action <action@github.com>
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