docs: runner templates and parallel vs sequential guide (t109.5)#353
docs: runner templates and parallel vs sequential guide (t109.5)#353marcusquinn merged 1 commit intomainfrom
Conversation
Create example runner AGENTS.md templates for code-reviewer and seo-analyst with structured output formats, checklists, and usage examples. Add parallel vs sequential decision guide with decision table and hybrid pattern to headless-dispatch.md. - .agent/tools/ai-assistants/runners/code-reviewer.md - .agent/tools/ai-assistants/runners/seo-analyst.md - .agent/tools/ai-assistants/runners/README.md - Parallel vs sequential section in headless-dispatch.md - AGENTS.md progressive disclosure table updated - README.md updated with template links
|
Warning Rate limit exceeded
⌛ How to resolve this issue?After the wait time has elapsed, a review can be triggered using the 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)
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. Comment |
Summary of ChangesHello @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 significantly enhances the documentation and usability of the AI assistant framework by providing practical, ready-to-use templates for common agent roles like code review and SEO analysis. It also introduces a crucial decision-making guide for orchestrating agent tasks, helping users effectively choose between parallel and sequential execution patterns to optimize performance and manage dependencies. These additions aim to streamline the creation and deployment of AI agents and improve overall workflow efficiency. Highlights
Changelog
Activity
Using Gemini Code AssistThe 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
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 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
|
🔍 Code Quality Report�[0;35m[MONITOR]�[0m Code Review Monitoring Report �[0;34m[INFO]�[0m Latest Quality Status: �[0;34m[INFO]�[0m Recent monitoring activity: 📈 Current Quality Metrics
Generated on: Thu Feb 5 22:44:59 UTC 2026 Generated by AI DevOps Framework Code Review Monitoring |
|
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request adds comprehensive documentation for parallel agent execution and runner templates. It introduces a guide to decide between parallel and sequential patterns, provides example runner templates for a code reviewer and an SEO analyst, and updates existing documentation to link to these new resources. The changes are well-structured and significantly improve the documentation for these advanced features. I've made a couple of minor suggestions to improve consistency and clarity in the documentation.
| runner-helper.sh run security-reviewer "Audit src/" --attach :4096 & | ||
| runner-helper.sh run perf-analyzer "Profile src/" --attach :4096 & |
There was a problem hiding this comment.
For consistency with other examples in this file (e.g., line 501) and the main README.md, it's better to use the full URL http://localhost:4096 for the --attach flag. While :4096 might work, using the explicit URL improves clarity for users following the documentation.
| runner-helper.sh run security-reviewer "Audit src/" --attach :4096 & | |
| runner-helper.sh run perf-analyzer "Profile src/" --attach :4096 & | |
| runner-helper.sh run security-reviewer "Audit src/" --attach http://localhost:4096 & | |
| runner-helper.sh run perf-analyzer "Profile src/" --attach http://localhost:4096 & |
| |----------|-----------|-------|-----| | ||
| | CRITICAL | src/auth.ts:42 | Raw SQL query with string interpolation | Use parameterized query | | ||
| | WARNING | src/api.ts:15 | Missing input validation on user ID | Add zod schema validation | | ||
| | INFO | src/utils.ts:88 | Function exceeds 60 lines | Extract helper functions | |
There was a problem hiding this comment.
The "Maintainability" checklist on line 43 flags functions longer than 50 lines. To maintain consistency within this template, the example in the output format should also reflect that rule.
| | INFO | src/utils.ts:88 | Function exceeds 60 lines | Extract helper functions | | |
| | INFO | src/utils.ts:88 | Function exceeds 50 lines | Extract helper functions | |
1 participant
Summary
New Files
.agent/tools/ai-assistants/runners/README.md- Index and guide for creating runners from templates.agent/tools/ai-assistants/runners/code-reviewer.md- Security/quality review template with severity table output.agent/tools/ai-assistants/runners/seo-analyst.md- SEO analysis template with issue/opportunity tablesModified Files
.agent/tools/ai-assistants/headless-dispatch.md- Added "Parallel vs Sequential" section with decision table, hybrid pattern, and runner template links.agent/AGENTS.md- Added parallel agents row to progressive disclosure tableREADME.md- Added template links to parallel agents sectionTask
Closes t109.5 (Documentation & examples) from t109 (Parallel Agents & Headless Dispatch)
This completes the t109 plan: t109.1 (dispatch docs), t109.2 (runner-helper.sh), t109.3 (memory namespaces), t109.5 (documentation & examples) are all done. Only t109.4 (Matrix bot, optional) remains.