docs: align cli-update OpenCode spec with commands/ and opsx-* paths

[HowardYan888]

Summary

• Update the OpenCode cli-update scenario to use .opencode/commands/ and opsx-*.md filenames, matching the adapter and OpenCode command directory: command/ vs commands/ #748 fix.
• Document hyphen command-reference transforms for OpenCode.
• Add a legacy scenario clarifying that .opencode/command/ files are cleaned up via openspec init/legacy cleanup, not refreshed by openspec update.

Test plan

• Docs-only change; no code or runtime behavior changes.
• Verified spec wording against src/core/command-generation/adapters/opencode.ts and legacy cleanup tests.

Made with Cursor

Summary by CodeRabbit

• Documentation
  • Updated the openspec update command specification to clarify command file management, reference formatting, frontmatter configuration requirements, and legacy command path migration procedures.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 81300589-3a35-4a51-b321-3224d9aba64a

📥 Commits

Reviewing files that changed from the base of the PR and between 1b06fdd and 1677566.

📒 Files selected for processing (1)

• openspec/specs/cli-update/spec.md

---

📝 Walkthrough

Walkthrough

This PR updates the OpenSpec CLI update command specification to clarify how openspec update handles OpenCode command files. The specification now details refreshing opsx-*.md files under .opencode/commands/, transforming command references to hyphen form, and handling legacy .opencode/command/ paths.

Changes

CLI Update Specification Refinement

Layer / File(s)	Summary
OpenCode command update scenario specification openspec/specs/cli-update/spec.md	Specification updated to describe .opencode/commands/ refresh behavior including hyphenated command reference transformation, $ARGUMENTS placeholder requirement in archive frontmatter, and legacy .opencode/command/ path cleanup rules. openspec update must not refresh files that remain only under the legacy path.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• Fission-AI/OpenSpec#627: Both PRs address OpenCode command reference formatting, specifically updating generated command references from slash form to hyphen form for compatibility.

Suggested labels

codex

Suggested reviewers

• TabishB

Poem

🐰 A spec gets refined with a careful touch,
From .command/ to .commands/—not much,
But hyphens now flow through the OpenCode way,
With arguments ready for when they're called to play.
Legacy paths fade as the new ones grow bright,
A small change, but clear, puts the specification right. ✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately reflects the main change: updating the CLI-update OpenCode specification to align with the new commands/ directory structure and opsx-* filename format.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

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