agile-context-engineering 0.3.0 → 0.5.1

package/{commands/ace/update.md → skills/update/SKILL.md}

@@ -1,56 +1,65 @@
----
-name: ace:update
-description: Update ACE to latest version with changelog display
-argument-hint: ""
-allowed-tools:
-  - Bash
-  - AskUserQuestion
-  - WebFetch
----
-
-```xml
-<command>
-
-    <execution-time>
-        <runs-after>
-            <trigger>When statusline shows the update indicator</trigger>
-            <trigger>When user wants to check for or install ACE updates</trigger>
-        </runs-after>
-    </execution-time>
-
-    <input>
-        <parameters>
-            <required></required>
-            <optional></optional>
-        </parameters>
-    </input>
-
-    <execution-context>
-        <update-workflow>@~/.claude/agile-context-engineering/workflows/update.xml</update-workflow>
-        <ui-formatting>@~/.claude/agile-context-engineering/utils/ui-formatting.md</ui-formatting>
-    </execution-context>
-
-    <output>
-        <objective>
-            Check for ACE updates, install if available, and display what changed.
-            Automatically detects local vs global installation and Claude vs Crush runtime.
-        </objective>
-    </output>
-
-    <process>
-        Execute the update workflow from
-        `@~/.claude/agile-context-engineering/workflows/update.xml` end-to-end.
-
-        The workflow handles all logic including:
-        1. Installation detection (local/global, Claude/Crush)
-        2. Latest version checking via npm
-        3. Version comparison
-        4. Changelog fetching and display
-        5. Clean install warning display
-        6. User confirmation
-        7. Update execution
-        8. Cache clearing and restart reminder
-    </process>
-
-</command>
-```
+---
+name: update
+description: Update ACE to latest version with changelog display
+argument-hint: ""
+disable-model-invocation: true
+allowed-tools:
+  - Bash
+  - AskUserQuestion
+  - WebFetch
+model: sonnet
+effort: medium
+---
+
+## Supporting Resources (auto-loaded)
+
+!`cat "${CLAUDE_SKILL_DIR}/workflow.xml"`
+
+!`cat "${CLAUDE_SKILL_DIR}/../../shared/utils/ui-formatting.md"`
+
+```xml
+<command>
+
+    <execution-time>
+        <runs-after>
+            <trigger>When statusline shows the update indicator</trigger>
+            <trigger>When user wants to check for or install ACE updates</trigger>
+        </runs-after>
+    </execution-time>
+
+    <input>
+        <parameters>
+            <required></required>
+            <optional></optional>
+        </parameters>
+    </input>
+
+    <execution-context>
+        <!-- All supporting files are auto-loaded in the Supporting Resources section above.
+             The model does NOT need to Read these files — they are already in context. -->
+    </execution-context>
+
+    <output>
+        <objective>
+            Check for ACE updates, install if available, and display what changed.
+            Automatically detects local vs global installation and Claude vs Crush runtime.
+        </objective>
+    </output>
+
+    <process>
+        Execute the update workflow from
+        `workflow.xml` end-to-end.
+
+        The workflow handles all logic including:
+        1. Installation detection (local/global, Claude/Crush)
+        2. Latest version checking via npm
+        3. Version comparison
+        4. Changelog fetching and display
+        5. Clean install warning display
+        6. User confirmation
+        7. Update execution
+        8. Cache clearing and restart reminder
+    </process>
+
+</command>
+```

package/{agile-context-engineering/workflows/update.xml → skills/update/workflow.xml}

@@ -6,7 +6,7 @@
     </purpose>
 
     <mandatory-context>
-        Read all files referenced by the invoking prompt's execution-context before starting.
+        All supporting resource files are auto-loaded in the skill prompt above. Do NOT re-read them.
     </mandatory-context>
 
     <process>
@@ -19,22 +19,34 @@
             Detect whether ACE is installed locally or globally, and for which runtime.
 
             ```bash
-            if [ -f "./.claude/agile-context-engineering/VERSION" ]; then
+            if [ -f "./.claude/shared/VERSION" ]; then
               echo "SCOPE=local"
               echo "RUNTIME=claude"
-              echo "VERSION=$(cat ./.claude/agile-context-engineering/VERSION)"
-            elif [ -f "$HOME/.claude/agile-context-engineering/VERSION" ]; then
+              echo "VERSION=$(cat ./.claude/shared/VERSION)"
+            elif [ -f "$HOME/.claude/shared/VERSION" ]; then
               echo "SCOPE=global"
               echo "RUNTIME=claude"
-              echo "VERSION=$(cat $HOME/.claude/agile-context-engineering/VERSION)"
-            elif [ -f "./.opencode/agile-context-engineering/VERSION" ]; then
+              echo "VERSION=$(cat $HOME/.claude/shared/VERSION)"
+            elif [ -f "./.codex/shared/VERSION" ]; then
+              echo "SCOPE=local"
+              echo "RUNTIME=codex"
+              echo "VERSION=$(cat ./.codex/shared/VERSION)"
+            elif [ -n "$CODEX_HOME" ] && [ -f "$CODEX_HOME/shared/VERSION" ]; then
+              echo "SCOPE=global"
+              echo "RUNTIME=codex"
+              echo "VERSION=$(cat $CODEX_HOME/shared/VERSION)"
+            elif [ -f "$HOME/.codex/shared/VERSION" ]; then
+              echo "SCOPE=global"
+              echo "RUNTIME=codex"
+              echo "VERSION=$(cat $HOME/.codex/shared/VERSION)"
+            elif [ -f "./.opencode/shared/VERSION" ]; then
               echo "SCOPE=local"
               echo "RUNTIME=opencode"
-              echo "VERSION=$(cat ./.opencode/agile-context-engineering/VERSION)"
-            elif [ -f "$HOME/.opencode/agile-context-engineering/VERSION" ]; then
+              echo "VERSION=$(cat ./.opencode/shared/VERSION)"
+            elif [ -f "$HOME/.opencode/shared/VERSION" ]; then
               echo "SCOPE=global"
               echo "RUNTIME=opencode"
-              echo "VERSION=$(cat $HOME/.opencode/agile-context-engineering/VERSION)"
+              echo "VERSION=$(cat $HOME/.opencode/shared/VERSION)"
             else
               echo "SCOPE=unknown"
               echo "RUNTIME=claude"
@@ -116,9 +128,9 @@
 
             1. **Try local changelog first** — check if CHANGELOG.md exists in the installation:
 
-               For SCOPE=local: `./.claude/agile-context-engineering/CHANGELOG.md`
-               For SCOPE=global: `~/.claude/agile-context-engineering/CHANGELOG.md`
-               (substitute `.opencode` for Crush runtime)
+               For SCOPE=local: `./.claude/shared/CHANGELOG.md`
+               For SCOPE=global: `~/.claude/shared/CHANGELOG.md`
+               (substitute `.codex` for Codex or `.opencode` for Crush runtime)
 
                If found, read it directly.
 
@@ -149,14 +161,15 @@
             ────────────────────────────────────────────────────────────
 
             The installer performs a clean install of ACE folders:
-            - `commands/ace/` will be wiped and replaced
-            - `agile-context-engineering/` will be wiped and replaced
+            - `skills/`, `shared/`, `.claude-plugin/` will be wiped and replaced
+            - In Codex, `skills/ace-*`, `shared/`, and `agents/ace-*` will be replaced
             - `agents/ace-*` files will be replaced
 
             Your custom files are preserved:
-            - Custom commands not in `commands/ace/`
+            - Custom skills not in the ACE plugin
             - Custom agents not prefixed with `ace-`
             - Your CLAUDE.md files
+            - Your Codex config outside the managed ACE block
             - Your .ace/ project artifacts
             ```
 
@@ -181,6 +194,8 @@
             Examples:
             - Global Claude:  `npx agile-context-engineering --claude --global`
             - Local Claude:   `npx agile-context-engineering --claude --local`
+            - Global Codex:   `npx agile-context-engineering --codex --global`
+            - Local Codex:    `npx agile-context-engineering --codex --local`
             - Global Crush:   `npx agile-context-engineering --opencode --global`
             - Local Crush:    `npx agile-context-engineering --opencode --local`
 
@@ -200,7 +215,7 @@
             rm -f "$HOME/.claude/cache/ace-update-check.json"
             ```
 
-            For Crush runtime, substitute `.opencode` for `.claude` in the cache path.
+            For Codex runtime, use `.codex` (or `$CODEX_HOME`) instead of `.claude`. For Crush runtime, substitute `.opencode` for `.claude` in the cache path.
         </step>
 
         <!-- ══════════════════════════════════════════════════════════════════ -->
@@ -215,7 +230,7 @@
               ACE Updated: v{old} -> v{new}
             ============================================================
 
-            Restart Claude Code to pick up the new commands.
+            Restart your AI coding assistant to pick up the new commands.
 
             View full changelog: https://github.com/Quantarcane/ACE/blob/main/CHANGELOG.md
             ```
@@ -224,7 +239,7 @@
     </process>
 
     <success_criteria>
-        <check>Installed version detected correctly (local/global, claude/crush)</check>
+        <check>Installed version detected correctly (local/global, claude/codex/crush)</check>
         <check>Latest version checked via npm</check>
         <check>Update skipped if already current</check>
         <check>Changelog fetched and displayed BEFORE update</check>