uf.init

Command: /uf.init

Description

Apply project-specific customizations to third-party tool files that cannot be modified by the uf init Go binary. This command uses LLM reasoning to read target files, understand their structure, and intelligently insert customizations at the correct locations.

When to run: After uf init (terminal), after uf setup, or after updating the OpenSpec CLI (npm update). Safe to re-run -- idempotent.

Instructions

Step 0: Command Directory Migration

Check whether the legacy .opencode/command/ directory needs to be migrated to .opencode/commands/:

1. Check if .opencode/command/ exists (old directory):

   ls -d .opencode/command/ 2>/dev/null
   

2. Check if .opencode/commands/ exists (new directory):

   ls -d .opencode/commands/ 2>/dev/null
   

3. If old exists and new does NOT exist: rename the directory:

   mv .opencode/command .opencode/commands
   

   Report: ✅ command/ → commands/: migrated

4. If both exist: move unique files from old to new, remove duplicates from old, and clean up:

   # For each file in old dir, move if not in new, else remove
   for f in .opencode/command/*; do
     name="$(basename "$f")"
     if [ -f ".opencode/commands/$name" ]; then
       rm "$f"
     else
       mv "$f" .opencode/commands/
     fi
   done
   rmdir .opencode/command 2>/dev/null
   

   Report: ✅ command/ → commands/: merged (old dir cleaned up)

5. If old does NOT exist: no migration needed. Report: ⊘ command/ migration: not needed

Step 1: Check Prerequisites

Verify the project has been initialized:

1. Check that .opencode/ directory exists. If not, STOP with:

   .opencode/ not found. Run uf init from your terminal first.

2. Check that these 4 OpenSpec skill files exist:

   • .opencode/skills/openspec-propose/SKILL.md
   • .opencode/skills/openspec-apply-change/SKILL.md
   • .opencode/skills/openspec-archive-change/SKILL.md
   • .opencode/skills/openspec-explore/SKILL.md