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.
- package/.claude-plugin/plugin.json +10 -0
- package/CHANGELOG.md +82 -0
- package/README.md +27 -18
- package/agents/ace-product-owner.md +1 -1
- package/agents/ace-technical-application-architect.md +28 -0
- package/agents/ace-wiki-mapper.md +144 -29
- package/bin/install.js +67 -63
- package/hooks/ace-check-update.js +17 -9
- package/package.json +7 -5
- package/shared/lib/ace-core.js +308 -0
- package/shared/lib/ace-core.test.js +308 -0
- package/shared/lib/ace-github.js +753 -0
- package/shared/lib/ace-story.js +400 -0
- package/shared/lib/ace-story.test.js +250 -0
- package/{agile-context-engineering → shared}/utils/ui-formatting.md +299 -299
- package/skills/execute-story/SKILL.md +110 -0
- package/skills/execute-story/script.js +305 -0
- package/skills/execute-story/script.test.js +261 -0
- package/skills/execute-story/walkthrough-template.xml +255 -0
- package/{agile-context-engineering/workflows/execute-story.xml → skills/execute-story/workflow.xml} +83 -9
- package/skills/help/SKILL.md +69 -0
- package/skills/help/script.js +318 -0
- package/skills/help/script.test.js +183 -0
- package/{agile-context-engineering/workflows/help.xml → skills/help/workflow.xml} +8 -8
- package/skills/init-coding-standards/SKILL.md +72 -0
- package/{agile-context-engineering/templates/wiki/coding-standards.xml → skills/init-coding-standards/coding-standards-template.xml} +38 -0
- package/skills/init-coding-standards/script.js +59 -0
- package/skills/init-coding-standards/script.test.js +70 -0
- package/{agile-context-engineering/workflows/init-coding-standards.xml → skills/init-coding-standards/workflow.xml} +4 -9
- package/skills/map-cross-cutting/SKILL.md +89 -0
- package/skills/map-cross-cutting/workflow.xml +330 -0
- package/skills/map-guide/SKILL.md +89 -0
- package/skills/map-guide/workflow.xml +320 -0
- package/skills/map-pattern/SKILL.md +89 -0
- package/skills/map-pattern/workflow.xml +331 -0
- package/skills/map-story/SKILL.md +127 -0
- package/skills/map-story/templates/guide.xml +137 -0
- package/skills/map-story/templates/pattern.xml +159 -0
- package/skills/map-story/templates/system-cross-cutting.xml +197 -0
- package/skills/map-story/templates/walkthrough.xml +255 -0
- package/{agile-context-engineering/workflows/map-story.xml → skills/map-story/workflow.xml} +258 -9
- package/skills/map-subsystem/SKILL.md +111 -0
- package/skills/map-subsystem/script.js +60 -0
- package/skills/map-subsystem/script.test.js +68 -0
- package/skills/map-subsystem/templates/decizions.xml +115 -0
- package/skills/map-subsystem/templates/guide.xml +137 -0
- package/{agile-context-engineering/templates/wiki → skills/map-subsystem/templates}/module-discovery.xml +3 -3
- package/skills/map-subsystem/templates/pattern.xml +159 -0
- package/skills/map-subsystem/templates/system-cross-cutting.xml +197 -0
- package/skills/map-subsystem/templates/system.xml +381 -0
- package/skills/map-subsystem/templates/walkthrough.xml +255 -0
- package/{agile-context-engineering/workflows/map-subsystem.xml → skills/map-subsystem/workflow.xml} +17 -21
- package/skills/map-sys-doc/SKILL.md +90 -0
- package/skills/map-sys-doc/system.xml +381 -0
- package/skills/map-sys-doc/workflow.xml +336 -0
- package/skills/map-system/SKILL.md +85 -0
- package/skills/map-system/script.js +84 -0
- package/skills/map-system/script.test.js +73 -0
- package/skills/map-system/templates/wiki-readme.xml +297 -0
- package/{agile-context-engineering/workflows/map-system.xml → skills/map-system/workflow.xml} +11 -16
- package/skills/map-walkthrough/SKILL.md +92 -0
- package/skills/map-walkthrough/walkthrough.xml +255 -0
- package/skills/map-walkthrough/workflow.xml +457 -0
- package/skills/plan-backlog/SKILL.md +75 -0
- package/skills/plan-backlog/script.js +136 -0
- package/skills/plan-backlog/script.test.js +83 -0
- package/{agile-context-engineering/workflows/plan-backlog.xml → skills/plan-backlog/workflow.xml} +13 -21
- package/skills/plan-feature/SKILL.md +76 -0
- package/skills/plan-feature/script.js +148 -0
- package/skills/plan-feature/script.test.js +80 -0
- package/{agile-context-engineering/workflows/plan-feature.xml → skills/plan-feature/workflow.xml} +21 -29
- package/skills/plan-product-vision/SKILL.md +75 -0
- package/skills/plan-product-vision/script.js +60 -0
- package/skills/plan-product-vision/script.test.js +69 -0
- package/{agile-context-engineering/workflows/plan-product-vision.xml → skills/plan-product-vision/workflow.xml} +4 -9
- package/skills/plan-story/SKILL.md +116 -0
- package/skills/plan-story/script.js +326 -0
- package/skills/plan-story/script.test.js +240 -0
- package/skills/plan-story/story-template.xml +451 -0
- package/{agile-context-engineering/workflows/plan-story.xml → skills/plan-story/workflow.xml} +1285 -909
- package/skills/research-external-solution/SKILL.md +107 -0
- package/skills/research-external-solution/script.js +238 -0
- package/skills/research-external-solution/script.test.js +134 -0
- package/{agile-context-engineering/workflows/research-external-solution.xml → skills/research-external-solution/workflow.xml} +4 -6
- package/skills/research-integration-solution/SKILL.md +98 -0
- package/{agile-context-engineering/templates/product/story-integration-solution.xml → skills/research-integration-solution/integration-solution-template.xml} +1 -0
- package/skills/research-integration-solution/script.js +231 -0
- package/skills/research-integration-solution/script.test.js +134 -0
- package/{agile-context-engineering/workflows/research-integration-solution.xml → skills/research-integration-solution/workflow.xml} +4 -5
- package/skills/research-story-wiki/SKILL.md +92 -0
- package/skills/research-story-wiki/script.js +231 -0
- package/skills/research-story-wiki/script.test.js +138 -0
- package/{agile-context-engineering/templates/product/story-wiki.xml → skills/research-story-wiki/story-wiki-template.xml} +4 -0
- package/{agile-context-engineering/workflows/research-story-wiki.xml → skills/research-story-wiki/workflow.xml} +5 -6
- package/skills/research-technical-solution/SKILL.md +103 -0
- package/skills/research-technical-solution/script.js +231 -0
- package/skills/research-technical-solution/script.test.js +134 -0
- package/{agile-context-engineering/workflows/research-technical-solution.xml → skills/research-technical-solution/workflow.xml} +4 -5
- package/skills/review-story/SKILL.md +100 -0
- package/skills/review-story/script.js +257 -0
- package/skills/review-story/script.test.js +169 -0
- package/skills/review-story/story-template.xml +451 -0
- package/{agile-context-engineering/workflows/review-story.xml → skills/review-story/workflow.xml} +1 -3
- package/skills/update/SKILL.md +53 -0
- package/{agile-context-engineering/workflows/update.xml → skills/update/workflow.xml} +237 -207
- package/agile-context-engineering/src/ace-tools.js +0 -2881
- package/agile-context-engineering/src/ace-tools.test.js +0 -1089
- package/agile-context-engineering/templates/_command.md +0 -54
- package/agile-context-engineering/templates/_workflow.xml +0 -17
- package/agile-context-engineering/templates/config.json +0 -0
- package/agile-context-engineering/templates/product/integration-solution.xml +0 -0
- package/agile-context-engineering/templates/wiki/wiki-readme.xml +0 -276
- package/commands/ace/execute-story.md +0 -137
- package/commands/ace/help.md +0 -93
- package/commands/ace/init-coding-standards.md +0 -83
- package/commands/ace/map-story.md +0 -156
- package/commands/ace/map-subsystem.md +0 -138
- package/commands/ace/map-system.md +0 -92
- package/commands/ace/plan-backlog.md +0 -83
- package/commands/ace/plan-feature.md +0 -89
- package/commands/ace/plan-product-vision.md +0 -81
- package/commands/ace/plan-story.md +0 -145
- package/commands/ace/research-external-solution.md +0 -138
- package/commands/ace/research-integration-solution.md +0 -135
- package/commands/ace/research-story-wiki.md +0 -116
- package/commands/ace/research-technical-solution.md +0 -147
- package/commands/ace/review-story.md +0 -109
- package/commands/ace/update.md +0 -54
- /package/{agile-context-engineering → shared}/utils/questioning.xml +0 -0
- /package/{agile-context-engineering/templates/product/story.xml → skills/execute-story/story-template.xml} +0 -0
- /package/{agile-context-engineering/templates/wiki → skills/map-cross-cutting}/system-cross-cutting.xml +0 -0
- /package/{agile-context-engineering/templates/wiki → skills/map-guide}/guide.xml +0 -0
- /package/{agile-context-engineering/templates/wiki → skills/map-pattern}/pattern.xml +0 -0
- /package/{agile-context-engineering/templates/wiki → skills/map-story/templates}/decizions.xml +0 -0
- /package/{agile-context-engineering/templates/wiki → skills/map-story/templates}/system.xml +0 -0
- /package/{agile-context-engineering/templates/wiki → skills/map-story/templates}/tech-debt-index.xml +0 -0
- /package/{agile-context-engineering/templates/wiki → skills/map-subsystem/templates}/subsystem-architecture.xml +0 -0
- /package/{agile-context-engineering/templates/wiki → skills/map-subsystem/templates}/subsystem-structure.xml +0 -0
- /package/{agile-context-engineering/templates/wiki → skills/map-system/templates}/system-architecture.xml +0 -0
- /package/{agile-context-engineering/templates/wiki → skills/map-system/templates}/system-structure.xml +0 -0
- /package/{agile-context-engineering/templates/wiki → skills/map-system/templates}/testing-framework.xml +0 -0
- /package/{agile-context-engineering/templates/product/product-backlog.xml → skills/plan-backlog/product-backlog-template.xml} +0 -0
- /package/{agile-context-engineering/templates/product/feature.xml → skills/plan-feature/feature-template.xml} +0 -0
- /package/{agile-context-engineering/templates/product/product-vision.xml → skills/plan-product-vision/product-vision-template.xml} +0 -0
- /package/{agile-context-engineering/templates/product/external-solution.xml → skills/research-external-solution/external-solution-template.xml} +0 -0
- /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
|
|
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 & 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 & 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
|
-
```
|
package/commands/ace/help.md
DELETED
|
@@ -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
|
-
```
|