fix: move onboarding.md to aidevops/ subfolder

[alex-solovyev]

Summary

• Move .agent/onboarding.md to .agent/aidevops/onboarding.md
• Update AGENTS.md: remove from Main Agents table
• Update AGENTS.md: add to aidevops/ subagents list

Problem

The /onboarding command failed with:

Error: File not found: ~/.aidevops/agents/aidevops/onboarding.md

The command expected the file in aidevops/ subfolder, but it was in the root.

Solution

Move the file to match the expected path. This is the correct architectural decision because:

1. By function - onboarding is a wizard for setting up the aidevops framework, not a separate domain
2. By analogy - aidevops/ already contains similar files: setup.md, troubleshooting.md, mcp-integrations.md
3. By declaration - the file declares mode: subagent, not a main agent

Testing

• ./setup.sh deploys file to correct location
• /onboarding command path references correct file
• Old file location cleaned up

Summary by CodeRabbit

• Documentation
  • Reorganized agent documentation structure, reclassifying onboarding content under framework internals for improved navigation and discoverability.

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

[coderabbitai]

Walkthrough

This PR reclassifies onboarding documentation from a top-level agent entry to a subagent within the aidevops framework folder. The change involves removing one reference and adding another in the agent registry documentation, with no modifications to functional code or behavior.

Changes

Cohort / File(s)	Change Summary
Documentation Registry .agent/AGENTS.md	Moved onboarding from Main Agents table to Key Subagents under aidevops/ folder, restructuring agent hierarchy without functional impact

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

• docs: improve AGENTS.md progressive disclosure with descriptive hints #22: Also modifies .agent/AGENTS.md subagent classifications and structure; aligns with ongoing agent registry reorganization and Key Subagents categorization changes

Poem

📚 Onboarding takes flight,
From top shelf to nested height,
Under aidevops' care,
Where frameworks declare,
A cleaner agent sight! ✨

🚥 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 describes the primary change: moving onboarding.md to the aidevops/ subfolder, which aligns with the PR's main objective and the file reorganization detailed in AGENTS.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.}

---

📜 Recent review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between f889080 and 447ea7c.

📒 Files selected for processing (2)

• .agent/AGENTS.md
• .agent/aidevops/onboarding.md

🧰 Additional context used

🧠 Learnings (11)

📓 Common learnings

Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: CLAUDE.md:0-0
Timestamp: 2025-11-29T04:34:27.158Z
Learning: All instructions, documentation, and operational guidance should be maintained in AGENTS.md as the single source of truth

Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: GEMINI.md:0-0
Timestamp: 2025-11-29T04:34:30.742Z
Learning: Maintain all instructions, documentation, and operational guidance in AGENTS.md as the single source of truth

Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: AGENT.md:0-0
Timestamp: 2025-11-29T04:34:42.033Z
Learning: Reference AGENTS.md (authoritative) instead of AGENT.md for AI assistant guidance

Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: templates/home/AGENTS.md:0-0
Timestamp: 2025-12-22T01:24:53.937Z
Learning: Follow all security protocols and working directory specifications defined in ~/Git/aidevops/AGENTS.md

Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-01-06T15:57:56.027Z
Learning: Applies to **/AGENTS.md : Use progressive disclosure in AGENTS.md with pointers to subagents rather than inline content

Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: AGENT.md:0-0
Timestamp: 2025-11-29T04:34:42.033Z
Learning: Maintain all AI assistant instructions, documentation, and operational guidance in AGENTS.md as the single source of truth

📚 Learning: 2026-01-06T15:57:56.027Z

Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-01-06T15:57:56.027Z
Learning: Applies to **/AGENTS.md : Use progressive disclosure in AGENTS.md with pointers to subagents rather than inline content

Applied to files:

• .agent/AGENTS.md

📚 Learning: 2025-11-29T04:34:27.158Z

Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: CLAUDE.md:0-0
Timestamp: 2025-11-29T04:34:27.158Z
Learning: All instructions, documentation, and operational guidance should be maintained in AGENTS.md as the single source of truth

Applied to files:

• .agent/AGENTS.md

📚 Learning: 2025-11-29T04:34:42.033Z

Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: AGENT.md:0-0
Timestamp: 2025-11-29T04:34:42.033Z
Learning: Reference AGENTS.md (authoritative) instead of AGENT.md for AI assistant guidance

Applied to files:

• .agent/AGENTS.md

📚 Learning: 2025-11-29T04:34:30.742Z

Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: GEMINI.md:0-0
Timestamp: 2025-11-29T04:34:30.742Z
Learning: Maintain all instructions, documentation, and operational guidance in AGENTS.md as the single source of truth

Applied to files:

• .agent/AGENTS.md

📚 Learning: 2025-11-29T04:34:42.033Z

Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: AGENT.md:0-0
Timestamp: 2025-11-29T04:34:42.033Z
Learning: Maintain all AI assistant instructions, documentation, and operational guidance in AGENTS.md as the single source of truth

Applied to files:

• .agent/AGENTS.md

📚 Learning: 2026-01-06T15:57:56.027Z

Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-01-06T15:57:56.027Z
Learning: Applies to **/AGENTS.md : Limit root AGENTS.md to ~50-100 max instructions with universal applicability to >80% of tasks

Applied to files:

• .agent/AGENTS.md

📚 Learning: 2025-11-29T04:34:30.742Z

Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: GEMINI.md:0-0
Timestamp: 2025-11-29T04:34:30.742Z
Learning: Reference AGENTS.md for authoritative AI assistant guidance instead of GEMINI.md

Applied to files:

• .agent/AGENTS.md

📚 Learning: 2025-12-22T01:24:53.937Z

Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: templates/home/AGENTS.md:0-0
Timestamp: 2025-12-22T01:24:53.937Z
Learning: Follow all security protocols and working directory specifications defined in ~/Git/aidevops/AGENTS.md

Applied to files:

• .agent/AGENTS.md

📚 Learning: 2025-12-22T01:24:53.937Z

Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: templates/home/AGENTS.md:0-0
Timestamp: 2025-12-22T01:24:53.937Z
Learning: Reference the authoritative repository at ~/Git/aidevops/ for all detailed AI assistant instructions and configurations

Applied to files:

• .agent/AGENTS.md

📚 Learning: 2025-12-22T01:24:53.937Z

Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: templates/home/AGENTS.md:0-0
Timestamp: 2025-12-22T01:24:53.937Z
Learning: Use only the specified working directories: ~/.aidevops/.agent-workspace/work/[project]/ for work files, ~/.aidevops/.agent-workspace/tmp/ for temporary files, and ~/.aidevops/.agent-workspace/memory/ for persistent memory

Applied to files:

• .agent/AGENTS.md

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)

• GitHub Check: Codacy Static Code Analysis

🔇 Additional comments (1)

.agent/AGENTS.md (1)

372-372: Inconsistency between AI summary and visible changes.

The AI summary states "Removed onboarding.md from the Main Agents table" but no removal is visible in the Main Agents table (lines 349-365). The actual change shown here correctly adds "onboarding" to the aidevops/ subagents list, which aligns with the PR objective of moving the file to the aidevops/ subfolder.

The change itself is correct and follows progressive disclosure principles from the learnings.

---

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

[gemini-code-assist]

Summary of Changes

Hello @alex-solovyev, I'm Gemini Code Assist¹! 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 addresses a critical file path discrepancy that was causing the /onboarding command to fail. By relocating the onboarding.md document to its correct architectural position within the aidevops/ subfolder, the change ensures the command functions as intended. This move also improves the logical organization of documentation, aligning the file with other framework-internal resources and enhancing overall system consistency.

Highlights

• File Relocation: The onboarding.md file has been moved from .agent/onboarding.md to .agent/aidevops/onboarding.md to correct an architectural inconsistency and resolve a file not found error.
• Documentation Update: The AGENTS.md file has been updated to reflect the new location of onboarding.md, removing it from the main agents list and adding it to the aidevops/ subagents section.
• Command Fix: This change resolves an issue where the /onboarding command failed because it expected the onboarding.md file to be located within the aidevops/ subfolder.

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

[augmentcode]

🤖 Augment PR Summary

Summary: Moves the onboarding subagent doc to .agent/aidevops/onboarding.md to align with the path expected by the /onboarding command.
Docs: Updates .agent/AGENTS.md to remove onboarding from the main agents list and include it under the aidevops/ subagents.

_{🤖 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.

[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

[gemini-code-assist]

Code Review

This pull request correctly fixes a file path issue by moving onboarding.md into the aidevops/ subfolder and updating AGENTS.md accordingly. The changes are well-reasoned and directly address the bug described in the pull request description. The implementation is clean and correct. Excellent work!

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

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

📈 Current Quality Metrics

• BUGS: 0
• CODE SMELLS: 256
• VULNERABILITIES: 0

Generated on: Tue Jan 13 20:29:03 UTC 2026

---

Generated by AI DevOps Framework Code Review Monitoring

[marcusquinn]

Closing in favor of fixing the command generator path. The file should stay in root as a main agent; the bug is in generate-opencode-commands.sh pointing to the wrong path.