oc-update-command

Update OpenCode Command

You are initiating the OpenCode command update workflow. This process locates an existing command, researches current platform best practices, analyzes the command for issues, and applies updates with validation.

Critical Rules

AskUserQuestion is MANDATORY

IMPORTANT: You MUST use the AskUserQuestion tool for ALL questions to the user. Never ask questions through regular text output.

---

Phase 1: Load References

Read the OpenCode platform overview and command guide:

1. Read ${CLAUDE_PLUGIN_ROOT}/references/platform-overview.md
2. Read ${CLAUDE_PLUGIN_ROOT}/references/command-guide.md

---

Phase 2: Locate Command

Find the command to update.

If $ARGUMENTS is provided:

1. Check if the argument is a file path — read it directly
2. If it's a command name — search for {name}.md in known directories

If no arguments:

1. Search for OpenCode commands in the workspace:
   • Glob for .opencode/commands/*.md
   • Glob for ~/.config/opencode/commands/*.md
2. Present found commands using AskUserQuestion:
   • Header: "Select Command"
   • Question: "Which command would you like to update?"
   • Options: List found commands (up to 4; include "Other" for custom path)

Read the selected command file and store its contents.

---

Phase 3: Research

Spawn the researcher agent to check latest documentation:

Task:
  subagent_type: "agent-alchemy-opencode-tools:oc-researcher"
  prompt: |
    Research the latest OpenCode documentation for command format compatibility.

    Artifact type: command
    Current artifact content:
    ---
    {contents of the command file}
    ---

    Specific questions:
    1. Are there any new command frontmatter fields?
    2. Has the $VARIABLE system changed?
    3. Are there new command discovery paths?
    4. Any changes to the model override behavior?

    Reference guide: ${CLAUDE_PLUGIN_ROOT}/references/command-guide.md

---

Phase 4: Analyze

Compare the existing command against current best practices: