Skip to content

fix: strip verbose workflow from /onboarding command prompt#714

Merged
marcusquinn merged 2 commits intomainfrom
bugfix/onboarding-command-cleanup
Feb 9, 2026
Merged

fix: strip verbose workflow from /onboarding command prompt#714
marcusquinn merged 2 commits intomainfrom
bugfix/onboarding-command-cleanup

Conversation

@marcusquinn
Copy link
Owner

@marcusquinn marcusquinn commented Feb 9, 2026

Summary

  • Strips the verbose 6-step workflow summary from the /onboarding command file, leaving only a single read instruction
  • The command file content is displayed by OpenCode as a visible prompt block — the old version dumped raw workflow instructions before the AI could process them
  • Now the AI reads onboarding.md silently and presents the interactive Welcome Flow (numbered choices) directly

Before (screenshot from user)

The /onboarding command showed a wall of raw workflow text (steps 1-6, bash code blocks) before the AI greeted the user with a simple yes/no question.

After

The command prompt shows a single clean instruction. The AI reads onboarding.md and follows its Welcome Flow — presenting the proper numbered-choice interactive conversation.

Related PRs

Summary by CodeRabbit

  • Documentation
    • Simplified onboarding instructions to streamline setup by directing users to the Welcome Flow instead of a detailed multi-step workflow.
    • Updated recommended AI coding agent from Claude Code to OpenCode and noted that OpenCode supports multiple AI providers.

The /onboarding command file contained a full 6-step workflow summary
that OpenCode displayed verbatim as the prompt block before the AI
processed it. This cluttered the first-run experience with raw
instructions instead of a clean interactive greeting.

Strip the command to a single read instruction pointing to
onboarding.md, which already contains the complete Welcome Flow.
The AI now reads onboarding.md silently and presents the interactive
numbered-choice conversation directly.
@gemini-code-assist
Copy link

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 9, 2026

Walkthrough

The PR simplifies onboarding text: it shortens the generated onboarding command content to reference the Welcome Flow, and replaces a recommendation of Claude Code with OpenCode in onboarding documentation.

Changes

Cohort / File(s) Summary
Onboarding command script
​.agents/scripts/generate-opencode-commands.sh
Removed a verbose multi-step onboarding workflow (~37 lines) and replaced it with a concise instruction to use the Welcome Flow from onboarding; preserved Arguments placeholder and EOF structure.
Onboarding documentation
​.agents/aidevops/onboarding.md
Replaced recommended AI coding agent from "Claude Code" to "OpenCode" and updated a descriptive sentence to note OpenCode supports multiple AI providers.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Poem

✨ Shorter lines, a clearer start,
Welcome Flow now plays its part,
OpenCode sings with broader scope,
Onboarding trimmed, we keep our hope,
Automation smiles — fresh and smart! 🚀

🚥 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: removing verbose workflow content from the /onboarding command prompt file, which aligns with the primary modification in generate-opencode-commands.sh.
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 unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch bugfix/onboarding-command-cleanup

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.

@github-actions
Copy link

github-actions bot commented Feb 9, 2026

🔍 Code Quality Report

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

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

�[0;34m[INFO]�[0m Recent monitoring activity:
Mon Feb 9 02:39:56 UTC 2026: Code review monitoring started
Mon Feb 9 02:39:57 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 45

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 45
  • VULNERABILITIES: 0

Generated on: Mon Feb 9 02:39:59 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

The onboarding Welcome Flow hardcoded 'Claude Code' and 'Claude.ai' as
the recommended tool. Since OpenCode supports multiple AI providers
(Zen, Anthropic, OpenAI, etc.), update the reference to OpenCode with
its correct URL and mention multi-provider support.
@github-actions
Copy link

github-actions bot commented Feb 9, 2026

🔍 Code Quality Report

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

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

�[0;34m[INFO]�[0m Recent monitoring activity:
Mon Feb 9 02:59:13 UTC 2026: Code review monitoring started
Mon Feb 9 02:59:14 UTC 2026: SonarCloud - Bugs: 0, Vulnerabilities: 0, Code Smells: 45

📈 Current Quality Metrics

  • BUGS: 0
  • CODE SMELLS: 45
  • VULNERABILITIES: 0

Generated on: Mon Feb 9 02:59:16 UTC 2026


Generated by AI DevOps Framework Code Review Monitoring

@sonarqubecloud
Copy link

sonarqubecloud bot commented Feb 9, 2026

coderabbitai[bot]
coderabbitai bot previously requested changes Feb 9, 2026
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In @.agents/aidevops/onboarding.md:
- Line 64: The onboarding line that lists providers ("OpenCode supports multiple
AI providers (Zen, Anthropic, OpenAI, and more)") includes an unverified
provider "Zen"; either remove "Zen" from that parenthetical list or verify and
cite OpenCode's current provider list before shipping. Update the string in
.agents/aidevops/onboarding.md where the "Recommended tool" paragraph references
providers to either omit "Zen" or replace it with a verified provider name (and
optionally add a parenthetical note like "75+ providers") so the example
accurately reflects OpenCode's supported providers.

aidevops gives your AI assistant superpowers for DevOps and infrastructure management.

**Recommended tool:** You should be running this in [Claude Code](https://Claude.ai/) - the recommended AI coding agent for aidevops. All features, agents, and workflows are designed and tested for Claude Code first. If you're using a different tool, most features will still work, but Claude Code provides the best experience.
**Recommended tool:** You should be running this in [OpenCode](https://opencode.ai/) - the recommended AI coding agent for aidevops. All features, agents, and workflows are designed and tested for OpenCode first. OpenCode supports multiple AI providers (Zen, Anthropic, OpenAI, and more) so you can use whichever model you prefer.
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🌐 Web query:

OpenCode AI coding assistant official website URL supported providers

💡 Result:

  • Official website (OpenCode): https://opencode.ai/ (opencode.ai)
  • Supported providers: OpenCode supports 75+ LLM providers via Models.dev / the AI SDK, plus local models. (opencode.ai)
    • Commonly documented providers include Anthropic, OpenAI, Groq, DeepSeek, GitHub Copilot, GitLab Duo, OpenRouter, Google Vertex AI, Amazon Bedrock, Azure OpenAI, and local providers like Ollama and LM Studio. (open-code.ai)

Citations:


Remove or verify "Zen" from the provider list.

The URL https://opencode.ai/ is correct, and the multi-provider support claim is accurate—OpenCode supports 75+ LLM providers including Anthropic and OpenAI. However, "Zen" cannot be verified in the official OpenCode documentation. Either remove it from the example list or verify it's a current supported provider before shipping this in first-run onboarding documentation.

🤖 Prompt for AI Agents
In @.agents/aidevops/onboarding.md at line 64, The onboarding line that lists
providers ("OpenCode supports multiple AI providers (Zen, Anthropic, OpenAI, and
more)") includes an unverified provider "Zen"; either remove "Zen" from that
parenthetical list or verify and cite OpenCode's current provider list before
shipping. Update the string in .agents/aidevops/onboarding.md where the
"Recommended tool" paragraph references providers to either omit "Zen" or
replace it with a verified provider name (and optionally add a parenthetical
note like "75+ providers") so the example accurately reflects OpenCode's
supported providers.

@marcusquinn marcusquinn dismissed coderabbitai[bot]’s stale review February 9, 2026 03:03

Zen is a verified OpenCode provider - visible in the OpenCode TUI footer. Bot suggestion is incorrect.

@marcusquinn marcusquinn merged commit 65ad2f0 into main Feb 9, 2026
14 of 15 checks passed
@marcusquinn marcusquinn deleted the bugfix/onboarding-command-cleanup 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