agile-context-engineering 0.2.2 → 0.5.0

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 (146) hide show
  1. package/.claude-plugin/plugin.json +10 -0
  2. package/CHANGELOG.md +82 -0
  3. package/README.md +27 -18
  4. package/agents/ace-product-owner.md +1 -1
  5. package/agents/ace-technical-application-architect.md +28 -0
  6. package/agents/ace-wiki-mapper.md +144 -29
  7. package/bin/install.js +67 -63
  8. package/hooks/ace-check-update.js +17 -9
  9. package/package.json +7 -5
  10. package/shared/lib/ace-core.js +308 -0
  11. package/shared/lib/ace-core.test.js +308 -0
  12. package/shared/lib/ace-github.js +753 -0
  13. package/shared/lib/ace-story.js +400 -0
  14. package/shared/lib/ace-story.test.js +250 -0
  15. package/{agile-context-engineering → shared}/utils/ui-formatting.md +299 -299
  16. package/skills/execute-story/SKILL.md +110 -0
  17. package/skills/execute-story/script.js +305 -0
  18. package/skills/execute-story/script.test.js +261 -0
  19. package/skills/execute-story/walkthrough-template.xml +255 -0
  20. package/{agile-context-engineering/workflows/execute-story.xml → skills/execute-story/workflow.xml} +83 -9
  21. package/skills/help/SKILL.md +69 -0
  22. package/skills/help/script.js +318 -0
  23. package/skills/help/script.test.js +183 -0
  24. package/{agile-context-engineering/workflows/help.xml → skills/help/workflow.xml} +8 -8
  25. package/skills/init-coding-standards/SKILL.md +72 -0
  26. package/{agile-context-engineering/templates/wiki/coding-standards.xml → skills/init-coding-standards/coding-standards-template.xml} +38 -0
  27. package/skills/init-coding-standards/script.js +59 -0
  28. package/skills/init-coding-standards/script.test.js +70 -0
  29. package/{agile-context-engineering/workflows/init-coding-standards.xml → skills/init-coding-standards/workflow.xml} +4 -9
  30. package/skills/map-cross-cutting/SKILL.md +89 -0
  31. package/skills/map-cross-cutting/workflow.xml +330 -0
  32. package/skills/map-guide/SKILL.md +89 -0
  33. package/skills/map-guide/workflow.xml +320 -0
  34. package/skills/map-pattern/SKILL.md +89 -0
  35. package/skills/map-pattern/workflow.xml +331 -0
  36. package/skills/map-story/SKILL.md +127 -0
  37. package/skills/map-story/templates/guide.xml +137 -0
  38. package/skills/map-story/templates/pattern.xml +159 -0
  39. package/skills/map-story/templates/system-cross-cutting.xml +197 -0
  40. package/skills/map-story/templates/walkthrough.xml +255 -0
  41. package/{agile-context-engineering/workflows/map-story.xml → skills/map-story/workflow.xml} +258 -9
  42. package/skills/map-subsystem/SKILL.md +111 -0
  43. package/skills/map-subsystem/script.js +60 -0
  44. package/skills/map-subsystem/script.test.js +68 -0
  45. package/skills/map-subsystem/templates/decizions.xml +115 -0
  46. package/skills/map-subsystem/templates/guide.xml +137 -0
  47. package/{agile-context-engineering/templates/wiki → skills/map-subsystem/templates}/module-discovery.xml +3 -3
  48. package/skills/map-subsystem/templates/pattern.xml +159 -0
  49. package/skills/map-subsystem/templates/system-cross-cutting.xml +197 -0
  50. package/skills/map-subsystem/templates/system.xml +381 -0
  51. package/skills/map-subsystem/templates/walkthrough.xml +255 -0
  52. package/{agile-context-engineering/workflows/map-subsystem.xml → skills/map-subsystem/workflow.xml} +17 -21
  53. package/skills/map-sys-doc/SKILL.md +90 -0
  54. package/skills/map-sys-doc/system.xml +381 -0
  55. package/skills/map-sys-doc/workflow.xml +336 -0
  56. package/skills/map-system/SKILL.md +85 -0
  57. package/skills/map-system/script.js +84 -0
  58. package/skills/map-system/script.test.js +73 -0
  59. package/skills/map-system/templates/wiki-readme.xml +297 -0
  60. package/{agile-context-engineering/workflows/map-system.xml → skills/map-system/workflow.xml} +11 -16
  61. package/skills/map-walkthrough/SKILL.md +92 -0
  62. package/skills/map-walkthrough/walkthrough.xml +255 -0
  63. package/skills/map-walkthrough/workflow.xml +457 -0
  64. package/skills/plan-backlog/SKILL.md +75 -0
  65. package/skills/plan-backlog/script.js +136 -0
  66. package/skills/plan-backlog/script.test.js +83 -0
  67. package/{agile-context-engineering/workflows/plan-backlog.xml → skills/plan-backlog/workflow.xml} +13 -21
  68. package/skills/plan-feature/SKILL.md +76 -0
  69. package/skills/plan-feature/script.js +148 -0
  70. package/skills/plan-feature/script.test.js +80 -0
  71. package/{agile-context-engineering/workflows/plan-feature.xml → skills/plan-feature/workflow.xml} +21 -29
  72. package/skills/plan-product-vision/SKILL.md +75 -0
  73. package/skills/plan-product-vision/script.js +60 -0
  74. package/skills/plan-product-vision/script.test.js +69 -0
  75. package/{agile-context-engineering/workflows/plan-product-vision.xml → skills/plan-product-vision/workflow.xml} +4 -9
  76. package/skills/plan-story/SKILL.md +116 -0
  77. package/skills/plan-story/script.js +326 -0
  78. package/skills/plan-story/script.test.js +240 -0
  79. package/skills/plan-story/story-template.xml +451 -0
  80. package/{agile-context-engineering/workflows/plan-story.xml → skills/plan-story/workflow.xml} +1285 -909
  81. package/skills/research-external-solution/SKILL.md +107 -0
  82. package/skills/research-external-solution/script.js +238 -0
  83. package/skills/research-external-solution/script.test.js +134 -0
  84. package/{agile-context-engineering/workflows/research-external-solution.xml → skills/research-external-solution/workflow.xml} +4 -6
  85. package/skills/research-integration-solution/SKILL.md +98 -0
  86. package/{agile-context-engineering/templates/product/story-integration-solution.xml → skills/research-integration-solution/integration-solution-template.xml} +1 -0
  87. package/skills/research-integration-solution/script.js +231 -0
  88. package/skills/research-integration-solution/script.test.js +134 -0
  89. package/{agile-context-engineering/workflows/research-integration-solution.xml → skills/research-integration-solution/workflow.xml} +4 -5
  90. package/skills/research-story-wiki/SKILL.md +92 -0
  91. package/skills/research-story-wiki/script.js +231 -0
  92. package/skills/research-story-wiki/script.test.js +138 -0
  93. package/{agile-context-engineering/templates/product/story-wiki.xml → skills/research-story-wiki/story-wiki-template.xml} +4 -0
  94. package/{agile-context-engineering/workflows/research-story-wiki.xml → skills/research-story-wiki/workflow.xml} +5 -6
  95. package/skills/research-technical-solution/SKILL.md +103 -0
  96. package/skills/research-technical-solution/script.js +231 -0
  97. package/skills/research-technical-solution/script.test.js +134 -0
  98. package/{agile-context-engineering/workflows/research-technical-solution.xml → skills/research-technical-solution/workflow.xml} +4 -5
  99. package/skills/review-story/SKILL.md +100 -0
  100. package/skills/review-story/script.js +257 -0
  101. package/skills/review-story/script.test.js +169 -0
  102. package/skills/review-story/story-template.xml +451 -0
  103. package/{agile-context-engineering/workflows/review-story.xml → skills/review-story/workflow.xml} +1 -3
  104. package/skills/update/SKILL.md +53 -0
  105. package/{agile-context-engineering/workflows/update.xml → skills/update/workflow.xml} +237 -207
  106. package/agile-context-engineering/src/ace-tools.js +0 -2881
  107. package/agile-context-engineering/src/ace-tools.test.js +0 -1089
  108. package/agile-context-engineering/templates/_command.md +0 -54
  109. package/agile-context-engineering/templates/_workflow.xml +0 -17
  110. package/agile-context-engineering/templates/config.json +0 -0
  111. package/agile-context-engineering/templates/product/integration-solution.xml +0 -0
  112. package/agile-context-engineering/templates/wiki/wiki-readme.xml +0 -276
  113. package/commands/ace/execute-story.md +0 -137
  114. package/commands/ace/help.md +0 -93
  115. package/commands/ace/init-coding-standards.md +0 -83
  116. package/commands/ace/map-story.md +0 -156
  117. package/commands/ace/map-subsystem.md +0 -138
  118. package/commands/ace/map-system.md +0 -92
  119. package/commands/ace/plan-backlog.md +0 -83
  120. package/commands/ace/plan-feature.md +0 -89
  121. package/commands/ace/plan-product-vision.md +0 -81
  122. package/commands/ace/plan-story.md +0 -145
  123. package/commands/ace/research-external-solution.md +0 -138
  124. package/commands/ace/research-integration-solution.md +0 -135
  125. package/commands/ace/research-story-wiki.md +0 -116
  126. package/commands/ace/research-technical-solution.md +0 -147
  127. package/commands/ace/review-story.md +0 -109
  128. package/commands/ace/update.md +0 -54
  129. /package/{agile-context-engineering → shared}/utils/questioning.xml +0 -0
  130. /package/{agile-context-engineering/templates/product/story.xml → skills/execute-story/story-template.xml} +0 -0
  131. /package/{agile-context-engineering/templates/wiki → skills/map-cross-cutting}/system-cross-cutting.xml +0 -0
  132. /package/{agile-context-engineering/templates/wiki → skills/map-guide}/guide.xml +0 -0
  133. /package/{agile-context-engineering/templates/wiki → skills/map-pattern}/pattern.xml +0 -0
  134. /package/{agile-context-engineering/templates/wiki → skills/map-story/templates}/decizions.xml +0 -0
  135. /package/{agile-context-engineering/templates/wiki → skills/map-story/templates}/system.xml +0 -0
  136. /package/{agile-context-engineering/templates/wiki → skills/map-story/templates}/tech-debt-index.xml +0 -0
  137. /package/{agile-context-engineering/templates/wiki → skills/map-subsystem/templates}/subsystem-architecture.xml +0 -0
  138. /package/{agile-context-engineering/templates/wiki → skills/map-subsystem/templates}/subsystem-structure.xml +0 -0
  139. /package/{agile-context-engineering/templates/wiki → skills/map-system/templates}/system-architecture.xml +0 -0
  140. /package/{agile-context-engineering/templates/wiki → skills/map-system/templates}/system-structure.xml +0 -0
  141. /package/{agile-context-engineering/templates/wiki → skills/map-system/templates}/testing-framework.xml +0 -0
  142. /package/{agile-context-engineering/templates/product/product-backlog.xml → skills/plan-backlog/product-backlog-template.xml} +0 -0
  143. /package/{agile-context-engineering/templates/product/feature.xml → skills/plan-feature/feature-template.xml} +0 -0
  144. /package/{agile-context-engineering/templates/product/product-vision.xml → skills/plan-product-vision/product-vision-template.xml} +0 -0
  145. /package/{agile-context-engineering/templates/product/external-solution.xml → skills/research-external-solution/external-solution-template.xml} +0 -0
  146. /package/{agile-context-engineering/templates/product/story-technical-solution.xml → skills/research-technical-solution/technical-solution-template.xml} +0 -0
@@ -1,54 +0,0 @@
1
- ---
2
- name: ace:COMMAND_NAME
3
- description: COMMAND_DESCRIPTION
4
- argument-hint: ""
5
- allowed-tools:
6
- - Read
7
- - Bash
8
- - Glob
9
- - Grep
10
- - Write
11
- - Task
12
- ---
13
-
14
- ```xml
15
- <command>
16
-
17
- <execution-time>
18
- </execution-time>
19
-
20
- <input>
21
- <flags>
22
- </flags>
23
-
24
- <parameters>
25
- <required>
26
- </required>
27
-
28
- <optional>
29
- </optional>
30
- </parameters>
31
- </input>
32
-
33
- <execution-context>
34
- </execution-context>
35
-
36
- <output>
37
- <objective>
38
- </objective>
39
-
40
- <artifacts>
41
- </artifacts>
42
- </output>
43
-
44
- <process>
45
- </process>
46
-
47
- <success_criteria>
48
- </success_criteria>
49
-
50
- <next-steps>
51
- </next-steps>
52
-
53
- </command>
54
- ```
@@ -1,17 +0,0 @@
1
- <workflow>
2
-
3
- <purpose>
4
- </purpose>
5
-
6
- <mandatory-context>
7
- [TODO] Read all files referenced by the invoking prompt's execution-context before starting. Also Read any document or text passed as parameter in the invoking command that called this template.
8
- </mandatory-context>
9
-
10
- <process>
11
- <step name="1">
12
- </step>
13
-
14
- <step name="2">
15
- </step>
16
- </process>
17
- </workflow>
File without changes
@@ -1,276 +0,0 @@
1
- <wiki-readme>
2
- <purpose>
3
- Template for `.docs/wiki/wiki-readme.md` — the entry point and usage guide for the
4
- engineering wiki. Generated once when the `.docs/wiki/` directory is first created
5
- (typically by `/ace:map-system`).
6
-
7
- Serves two audiences:
8
- - **Humans** who want to understand, navigate, and contribute to the wiki
9
- - **AI agents** who need to know which documents to load for a given task
10
-
11
- This is NOT a documentation template — it is a META-DOCUMENT that describes how the
12
- wiki itself works. Think of it as the README for the wiki system.
13
- </purpose>
14
-
15
- <template>
16
- <header>
17
- # Engineering Wiki
18
-
19
- Living knowledge base for this codebase. Maintained by AI agents after each story
20
- and by developers when making structural changes.
21
-
22
- **For humans**: browse by subsystem, read system and pattern docs to understand how things work.
23
- **For AI agents**: load the minimal set of docs needed for your current task — every token counts.
24
- </header>
25
-
26
- <directory-structure>
27
- ## Directory Structure
28
-
29
- ```
30
- .docs/wiki/
31
- |-- wiki-readme.md # This file — how to use the wiki
32
- |-- system-wide/ # Documents that span all subsystems
33
- | |-- system-structure.md # Physical layout, subsystem index, shared dirs
34
- | |-- system-architecture.md # L1/L2 C4 views, core flows, tech stack
35
- | |-- testing-framework.md # Test runner, patterns, conventions
36
- | |-- coding-standards.md # Language and paradigm-specific rules
37
- | `-- tech-debt-index.md # Roll-up of all known tech debt
38
- `-- subsystems/
39
- `-- [subsystem-name]/ # One folder per subsystem
40
- |-- structure.md # File layout, "where to add code"
41
- |-- architecture.md # L3 components, internal flows, dependencies
42
- |-- systems/ # WHAT exists — domain system docs
43
- | `-- [system-name].md
44
- |-- patterns/ # HOW to implement — reusable structural patterns
45
- | `-- [pattern-name].md
46
- |-- cross-cutting/ # Shared infrastructure spanning systems
47
- | `-- [concern-name].md
48
- |-- guides/ # Step-by-step implementation recipes
49
- | `-- [task-name].md
50
- `-- decisions/ # WHY — Architecture Decision Records
51
- `-- ADR-NNN-[slug].md
52
- ```
53
- </directory-structure>
54
-
55
- <document-types>
56
- ## Document Types
57
-
58
- ### System-Wide Documents
59
-
60
- | Document | Answers | Created By |
61
- |----------|---------|------------|
62
- | `system-structure.md` | What subsystems exist and where do they live? | `/ace:map-system` |
63
- | `system-architecture.md` | What's the system design, tech stack, and core flows? | `/ace:map-system` |
64
- | `testing-framework.md` | How do we test? Runner, patterns, conventions. | `/ace:map-system` |
65
- | `coding-standards.md` | What are the mandatory code quality rules? | `/ace:init-coding-standards` |
66
- | `tech-debt-index.md` | What known quality issues exist across the codebase? | `/ace:map-story` (auto) |
67
-
68
- ### Subsystem Documents
69
-
70
- | Document | Answers | Created By |
71
- |----------|---------|------------|
72
- | `structure.md` | Where do files live in this subsystem? Where do I add new code? | `/ace:map-subsystem` |
73
- | `architecture.md` | What are the internal components, layers, and flows? | `/ace:map-subsystem` |
74
-
75
- ### Knowledge Documents (per subsystem)
76
-
77
- | Category | Answers | When to Create |
78
- |----------|---------|----------------|
79
- | `systems/` | How does this domain system work RIGHT NOW? | One doc per coherent domain capability (e.g., drawing system, order processing) |
80
- | `patterns/` | How do I implement using this reusable pattern? | When a structural pattern appears in 2+ implementations |
81
- | `cross-cutting/` | How does this shared infrastructure work? | For concerns spanning multiple domain systems (DI, events, registry) |
82
- | `guides/` | How do I perform this recurring task end-to-end? | When a task is repeated (adding a new tool, endpoint, entity) |
83
- | `decisions/` | Why was this significant choice made? | When a meaningful trade-off was evaluated and decided |
84
- </document-types>
85
-
86
- <how-to-use>
87
- ## How to Use This Wiki
88
-
89
- ### For Humans
90
-
91
- **Understand a subsystem:**
92
- 1. Read `subsystems/[name]/architecture.md` — components, layers, internal flows
93
- 2. Read relevant `systems/*.md` — domain systems you care about
94
- 3. Follow cross-references to patterns and cross-cutting concerns
95
-
96
- **Implement a new feature:**
97
- 1. Read `system-wide/coding-standards.md` — mandatory rules
98
- 2. Read the subsystem's `structure.md` — where to add files
99
- 3. Check `guides/` — there may be a step-by-step recipe for your task
100
- 4. Read relevant `patterns/` — follow established structural patterns
101
- 5. Check `decisions/` — respect past architectural decisions
102
-
103
- **Debug or investigate:**
104
- 1. Start with the relevant `systems/*.md` — it has entry points, flows, and components
105
- 2. Follow the sequence diagrams to trace data flow
106
- 3. Check `cross-cutting/` for shared infrastructure behavior
107
-
108
- ### For AI Agents
109
-
110
- **Context loading strategy:**
111
- - ALWAYS load system-wide docs first: `system-structure.md`, `system-architecture.md`, `coding-standards.md`, `testing-framework.md`
112
- - Then load subsystem docs for the subsystem(s) you are modifying
113
- - Load ONLY the `systems/`, `patterns/`, `cross-cutting/`, and `guides/` docs relevant to your task
114
- - Check `decisions/` for ADRs that constrain your design choices
115
- - Every token in your context window costs reasoning capacity — load less, reason better
116
-
117
- **Finding the right docs:**
118
- - Story files include a `## Relevant Wiki` section with curated doc references
119
- - Each doc cross-references related docs via markdown links — follow them as needed
120
- - `structure.md` → where files live; `architecture.md` → how things connect
121
- - `systems/` → domain behavior; `patterns/` → structural recipes; `guides/` → task recipes
122
- </how-to-use>
123
-
124
- <how-to-create>
125
- ## Creating New Wiki Documents
126
-
127
- Wiki documents are primarily created and updated by AI agents (ace-wiki-mapper) through:
128
- - `/ace:map-system` — system-wide documents
129
- - `/ace:map-subsystem` — subsystem structure, architecture, and knowledge docs
130
- - `/ace:map-story` — updates knowledge docs after story implementation
131
-
132
- ### Manual Creation Guidelines
133
-
134
- If creating a document manually, follow these rules:
135
-
136
- **Naming:**
137
- - Use kebab-case for all file names: `drawing-system.md`, `repository-pattern.md`
138
- - Systems: name after the domain capability — `drawing-system.md`, `order-processing.md`
139
- - Patterns: name after the pattern — `template-method-pattern.md`, `repository-pattern.md`
140
- - Cross-cutting: name after the concern — `dependency-injection.md`, `event-system.md`
141
- - Guides: name after the task — `adding-drawing-tool.md`, `adding-crud-endpoint.md`
142
- - Decisions: `ADR-NNN-kebab-slug.md` — sequential numbering within the subsystem
143
-
144
- **Content rules:**
145
- - EXTREMELY SUCCINCT — every word must add value
146
- - Bullet points over paragraphs
147
- - Code references: `file-path:ClassName.methodName` — never line numbers
148
- - All architecture diagrams MUST be mermaid (flowchart, classDiagram, sequenceDiagram)
149
- - File trees: ASCII only (`|--` and backtick for last item)
150
- - Inline code ONLY for interface/type contracts
151
- - Cross-reference related docs with markdown links
152
- - Every `systems/*.md` MUST have at least one mermaid sequenceDiagram
153
-
154
- **Topic-scoped, not story-scoped:**
155
- - Documents describe a CONCERN, not a story or sprint
156
- - "How does the drawing system work?" — good
157
- - "What story #19 implemented" — wrong (that goes in `.ace/artifacts/`)
158
-
159
- **Create vs update decision:**
160
- 1. Does an existing doc already cover this topic? → UPDATE it
161
- 2. Could this be a new section in an existing doc? → Add the section
162
- 3. Any overlap with existing docs? → Merge into the existing doc
163
- 4. Genuinely new topic with no overlap? → CREATE a new doc
164
- </how-to-create>
165
-
166
- <keeping-current>
167
- ## Keeping the Wiki Current
168
-
169
- ### Automatic Updates
170
-
171
- After each story implementation, `/ace:map-story` analyzes git changes and updates
172
- the relevant knowledge documents. This is the primary mechanism for keeping the wiki
173
- current.
174
-
175
- ### Manual Update Triggers
176
-
177
- **Update `system-structure.md` when:**
178
- - New subsystem added, removed, or merged
179
- - Shared directory added or removed
180
- - Workspace configuration changed
181
-
182
- **Update `system-architecture.md` when:**
183
- - New subsystem or external integration added
184
- - Communication pattern changed
185
- - Tech stack changed
186
-
187
- **Update `testing-framework.md` when:**
188
- - Test runner or mocking approach changed
189
- - Coverage requirements changed
190
-
191
- **Update subsystem `structure.md` when:**
192
- - Top-level directory added, renamed, or removed within the subsystem
193
-
194
- **Update subsystem `architecture.md` when:**
195
- - New architectural layer or component type introduced
196
- - New inbound or outbound dependency added
197
-
198
- **Update knowledge docs when:**
199
- - `systems/` — new component, behavior, entry point, or integration point
200
- - `patterns/` — new implementation added, pattern structure changed
201
- - `cross-cutting/` — new registration, mechanism changed
202
- - `guides/` — new step required, step order changed, reference implementation changed
203
- - `decisions/` — NEVER edit accepted ADRs; create a new one that supersedes
204
-
205
- ### Tech Debt
206
-
207
- Tech debt items are tracked in individual `systems/` and `cross-cutting/` docs (## Tech Debt section)
208
- and rolled up in `system-wide/tech-debt-index.md`. Items are removed when fixed.
209
- </keeping-current>
210
-
211
- <subsystem-index>
212
- ## Subsystems
213
-
214
- [POPULATE FROM system-structure.md — list each subsystem with link to its wiki folder]
215
-
216
- | Subsystem | Wiki Path | Responsibility |
217
- |-----------|-----------|----------------|
218
- | [name] | [subsystems/name/](subsystems/name/) | [one-line responsibility] |
219
- </subsystem-index>
220
- </template>
221
-
222
- <guidelines>
223
-
224
- **This is a META-DOCUMENT, not a code documentation template.**
225
- It describes the wiki system itself — its structure, conventions, and usage.
226
- It does NOT contain code references, mermaid diagrams, or architectural content.
227
-
228
- **Populating the template:**
229
- - The Directory Structure section is FIXED — it describes the standard wiki layout.
230
- Do NOT customize it per project. It shows the canonical structure.
231
- - The Document Types tables are FIXED — they describe what each document type is.
232
- - The Subsystems table at the bottom MUST be populated from `system-structure.md`
233
- (the subsystem index). If `system-structure.md` doesn't exist yet, leave the table
234
- with placeholder rows and a note to populate after `/ace:map-system`.
235
- - All wiki paths in the Subsystems table should be relative links from the wiki root.
236
-
237
- **Tone:**
238
- - Direct and practical — this is a reference, not a tutorial
239
- - Written for two audiences in parallel: humans and AI agents
240
- - Short sentences, bullet points, tables over prose
241
- - No filler, no motivational text, no history
242
-
243
- **What does NOT belong here:**
244
- - Actual code documentation (that lives in the wiki docs themselves)
245
- - Project-specific architecture details (that's system-architecture.md)
246
- - Process details about ACE workflows (that's internal to the tool)
247
- - Story or feature information
248
- - Revision history
249
-
250
- </guidelines>
251
-
252
- <evolution>
253
-
254
- This document is MOSTLY STABLE — it describes the wiki system, which rarely changes.
255
-
256
- **Update triggers:**
257
- - New document type added to the wiki system (e.g., a new knowledge category)
258
- - New subsystem mapped (update the Subsystems table)
259
- - Subsystem removed or renamed (update the Subsystems table)
260
- - Wiki conventions changed (naming rules, diagram rules, reference format)
261
-
262
- **NOT an update trigger:**
263
- - New documents created within existing categories
264
- - Content updates to any wiki document
265
- - New stories, features, or sprints
266
- - Changes to ACE tool internals
267
-
268
- **Update rules:**
269
- - UPDATE the Subsystems table when subsystems are added/removed
270
- - The rest of the document should rarely need changes
271
- - If the wiki structure itself evolves (new folders, new doc types), update the
272
- Directory Structure and Document Types sections
273
-
274
- </evolution>
275
-
276
- </wiki-readme>
@@ -1,137 +0,0 @@
1
- ---
2
- name: ace:execute-story
3
- description: Execute a fully-planned story — loads AC + Technical Solution, creates execution plan via Plan Mode, implements (solo or agent teams), runs code review, updates state, and triggers wiki mapping
4
- argument-hint: "story=<file-path|github-url> [--agent-teams-off]"
5
- allowed-tools:
6
- - Read
7
- - Bash
8
- - Write
9
- - Edit
10
- - AskUserQuestion
11
- - Glob
12
- - Grep
13
- - Agent
14
- - EnterPlanMode
15
- - ExitPlanMode
16
- ---
17
-
18
- ```xml
19
- <command>
20
-
21
- <execution-time>
22
- <runs-after>
23
- <trigger>After /ace:plan-story — once a story has AC + Technical Solution</trigger>
24
- <trigger>Anytime — to execute a fully-planned story specification</trigger>
25
- </runs-after>
26
- <use-when>
27
- <condition>A story has both Acceptance Criteria AND Technical Solution sections</condition>
28
- <condition>Story status is "Refined" (ready for implementation)</condition>
29
- </use-when>
30
- </execution-time>
31
-
32
- <input>
33
- <flags>
34
- <flag name="--agent-teams-off">
35
- Force solo execution mode regardless of agent_teams setting.
36
- Overrides the agent_teams flag in settings.json.
37
- Use when you want single-context execution even if teams are enabled.
38
- </flag>
39
- </flags>
40
-
41
- <parameters>
42
- <required>
43
- <param name="story" type="file | github-url">
44
- Story source — can be either:
45
- - **File path**: Path to a fully-planned story markdown file
46
- (must have AC + Technical Solution sections)
47
- - **GitHub URL or issue number**: GitHub story reference
48
- Must be a valid, accessible file or GitHub issue.
49
- The story MUST have been through /ace:plan-story (has AC + Technical Solution).
50
- </param>
51
- </required>
52
- </parameters>
53
- </input>
54
-
55
- <execution-context>
56
- <execute-story-workflow>@~/.claude/agile-context-engineering/workflows/execute-story.xml</execute-story-workflow>
57
- <story-template>@~/.claude/agile-context-engineering/templates/product/story.xml</story-template>
58
- <questioning>@~/.claude/agile-context-engineering/utils/questioning.xml</questioning>
59
- <ui-formatting>@~/.claude/agile-context-engineering/utils/ui-formatting.md</ui-formatting>
60
- </execution-context>
61
-
62
- <output>
63
- <objective>
64
- Take a fully-planned story (with AC + Technical Solution) and:
65
- 1. Create an execution plan via Claude Code Plan Mode
66
- 2. Execute the plan — solo or with Agent Teams
67
- 3. Run code review (3-level verification, anti-pattern detection, coding standards)
68
- 4. Present results to user for verification/approval
69
- 5. Commit implementation (single commit after approval)
70
- 6. Update state: story file, feature file, product backlog, GitHub
71
- 7. Trigger wiki mapping (background) with tech debt integration
72
-
73
- Two execution modes:
74
- - **Solo Mode** (default or --agent-teams-off): Single context, plan mode → execute
75
- - **Agent Teams Mode** (when enabled + plan recommends): Lead + teammates for parallel work
76
- </objective>
77
-
78
- <artifacts>
79
- Story file updated with Summary &amp; State section and Wiki Updates section.
80
- Feature file updated with story status.
81
- Product backlog updated with story (and possibly feature) status.
82
- Wiki documents updated/created based on implementation changes.
83
- </artifacts>
84
- </output>
85
-
86
- <process>
87
- **STRICT WORKFLOW EXECUTION — Follow the execute-story workflow STEP BY STEP.
88
- Do NOT skip steps. Do NOT improvise. Do NOT start reading code or planning
89
- until step 1 (init &amp; validate) is fully complete with the init command output parsed.**
90
-
91
- Execute the execute-story workflow from
92
- `@~/.claude/agile-context-engineering/workflows/execute-story.xml` end-to-end.
93
-
94
- **MANDATORY FIRST ACTION: Run the init command (step 1.2) BEFORE doing anything else.
95
- Do NOT read the story file manually. Do NOT explore the codebase. Do NOT start planning.
96
- The init command validates the story and provides all paths and context needed.**
97
-
98
- **CRITICAL REQUIREMENTS:**
99
- - Story MUST have Acceptance Criteria — STOP if missing
100
- - Story MUST have Technical Solution — STOP if missing
101
- - NO intermediary commits during implementation
102
- - ONE single commit per story after user approval (code + state + docs)
103
- - Code review is MANDATORY — blockers must be fixed before approval
104
- - Coding standards violations are BLOCKERS, not warnings
105
- - Dead code and backwards-compatible shims must be DELETED
106
- </process>
107
-
108
- <example-usage>
109
- ```
110
- # Execute a story from a file path
111
- /ace:execute-story \
112
- story=.ace/artifacts/product/e1-auth/f3-oauth/s1-buttons/s1-buttons.md
113
-
114
- # Execute from a GitHub issue
115
- /ace:execute-story \
116
- story=https://github.com/owner/repo/issues/95
117
-
118
- # Force solo mode (no agent teams)
119
- /ace:execute-story \
120
- story=.ace/artifacts/product/e1-auth/f3-oauth/s1-buttons/s1-buttons.md \
121
- --agent-teams-off
122
-
123
- # With just an issue number
124
- /ace:execute-story story=#95
125
- ```
126
- </example-usage>
127
-
128
- <next-steps>
129
- **After this command:**
130
- - `/ace:execute-story story=...` — Execute the next story in the feature
131
- - `/ace:review-story story=...` — Re-run code review (standalone)
132
- - `/ace:plan-story story=...` — Plan the next story
133
- - `/ace:help` — Check project status
134
- </next-steps>
135
-
136
- </command>
137
- ```
@@ -1,93 +0,0 @@
1
- ---
2
- name: ace:help
3
- description: Check project initialization status and suggest next steps
4
- argument-hint: ""
5
- allowed-tools:
6
- - Read
7
- - Bash
8
- - Write
9
- - AskUserQuestion
10
- ---
11
-
12
- ```xml
13
- <command>
14
-
15
- <execution-time>
16
- <runs-after>
17
- <trigger>At any time — to check which ACE documents exist and what to do next</trigger>
18
- <trigger>At the start of a new project — to see the initialization checklist</trigger>
19
- </runs-after>
20
- <use-when>
21
- <condition>Starting a new project and want to see what needs to be set up</condition>
22
- <condition>Returning to a project and want to check initialization status</condition>
23
- <condition>Unsure which ACE command to run next</condition>
24
- </use-when>
25
- </execution-time>
26
-
27
- <input>
28
- <flags>
29
- </flags>
30
-
31
- <parameters>
32
- <required>
33
- </required>
34
-
35
- <optional>
36
- </optional>
37
- </parameters>
38
- </input>
39
-
40
- <execution-context>
41
- <help-workflow>@~/.claude/agile-context-engineering/workflows/help.xml</help-workflow>
42
- <questioning>@~/.claude/agile-context-engineering/utils/questioning.xml</questioning>
43
- <ui-formatting>@~/.claude/agile-context-engineering/utils/ui-formatting.md</ui-formatting>
44
- </execution-context>
45
-
46
- <output>
47
- <objective>
48
- Detect which ACE documents exist (product vision, system architecture, system structure,
49
- coding standards, testing framework). Display a status dashboard showing what's done
50
- and what's missing. Suggest the next command to run based on gaps.
51
- </objective>
52
-
53
- <artifacts>
54
- - .ace/settings.json (created on first run if missing)
55
- </artifacts>
56
- </output>
57
-
58
- <process>
59
- Execute the help workflow from
60
- `@~/.claude/agile-context-engineering/workflows/help.xml` end-to-end.
61
- This is a lightweight state-check and routing workflow.
62
-
63
- CRITICAL MANDATORY STEP — DO NOT SKIP:
64
- Before displaying the status dashboard, you MUST run:
65
- ```bash
66
- node ~/.claude/agile-context-engineering/src/ace-tools.js sync-agent-teams --raw
67
- ```
68
- Then you MUST use `AskUserQuestion` to ask the user whether they want to
69
- enable or disable Claude Code Agent Teams (experimental feature).
70
- This step is NOT optional. You MUST present this question every time.
71
-
72
- When the user chooses to enable or disable Agent Teams, you MUST run the
73
- bash command — NEVER directly edit .ace/settings.json or .claude/settings.json:
74
- ```bash
75
- node ~/.claude/agile-context-engineering/src/ace-tools.js write-agent-teams true
76
- ```
77
- or
78
- ```bash
79
- node ~/.claude/agile-context-engineering/src/ace-tools.js write-agent-teams false
80
- ```
81
- The write-agent-teams command updates BOTH .ace/settings.json AND .claude/settings.json.
82
- Direct file edits will cause the two files to go out of sync.
83
- </process>
84
-
85
- <next-steps>
86
- **Specialized commands for each document:**
87
- - `/ace:plan-product-vision` — Create or update the product vision
88
- - `/ace:map-system` — Map codebase structure, architecture, and testing framework
89
- - `/ace:init-coding-standards` — Generate tailored coding standards
90
- </next-steps>
91
-
92
- </command>
93
- ```
@@ -1,83 +0,0 @@
1
- ---
2
- name: ace:init-coding-standards
3
- description: Generate a tailored coding-standards.md through codebase detection and user interview
4
- argument-hint: "[optional: context='existing standards doc or notes to build on']"
5
- allowed-tools:
6
- - Read
7
- - Bash
8
- - Glob
9
- - Grep
10
- - Write
11
- - Task
12
- - AskUserQuestion
13
- ---
14
-
15
- ```xml
16
- <command>
17
-
18
- <execution-time>
19
- <runs-after>
20
- <trigger>During /ace:help — as part of initial project setup</trigger>
21
- <trigger>After /ace:map-system — once codebase is mapped, add prescriptive standards</trigger>
22
- <trigger>Anytime — to create or refresh coding standards for a project</trigger>
23
- </runs-after>
24
- <use-when>
25
- <condition>Starting a new project and want to establish coding standards upfront (greenfield or brownfield)</condition>
26
- <condition>Onboarding AI agents to an existing codebase (prevents common AI mistakes)</condition>
27
- <condition>Current coding standards are outdated or missing</condition>
28
- <condition>Team has pain points with AI-generated code quality</condition>
29
- </use-when>
30
- </execution-time>
31
-
32
- <input>
33
- <flags>
34
- </flags>
35
-
36
- <parameters>
37
- <required>
38
- </required>
39
-
40
- <optional>
41
- <param name="context" type="file | text">
42
- Existing coding standards document, style guide, or notes
43
- to use as a starting point. Will be refined through the interview process.
44
- </param>
45
- </optional>
46
- </parameters>
47
- </input>
48
-
49
- <execution-context>
50
- <init-coding-standards-workflow>@~/.claude/agile-context-engineering/workflows/init-coding-standards.xml</init-coding-standards-workflow>
51
- <coding-standards-template>@~/.claude/agile-context-engineering/templates/wiki/coding-standards.xml</coding-standards-template>
52
- <questioning>@~/.claude/agile-context-engineering/utils/questioning.xml</questioning>
53
- <ui-formatting>@~/.claude/agile-context-engineering/utils/ui-formatting.md</ui-formatting>
54
- </execution-context>
55
-
56
- <output>
57
- <objective>
58
- Detect the project's language, paradigm, and frameworks (brownfield) or gather
59
- this from the user (greenfield). Interview the user about their coding philosophy
60
- and pain points. Generate a tailored, prescriptive coding-standards.md that prevents
61
- common AI and developer mistakes.
62
- </objective>
63
-
64
- <artifacts>
65
- .docs/wiki/system-wide/coding-standards.md
66
- </artifacts>
67
- </output>
68
-
69
- <process>
70
- Execute the init-coding-standards workflow from
71
- `@~/.claude/agile-context-engineering/workflows/init-coding-standards.xml` end-to-end.
72
- Preserve all workflow gates (validation, approvals, commits).
73
- </process>
74
-
75
- <next-steps>
76
- **After this command:**
77
- - `/ace:map-system` — Map codebase structure and architecture
78
- - `/ace:help` — Check project initialization status and next steps
79
- - Review and edit `.docs/wiki/system-wide/coding-standards.md` anytime
80
- </next-steps>
81
-
82
- </command>
83
- ```