fix: clarify onboarding across tool syntax, workflows, and delivery

[alfred-openspec]

Summary\n- make onboarding guidance tool-aware, profile-aware, and delivery-aware across init, update, and migration flows\n- fix first-run docs and welcome copy so the default core workflow is clear and command syntax is explained upfront\n- add tests for the new onboarding guidance helper and updated CLI messaging\n\n## Why\nOPE-20 is an onboarding trust issue across supported integrations, not just an OpenCode docs mismatch. This PR makes the default workflow set, command syntax differences, and skills-vs-commands delivery model explicit so installs feel correct instead of flaky.\n\n## Testing\n- pnpm install\n- pnpm test -- test/core/onboarding-guidance.test.ts test/core/init.test.ts test/core/update.test.ts test/core/migration.test.ts\n- pnpm build

[1code-async]

Task completed.

I'll review this PR by examining the changes. Let me start by understanding the diff and the relevant files.

---

View full conversation

Powered by 1Code

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 7e3ae459-3358-4161-a264-878f1fe5f6d5

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch alfred/ope-20-onboarding

---

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