agile-context-engineering 0.5.0 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (102) hide show
  1. package/.claude-plugin/marketplace.json +18 -0
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/CHANGELOG.md +7 -1
  4. package/README.md +16 -12
  5. package/agents/ace-code-discovery-analyst.md +245 -245
  6. package/agents/ace-code-integration-analyst.md +248 -248
  7. package/agents/ace-code-reviewer.md +375 -375
  8. package/agents/ace-product-owner.md +365 -361
  9. package/agents/ace-project-researcher.md +606 -606
  10. package/agents/ace-technical-application-architect.md +315 -315
  11. package/bin/install.js +587 -173
  12. package/hooks/ace-check-update.js +15 -14
  13. package/hooks/ace-statusline.js +30 -12
  14. package/hooks/hooks.json +14 -0
  15. package/package.json +3 -2
  16. package/shared/lib/ace-core.js +53 -0
  17. package/shared/lib/ace-core.test.js +308 -308
  18. package/shared/lib/ace-story.test.js +250 -250
  19. package/skills/execute-story/SKILL.md +116 -110
  20. package/skills/execute-story/script.js +13 -27
  21. package/skills/execute-story/script.test.js +261 -261
  22. package/skills/execute-story/story-template.xml +451 -451
  23. package/skills/execute-story/workflow.xml +3 -1
  24. package/skills/help/SKILL.md +71 -69
  25. package/skills/help/script.js +32 -35
  26. package/skills/help/script.test.js +183 -183
  27. package/skills/help/workflow.xml +14 -3
  28. package/skills/init-coding-standards/SKILL.md +91 -72
  29. package/skills/init-coding-standards/coding-standards-template.xml +531 -531
  30. package/skills/init-coding-standards/script.js +50 -59
  31. package/skills/init-coding-standards/script.test.js +70 -70
  32. package/skills/init-coding-standards/workflow.xml +1 -1
  33. package/skills/map-cross-cutting/SKILL.md +126 -89
  34. package/skills/map-cross-cutting/workflow.xml +1 -1
  35. package/skills/map-guide/SKILL.md +126 -89
  36. package/skills/map-guide/workflow.xml +1 -1
  37. package/skills/map-pattern/SKILL.md +125 -89
  38. package/skills/map-pattern/workflow.xml +1 -1
  39. package/skills/map-story/SKILL.md +180 -127
  40. package/skills/map-story/templates/tech-debt-index.xml +125 -125
  41. package/skills/map-story/workflow.xml +2 -2
  42. package/skills/map-subsystem/SKILL.md +155 -111
  43. package/skills/map-subsystem/script.js +51 -60
  44. package/skills/map-subsystem/script.test.js +68 -68
  45. package/skills/map-subsystem/templates/subsystem-architecture.xml +343 -343
  46. package/skills/map-subsystem/templates/subsystem-structure.xml +234 -234
  47. package/skills/map-subsystem/workflow.xml +1173 -1173
  48. package/skills/map-sys-doc/SKILL.md +125 -90
  49. package/skills/map-sys-doc/workflow.xml +1 -1
  50. package/skills/map-system/SKILL.md +103 -85
  51. package/skills/map-system/script.js +75 -84
  52. package/skills/map-system/script.test.js +73 -73
  53. package/skills/map-system/templates/system-structure.xml +177 -177
  54. package/skills/map-system/templates/testing-framework.xml +283 -283
  55. package/skills/map-system/workflow.xml +667 -667
  56. package/skills/map-walkthrough/SKILL.md +140 -92
  57. package/skills/map-walkthrough/workflow.xml +457 -457
  58. package/skills/plan-backlog/SKILL.md +93 -75
  59. package/skills/plan-backlog/script.js +121 -136
  60. package/skills/plan-backlog/script.test.js +83 -83
  61. package/skills/plan-backlog/workflow.xml +1348 -1348
  62. package/skills/plan-feature/SKILL.md +99 -76
  63. package/skills/plan-feature/feature-template.xml +361 -361
  64. package/skills/plan-feature/script.js +131 -148
  65. package/skills/plan-feature/script.test.js +80 -80
  66. package/skills/plan-feature/workflow.xml +1 -1
  67. package/skills/plan-product-vision/SKILL.md +91 -75
  68. package/skills/plan-product-vision/product-vision-template.xml +227 -227
  69. package/skills/plan-product-vision/script.js +51 -60
  70. package/skills/plan-product-vision/script.test.js +69 -69
  71. package/skills/plan-product-vision/workflow.xml +337 -337
  72. package/skills/plan-story/SKILL.md +125 -102
  73. package/skills/plan-story/script.js +18 -49
  74. package/skills/plan-story/story-template.xml +8 -1
  75. package/skills/plan-story/workflow.xml +17 -1
  76. package/skills/research-external-solution/SKILL.md +120 -107
  77. package/skills/research-external-solution/external-solution-template.xml +832 -832
  78. package/skills/research-external-solution/script.js +229 -238
  79. package/skills/research-external-solution/script.test.js +134 -134
  80. package/skills/research-external-solution/workflow.xml +657 -657
  81. package/skills/research-integration-solution/SKILL.md +121 -98
  82. package/skills/research-integration-solution/integration-solution-template.xml +1015 -1015
  83. package/skills/research-integration-solution/script.js +223 -231
  84. package/skills/research-integration-solution/script.test.js +134 -134
  85. package/skills/research-integration-solution/workflow.xml +711 -711
  86. package/skills/research-story-wiki/SKILL.md +101 -92
  87. package/skills/research-story-wiki/script.js +223 -231
  88. package/skills/research-story-wiki/script.test.js +138 -138
  89. package/skills/research-story-wiki/story-wiki-template.xml +194 -194
  90. package/skills/research-story-wiki/workflow.xml +473 -473
  91. package/skills/research-technical-solution/SKILL.md +131 -103
  92. package/skills/research-technical-solution/script.js +223 -231
  93. package/skills/research-technical-solution/script.test.js +134 -134
  94. package/skills/research-technical-solution/technical-solution-template.xml +1025 -1025
  95. package/skills/research-technical-solution/workflow.xml +761 -761
  96. package/skills/review-story/SKILL.md +99 -100
  97. package/skills/review-story/script.js +8 -16
  98. package/skills/review-story/script.test.js +169 -169
  99. package/skills/review-story/story-template.xml +451 -451
  100. package/skills/review-story/workflow.xml +1 -1
  101. package/skills/update/SKILL.md +65 -53
  102. package/skills/update/workflow.xml +21 -5
@@ -19,7 +19,7 @@
19
19
  </agent>
20
20
 
21
21
  <mandatory-context>
22
- Read all files referenced by the invoking command's execution-context before starting.
22
+ All supporting resource files are auto-loaded in the skill prompt above. Do NOT re-read them.
23
23
  Also read any document or text passed as parameter ($ARGUMENTS) in the invoking command.
24
24
  </mandatory-context>
25
25
 
@@ -1,53 +1,65 @@
1
- ---
2
- name: update
3
- description: Update ACE to latest version with changelog display
4
- argument-hint: ""
5
- disable-model-invocation: true
6
- allowed-tools:
7
- - Bash
8
- - AskUserQuestion
9
- - WebFetch
10
- model: sonnet
11
- effort: medium
12
- ---
13
-
14
- # Update
15
-
16
- Update ACE to latest version with changelog display.
17
-
18
- ## When to Use
19
-
20
- - When the statusline shows the update indicator
21
- - When user wants to check for or install ACE updates
22
-
23
- ## Input
24
-
25
- No parameters required.
26
-
27
- ## Supporting Resources
28
-
29
- Read ALL of these before starting the workflow:
30
-
31
- - **Workflow**: Read [workflow.xml](workflow.xml) — complete update process
32
- - **UI formatting**: Read `${CLAUDE_SKILL_DIR}/../../shared/utils/ui-formatting.md` — ACE output formatting rules
33
-
34
- ## Process
35
-
36
- Execute the workflow defined in [workflow.xml](workflow.xml) end-to-end.
37
-
38
- The workflow handles all logic including:
39
-
40
- 1. Installation detection (local/global, Claude/Crush)
41
- 2. Latest version checking via npm
42
- 3. Version comparison
43
- 4. Changelog fetching and display
44
- 5. Clean install warning display
45
- 6. User confirmation
46
- 7. Update execution
47
- 8. Cache clearing and restart reminder
48
-
49
- ## Example Usage
50
-
51
- ```
52
- /ace:update
53
- ```
1
+ ---
2
+ name: update
3
+ description: Update ACE to latest version with changelog display
4
+ argument-hint: ""
5
+ disable-model-invocation: true
6
+ allowed-tools:
7
+ - Bash
8
+ - AskUserQuestion
9
+ - WebFetch
10
+ model: sonnet
11
+ effort: medium
12
+ ---
13
+
14
+ ## Supporting Resources (auto-loaded)
15
+
16
+ !`cat "${CLAUDE_SKILL_DIR}/workflow.xml"`
17
+
18
+ !`cat "${CLAUDE_SKILL_DIR}/../../shared/utils/ui-formatting.md"`
19
+
20
+ ```xml
21
+ <command>
22
+
23
+ <execution-time>
24
+ <runs-after>
25
+ <trigger>When statusline shows the update indicator</trigger>
26
+ <trigger>When user wants to check for or install ACE updates</trigger>
27
+ </runs-after>
28
+ </execution-time>
29
+
30
+ <input>
31
+ <parameters>
32
+ <required></required>
33
+ <optional></optional>
34
+ </parameters>
35
+ </input>
36
+
37
+ <execution-context>
38
+ <!-- All supporting files are auto-loaded in the Supporting Resources section above.
39
+ The model does NOT need to Read these files — they are already in context. -->
40
+ </execution-context>
41
+
42
+ <output>
43
+ <objective>
44
+ Check for ACE updates, install if available, and display what changed.
45
+ Automatically detects local vs global installation and Claude vs Crush runtime.
46
+ </objective>
47
+ </output>
48
+
49
+ <process>
50
+ Execute the update workflow from
51
+ `workflow.xml` end-to-end.
52
+
53
+ The workflow handles all logic including:
54
+ 1. Installation detection (local/global, Claude/Crush)
55
+ 2. Latest version checking via npm
56
+ 3. Version comparison
57
+ 4. Changelog fetching and display
58
+ 5. Clean install warning display
59
+ 6. User confirmation
60
+ 7. Update execution
61
+ 8. Cache clearing and restart reminder
62
+ </process>
63
+
64
+ </command>
65
+ ```
@@ -6,7 +6,7 @@
6
6
  </purpose>
7
7
 
8
8
  <mandatory-context>
9
- Read all files referenced by the invoking prompt's execution-context before starting.
9
+ All supporting resource files are auto-loaded in the skill prompt above. Do NOT re-read them.
10
10
  </mandatory-context>
11
11
 
12
12
  <process>
@@ -27,6 +27,18 @@
27
27
  echo "SCOPE=global"
28
28
  echo "RUNTIME=claude"
29
29
  echo "VERSION=$(cat $HOME/.claude/shared/VERSION)"
30
+ elif [ -f "./.codex/shared/VERSION" ]; then
31
+ echo "SCOPE=local"
32
+ echo "RUNTIME=codex"
33
+ echo "VERSION=$(cat ./.codex/shared/VERSION)"
34
+ elif [ -n "$CODEX_HOME" ] && [ -f "$CODEX_HOME/shared/VERSION" ]; then
35
+ echo "SCOPE=global"
36
+ echo "RUNTIME=codex"
37
+ echo "VERSION=$(cat $CODEX_HOME/shared/VERSION)"
38
+ elif [ -f "$HOME/.codex/shared/VERSION" ]; then
39
+ echo "SCOPE=global"
40
+ echo "RUNTIME=codex"
41
+ echo "VERSION=$(cat $HOME/.codex/shared/VERSION)"
30
42
  elif [ -f "./.opencode/shared/VERSION" ]; then
31
43
  echo "SCOPE=local"
32
44
  echo "RUNTIME=opencode"
@@ -118,7 +130,7 @@
118
130
 
119
131
  For SCOPE=local: `./.claude/shared/CHANGELOG.md`
120
132
  For SCOPE=global: `~/.claude/shared/CHANGELOG.md`
121
- (substitute `.opencode` for Crush runtime)
133
+ (substitute `.codex` for Codex or `.opencode` for Crush runtime)
122
134
 
123
135
  If found, read it directly.
124
136
 
@@ -150,12 +162,14 @@
150
162
 
151
163
  The installer performs a clean install of ACE folders:
152
164
  - `skills/`, `shared/`, `.claude-plugin/` will be wiped and replaced
165
+ - In Codex, `skills/ace-*`, `shared/`, and `agents/ace-*` will be replaced
153
166
  - `agents/ace-*` files will be replaced
154
167
 
155
168
  Your custom files are preserved:
156
169
  - Custom skills not in the ACE plugin
157
170
  - Custom agents not prefixed with `ace-`
158
171
  - Your CLAUDE.md files
172
+ - Your Codex config outside the managed ACE block
159
173
  - Your .ace/ project artifacts
160
174
  ```
161
175
 
@@ -180,6 +194,8 @@
180
194
  Examples:
181
195
  - Global Claude: `npx agile-context-engineering --claude --global`
182
196
  - Local Claude: `npx agile-context-engineering --claude --local`
197
+ - Global Codex: `npx agile-context-engineering --codex --global`
198
+ - Local Codex: `npx agile-context-engineering --codex --local`
183
199
  - Global Crush: `npx agile-context-engineering --opencode --global`
184
200
  - Local Crush: `npx agile-context-engineering --opencode --local`
185
201
 
@@ -199,7 +215,7 @@
199
215
  rm -f "$HOME/.claude/cache/ace-update-check.json"
200
216
  ```
201
217
 
202
- For Crush runtime, substitute `.opencode` for `.claude` in the cache path.
218
+ For Codex runtime, use `.codex` (or `$CODEX_HOME`) instead of `.claude`. For Crush runtime, substitute `.opencode` for `.claude` in the cache path.
203
219
  </step>
204
220
 
205
221
  <!-- ══════════════════════════════════════════════════════════════════ -->
@@ -214,7 +230,7 @@
214
230
  ACE Updated: v{old} -> v{new}
215
231
  ============================================================
216
232
 
217
- Restart Claude Code to pick up the new commands.
233
+ Restart your AI coding assistant to pick up the new commands.
218
234
 
219
235
  View full changelog: https://github.com/Quantarcane/ACE/blob/main/CHANGELOG.md
220
236
  ```
@@ -223,7 +239,7 @@
223
239
  </process>
224
240
 
225
241
  <success_criteria>
226
- <check>Installed version detected correctly (local/global, claude/crush)</check>
242
+ <check>Installed version detected correctly (local/global, claude/codex/crush)</check>
227
243
  <check>Latest version checked via npm</check>
228
244
  <check>Update skipped if already current</check>
229
245
  <check>Changelog fetched and displayed BEFORE update</check>