Skip to content

fix: correct onboarding command path to root agent location#72

Merged
marcusquinn merged 1 commit intomainfrom
bugfix/fix-onboarding-command-path
Jan 13, 2026
Merged

fix: correct onboarding command path to root agent location#72
marcusquinn merged 1 commit intomainfrom
bugfix/fix-onboarding-command-path

Conversation

@marcusquinn
Copy link
Owner

@marcusquinn marcusquinn commented Jan 13, 2026

Summary

Problem

The /onboarding command failed with:

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

The command generator was pointing to the wrong path. onboarding.md is a main agent (located in root .agent/ directory), not a subagent.

Solution

Fix the path in generate-opencode-commands.sh:

-Read ~/.aidevops/agents/aidevops/onboarding.md
+Read ~/.aidevops/agents/onboarding.md

Why this is correct

  1. Main agents live in .agent/*.md (root level)
  2. Subagents live in .agent/{domain}/*.md (subdirectories)
  3. onboarding.md is listed in the "Main Agents" table in AGENTS.md
  4. Moving the file (PR fix: move onboarding.md to aidevops/ subfolder #71's approach) was architecturally wrong

Testing

  • ShellCheck passes on changed file
  • Path now matches actual file location

Summary by CodeRabbit

  • Chores
    • Updated onboarding configuration path reference to the correct location.

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

The /onboarding command was pointing to aidevops/onboarding.md but
onboarding.md is a main agent located in the root agents directory.

This fixes the 'File not found' error when running /onboarding after
setup.sh regenerates OpenCode commands.
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jan 13, 2026

Walkthrough

A shell script's onboarding instruction path reference is updated from a nested directory structure (~/.aidevops/agents/aidevops/onboarding.md) to a shallower one (~/.aidevops/agents/onboarding.md), reflecting a reorganization of the onboarding file location.

Changes

Cohort / File(s) Summary
Onboarding Path Update
\.agent/scripts/generate-opencode-commands.sh
Updated onboarding instruction file path reference from ~/.aidevops/agents/aidevops/onboarding.md to ~/.aidevops/agents/onboarding.md

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

  • feat: add /setup-aidevops command #11: Modifies the same script (.agent/scripts/generate-opencode-commands.sh) and touches command-generation and onboarding areas, suggesting coordinated changes to the onboarding workflow.

Poem

🛤️ A path grows shorter, cleaner too,
From /aidevops/aidevops/ through,
To /agents/ where it belongs,
One small line, yet fixes wrongs,
Navigation simplified anew! ✨

🚥 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 main change: correcting the onboarding command path from a nested subagent location to the root agent location.
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

📜 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 47c54fd and 3eb100b.

📒 Files selected for processing (1)
  • .agent/scripts/generate-opencode-commands.sh
🧰 Additional context used
📓 Path-based instructions (1)
.agent/scripts/*.sh

⚙️ CodeRabbit configuration file

.agent/scripts/*.sh: Automation scripts - focus on:

  • Reliability and robustness
  • Clear logging and feedback
  • Proper exit codes
  • Error recovery mechanisms

Files:

  • .agent/scripts/generate-opencode-commands.sh
🧠 Learnings (11)
📓 Common learnings
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: 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: 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
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
Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: AGENTS.md:0-0
Timestamp: 2026-01-06T15:57:56.027Z
Learning: Applies to **/setup.sh : Deploy agents locally using ./setup.sh script
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: 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/scripts/generate-opencode-commands.sh
📚 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/scripts/generate-opencode-commands.sh
📚 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/scripts/generate-opencode-commands.sh
📚 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/scripts/generate-opencode-commands.sh
📚 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/scripts/generate-opencode-commands.sh
📚 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/scripts/generate-opencode-commands.sh
📚 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/scripts/generate-opencode-commands.sh
📚 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/scripts/generate-opencode-commands.sh
📚 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 the helper script at ~/Git/aidevops/.agent/scripts/setup-local-api-keys.sh to manage secure storage of API keys rather than manual configuration

Applied to files:

  • .agent/scripts/generate-opencode-commands.sh
📚 Learning: 2025-12-22T01:25:03.138Z
Learnt from: CR
Repo: marcusquinn/aidevops PR: 0
File: templates/home/git/AGENTS.md:0-0
Timestamp: 2025-12-22T01:25:03.138Z
Learning: Use standardized patterns as defined in the authoritative DevOps repository at ~/Git/aidevops/

Applied to files:

  • .agent/scripts/generate-opencode-commands.sh
⏰ 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/scripts/generate-opencode-commands.sh (1)

994-994: Path correction is correct and complete.

The updated path correctly reflects that onboarding.md is a main agent located at the root agents directory. No stale references to the old path remain in the codebase, and the source file exists at .agent/onboarding.md. This aligns with the documented pattern where main agents live at the root and subagents in subdirectories.


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.

@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 addresses a critical file path error that prevented the /onboarding command from functioning correctly. By adjusting the path in the command generation script, the system now correctly locates the onboarding.md file, which is designated as a main agent. This ensures that new users can successfully initiate the onboarding process without encountering file not found errors, aligning the command's behavior with the intended agent architecture.

Highlights

  • Command Path Correction: The file path for the /onboarding command has been corrected from ~/.aidevops/agents/aidevops/onboarding.md to ~/.aidevops/agents/onboarding.md.
  • Error Resolution: This fix resolves a "File not found" error that occurred when attempting to use the /onboarding command due to an incorrect path.
  • Architectural Alignment: The change reinforces the architectural distinction that 'main agents' reside at the root level (e.g., .agent/*.md), while 'subagents' are located in subdirectories (e.g., .agent/{domain}/*.md).
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
Copy link

augmentcode bot commented Jan 13, 2026

🤖 Augment PR Summary

Summary: Fixes the generated /onboarding command to reference the correct main-agent location.

Changes:

  • Updated generate-opencode-commands.sh to read ~/.aidevops/agents/onboarding.md (root main agent) instead of the incorrect subagent path.

🤖 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. No suggestions at this time.

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

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

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

📈 Current Quality Metrics

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

Generated on: Tue Jan 13 21:48:52 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

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

This pull request correctly fixes a file path for the /onboarding command, resolving a bug where the command failed to find the onboarding.md file. The change is simple, direct, and well-explained in the pull request description. I have added one suggestion to improve the long-term maintainability and flexibility of the tool by making the agent's home directory path configurable instead of hardcoded.

---

Read ~/.aidevops/agents/aidevops/onboarding.md and follow its instructions.
Read ~/.aidevops/agents/onboarding.md and follow its instructions.

Choose a reason for hiding this comment

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

medium

While this change correctly fixes the path, the base path ~/.aidevops is hardcoded. This reduces flexibility for users who may need to store agent data in a different location (e.g., due to home directory restrictions or for organizational purposes).

To improve this, consider making the path configurable via an environment variable, such as AIDEVOPS_HOME, with the current path as a default. If the environment that executes this Read command supports shell-like expansion, you could implement this like so:

Read ${AIDEVOPS_HOME:-~/.aidevops}/agents/onboarding.md and follow its instructions.

Note that you might need to escape the $ in the generate-opencode-commands.sh script (i.e., \$) to ensure the variable is evaluated when the command is run, not when it's generated.

If this change is out of scope for this PR, I recommend creating a follow-up issue to address this architectural improvement.

@marcusquinn marcusquinn merged commit 488dc92 into main Jan 13, 2026
12 of 13 checks passed
@marcusquinn marcusquinn deleted the bugfix/fix-onboarding-command-path branch February 21, 2026 01:59
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