gaia-framework 1.26.0 → 1.27.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.
- package/README.md +285 -586
- package/gaia-install.sh +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,10 +1,73 @@
|
|
|
1
1
|
# GAIA — Generative Agile Intelligence Architecture
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[]()
|
|
4
|
+
[]()
|
|
5
|
+
[]()
|
|
6
|
+
[]()
|
|
4
7
|
|
|
5
|
-
AI agent framework for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) that orchestrates software product development through 25 specialized agents
|
|
8
|
+
AI agent framework for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) that orchestrates software product development through **25 specialized agents**, **64 workflows**, and **8 shared skills** — from initial research all the way to deployment.
|
|
6
9
|
|
|
7
|
-
GAIA
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
### Why GAIA?
|
|
13
|
+
|
|
14
|
+
Using Claude Code alone, you prompt an AI assistant. With GAIA, you manage a **team of AI specialists** that follow a proven product lifecycle:
|
|
15
|
+
|
|
16
|
+
- **Structured lifecycle** — 5 phases from analysis to deployment, with quality gates that enforce standards at every transition
|
|
17
|
+
- **25 specialized agents** — each with a persona, domain expertise, and persistent memory that improves over time
|
|
18
|
+
- **Built-in quality gates** — 17 enforced gates that HALT workflows when standards aren't met (not advisory — hard stops)
|
|
19
|
+
- **6-gate review process** — every story passes code review, QA, security, test automation, test review, and performance review before completion
|
|
20
|
+
- **Checkpoint/resume** — long-running workflows survive context loss with sha256-verified checkpoints
|
|
21
|
+
- **Brownfield support** — onboard existing codebases with automated discovery, documentation generation, and gap analysis
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## Prerequisites
|
|
26
|
+
|
|
27
|
+
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (requires Anthropic account)
|
|
28
|
+
- Node.js 18+
|
|
29
|
+
- Git
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## Quick Start
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
# Install GAIA into your project
|
|
37
|
+
npx gaia-framework init ~/my-project
|
|
38
|
+
|
|
39
|
+
# Open in Claude Code
|
|
40
|
+
cd ~/my-project && claude
|
|
41
|
+
|
|
42
|
+
# Generate pre-resolved configs (one-time setup)
|
|
43
|
+
/gaia-build-configs
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Then try your first workflow:
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
# Describe a small feature and get a tech spec in 30 seconds
|
|
50
|
+
/gaia-quick-spec
|
|
51
|
+
|
|
52
|
+
# Implement it immediately
|
|
53
|
+
/gaia-quick-dev
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Or launch the orchestrator to explore all capabilities:
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
/gaia
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### 5 essential commands
|
|
63
|
+
|
|
64
|
+
| Command | What it does |
|
|
65
|
+
|---------|-------------|
|
|
66
|
+
| `/gaia` | Launch the orchestrator — shows categories and routes you |
|
|
67
|
+
| `/gaia-dev-story` | Implement a user story end-to-end |
|
|
68
|
+
| `/gaia-quick-spec` | Create a rapid tech spec for small changes |
|
|
69
|
+
| `/gaia-quick-dev` | Implement a quick spec |
|
|
70
|
+
| `/gaia-help` | Context-sensitive help for wherever you are |
|
|
8
71
|
|
|
9
72
|
---
|
|
10
73
|
|
|
@@ -16,179 +79,87 @@ GAIA gives you a team of AI agents with distinct personas, structured workflows
|
|
|
16
79
|
npx gaia-framework init .
|
|
17
80
|
```
|
|
18
81
|
|
|
19
|
-
This clones the latest GAIA release from GitHub and installs it into the current directory.
|
|
20
|
-
|
|
21
82
|
```bash
|
|
22
|
-
# Install into a
|
|
83
|
+
# Install into a specific directory
|
|
23
84
|
npx gaia-framework init ~/my-new-project
|
|
24
85
|
|
|
25
|
-
# Skip interactive prompts
|
|
86
|
+
# Skip interactive prompts
|
|
26
87
|
npx gaia-framework init --yes ~/my-project
|
|
27
88
|
```
|
|
28
89
|
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
### Using the shell script directly
|
|
90
|
+
### Using the shell script
|
|
32
91
|
|
|
33
92
|
```bash
|
|
34
|
-
# Clone the repo
|
|
35
93
|
git clone https://github.com/J-louage/Gaia-framework.git
|
|
36
|
-
|
|
37
|
-
# Install into your project
|
|
38
94
|
bash Gaia-framework/gaia-install.sh init ~/my-project
|
|
39
|
-
|
|
40
|
-
# Or use a local copy as source
|
|
41
|
-
bash gaia-install.sh init --source ~/Gaia-framework ~/my-project
|
|
42
95
|
```
|
|
43
96
|
|
|
44
|
-
The script resolves sources in this order: `--source` flag, `$GAIA_SOURCE` env var, script's own directory, GitHub clone.
|
|
45
|
-
|
|
46
97
|
### What the installer does
|
|
47
98
|
|
|
48
99
|
1. Copies the `_gaia/` framework into your project
|
|
49
100
|
2. Creates `docs/` artifact directories (planning, implementation, test, creative)
|
|
50
|
-
3. Creates memory sidecar directories
|
|
51
|
-
4.
|
|
52
|
-
5.
|
|
53
|
-
6.
|
|
54
|
-
7.
|
|
55
|
-
8. Appends GAIA entries to `.gitignore`
|
|
101
|
+
3. Creates memory sidecar directories
|
|
102
|
+
4. Prompts for project name and user name → writes to `global.yaml`
|
|
103
|
+
5. Copies `CLAUDE.md` to your project root
|
|
104
|
+
6. Installs 104 slash commands to `.claude/commands/`
|
|
105
|
+
7. Appends GAIA entries to `.gitignore`
|
|
56
106
|
|
|
57
|
-
### Updating
|
|
107
|
+
### Updating
|
|
58
108
|
|
|
59
109
|
```bash
|
|
60
|
-
# Via npx
|
|
61
110
|
npx gaia-framework update .
|
|
62
|
-
|
|
63
|
-
# Via shell script
|
|
64
|
-
bash gaia-install.sh update ~/my-project
|
|
65
111
|
```
|
|
66
112
|
|
|
67
|
-
Update refreshes all framework files
|
|
68
|
-
|
|
69
|
-
Changed files are backed up to `_gaia/_backups/{timestamp}/` before overwriting.
|
|
113
|
+
Update refreshes all framework files while preserving your configuration, agent memory, and `CLAUDE.md`. Changed files are backed up to `_gaia/_backups/{timestamp}/`.
|
|
70
114
|
|
|
71
|
-
### Validating
|
|
115
|
+
### Validating
|
|
72
116
|
|
|
73
117
|
```bash
|
|
74
|
-
|
|
75
|
-
npx gaia-framework
|
|
76
|
-
|
|
77
|
-
# Show version, module list, command count, sidecar status
|
|
78
|
-
npx gaia-framework status .
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
### Installer options
|
|
82
|
-
|
|
83
|
-
```
|
|
84
|
-
gaia-install.sh <command> [options] [target]
|
|
85
|
-
|
|
86
|
-
Commands:
|
|
87
|
-
init Install GAIA into a project
|
|
88
|
-
update Update framework files (preserves config and memory)
|
|
89
|
-
validate Check installation integrity
|
|
90
|
-
status Show installation info
|
|
91
|
-
|
|
92
|
-
Options:
|
|
93
|
-
--source <path> Local GAIA source directory
|
|
94
|
-
--yes Skip confirmation prompts
|
|
95
|
-
--dry-run Show what would be done without making changes
|
|
96
|
-
--verbose Show detailed progress
|
|
97
|
-
--help Show help
|
|
118
|
+
npx gaia-framework validate . # 32 integrity checks
|
|
119
|
+
npx gaia-framework status . # version, module list, command count
|
|
98
120
|
```
|
|
99
121
|
|
|
100
122
|
---
|
|
101
123
|
|
|
102
|
-
##
|
|
124
|
+
## How It Works
|
|
103
125
|
|
|
104
|
-
|
|
126
|
+
### 5-phase product lifecycle
|
|
105
127
|
|
|
106
|
-
```
|
|
107
|
-
|
|
108
|
-
|
|
128
|
+
```
|
|
129
|
+
Phase 1: Analysis → Phase 2: Planning → Phase 3: Solutioning → Phase 4: Implementation → Phase 5: Deployment
|
|
130
|
+
(Elena) (Derek/Christy) (Theo/Zara/Soren) (Nate/Dev Agents) (Soren)
|
|
109
131
|
```
|
|
110
132
|
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
### 5 essential commands
|
|
114
|
-
|
|
115
|
-
| Command | What it does |
|
|
116
|
-
|---------|-------------|
|
|
117
|
-
| `/gaia` | Launch the orchestrator — shows categories and routes you |
|
|
118
|
-
| `/gaia-dev-story` | Implement a user story end-to-end |
|
|
119
|
-
| `/gaia-quick-spec` | Create a rapid tech spec for small changes |
|
|
120
|
-
| `/gaia-quick-dev` | Implement a quick spec |
|
|
121
|
-
| `/gaia-help` | Context-sensitive help for wherever you are |
|
|
122
|
-
|
|
123
|
-
### First-time setup
|
|
133
|
+
Every phase has **quality gates** — enforced checks that halt the workflow if prerequisites aren't met. You can't create an architecture without a reviewed PRD. You can't start a sprint without a readiness check. You can't deploy without passing all reviews.
|
|
124
134
|
|
|
125
|
-
|
|
135
|
+
### Entry points
|
|
126
136
|
|
|
127
|
-
|
|
137
|
+
| Path | Command | When to use |
|
|
138
|
+
|------|---------|-------------|
|
|
139
|
+
| New project | Start at Phase 1 | Greenfield — building from scratch |
|
|
140
|
+
| Existing project | `/gaia-brownfield` | Brownfield — onboarding existing codebase |
|
|
141
|
+
| Small change | `/gaia-quick-spec` | Under 5 files, under 1 day |
|
|
142
|
+
| Resume | `/gaia-resume` | Continue after context loss |
|
|
128
143
|
|
|
129
|
-
|
|
144
|
+
### Model assignment
|
|
130
145
|
|
|
131
|
-
|
|
132
|
-
_gaia/
|
|
133
|
-
├── _config/ # Global config, manifests, agent registry
|
|
134
|
-
│ ├── global.yaml # Project settings — single source of truth
|
|
135
|
-
│ └── manifest.yaml # Module registry
|
|
136
|
-
├── _memory/ # Persistent agent memory + checkpoints
|
|
137
|
-
│ ├── checkpoints/ # Workflow progress snapshots
|
|
138
|
-
│ └── *-sidecar/ # Per-agent persistent memory (9 sidecars)
|
|
139
|
-
├── core/ # Execution engine, protocols, shared tasks
|
|
140
|
-
│ ├── engine/ # workflow.xml, task-runner.xml, error-recovery.xml
|
|
141
|
-
│ ├── tasks/ # 16 standalone review/utility tasks
|
|
142
|
-
│ └── workflows/ # Brainstorming, party mode, advanced elicitation
|
|
143
|
-
├── lifecycle/ # Product lifecycle (5 phases)
|
|
144
|
-
│ ├── agents/ # 11 lifecycle agents
|
|
145
|
-
│ ├── workflows/ # 36 workflows across 5 phases + anytime + quick-flow
|
|
146
|
-
│ ├── templates/ # 16 document templates (PRD, architecture, API docs, brownfield, etc.)
|
|
147
|
-
│ └── teams/ # Pre-built team compositions
|
|
148
|
-
├── dev/ # Developer tooling
|
|
149
|
-
│ ├── agents/ # 6 stack-specific developers + base
|
|
150
|
-
│ ├── skills/ # 8 shared skills with sectioned loading
|
|
151
|
-
│ └── knowledge/ # Stack-specific patterns (Angular, React, Flutter, etc.)
|
|
152
|
-
├── creative/ # Creative intelligence
|
|
153
|
-
│ ├── agents/ # 6 creative agents
|
|
154
|
-
│ ├── workflows/ # 7 creative workflows
|
|
155
|
-
│ └── data/ # Methods, frameworks, story types
|
|
156
|
-
└── testing/ # Test architecture
|
|
157
|
-
├── agents/ # Test Architect (Sable)
|
|
158
|
-
├── workflows/ # 12 testing workflows
|
|
159
|
-
└── knowledge/ # 20+ testing knowledge fragments
|
|
160
|
-
```
|
|
146
|
+
Each command declares which Claude model to use. **Opus** handles deep reasoning, architectural decisions, and complex analysis (27 commands). **Sonnet** handles structured generation, template-following, and status reporting (77 commands). Claude Code auto-selects the model per workflow.
|
|
161
147
|
|
|
162
|
-
###
|
|
148
|
+
### Execution modes
|
|
163
149
|
|
|
164
|
-
|
|
165
|
-
|-----------|-------|
|
|
166
|
-
| Modules | 5 (core, lifecycle, dev, creative, testing) |
|
|
167
|
-
| Agents | 25 with distinct personas |
|
|
168
|
-
| Workflows | 59 covering the full product lifecycle |
|
|
169
|
-
| Standalone tasks | 16 (reviews, audits, utilities) |
|
|
170
|
-
| Shared skills | 8 with 47 loadable sections |
|
|
171
|
-
| Slash commands | 100 |
|
|
172
|
-
| Knowledge fragments | 45 (testing, stack patterns) |
|
|
173
|
-
| Agent memory sidecars | 9 |
|
|
174
|
-
| Output artifact dirs | 4 |
|
|
150
|
+
Workflows support three modes: **normal** (pauses for confirmation at each checkpoint), **YOLO** (auto-proceeds without pausing), and **planning** (presents a structured execution plan for approval before any steps run). You can switch between normal and YOLO mid-workflow.
|
|
175
151
|
|
|
176
152
|
---
|
|
177
153
|
|
|
178
154
|
## Agents
|
|
179
155
|
|
|
180
|
-
Every agent has a name, persona, and specialization.
|
|
181
|
-
|
|
182
|
-
### Orchestrator
|
|
183
|
-
|
|
184
|
-
| Agent | Name | Role |
|
|
185
|
-
|-------|------|------|
|
|
186
|
-
| Orchestrator | Gaia | Routes requests, manages resources, presents categorized menus |
|
|
156
|
+
Every agent has a name, persona, and specialization. Activate any agent directly with `/gaia-agent-{name}` or let the orchestrator route you.
|
|
187
157
|
|
|
188
158
|
### Lifecycle Agents
|
|
189
159
|
|
|
190
160
|
| Agent | Name | Specialization | Command |
|
|
191
161
|
|-------|------|---------------|---------|
|
|
162
|
+
| Orchestrator | Gaia | Routes requests, manages resources | `/gaia` |
|
|
192
163
|
| Business Analyst | Elena | Market research, domain analysis, product briefs | `/gaia-agent-analyst` |
|
|
193
164
|
| Product Manager | Derek | PRDs, requirements, stakeholder alignment | `/gaia-agent-pm` |
|
|
194
165
|
| UX Designer | Christy | User research, interaction design, UI patterns | `/gaia-agent-ux-designer` |
|
|
@@ -239,536 +210,264 @@ Workflows are structured multi-step processes. Each has a `workflow.yaml` config
|
|
|
239
210
|
|
|
240
211
|
### Phase 1: Analysis
|
|
241
212
|
|
|
242
|
-
| Command | Workflow | Agent | Output |
|
|
243
|
-
|
|
244
|
-
| `/gaia-brainstorm` | Brainstorm Project | Elena | `docs/planning-artifacts/` |
|
|
245
|
-
| `/gaia-market-research` | Market Research | Elena | `docs/planning-artifacts/` |
|
|
246
|
-
| `/gaia-domain-research` | Domain Research | Elena | `docs/planning-artifacts/` |
|
|
247
|
-
| `/gaia-tech-research` | Technical Research | Elena | `docs/planning-artifacts/` |
|
|
248
|
-
| `/gaia-product-brief` | Create Product Brief | Elena | `docs/planning-artifacts/` |
|
|
213
|
+
| Command | Workflow | Agent | Model | Output |
|
|
214
|
+
|---------|----------|-------|-------|--------|
|
|
215
|
+
| `/gaia-brainstorm` | Brainstorm Project | Elena | Sonnet | `docs/planning-artifacts/` |
|
|
216
|
+
| `/gaia-market-research` | Market Research | Elena | Sonnet | `docs/planning-artifacts/` |
|
|
217
|
+
| `/gaia-domain-research` | Domain Research | Elena | Sonnet | `docs/planning-artifacts/` |
|
|
218
|
+
| `/gaia-tech-research` | Technical Research | Elena | Sonnet | `docs/planning-artifacts/` |
|
|
219
|
+
| `/gaia-product-brief` | Create Product Brief | Elena | Sonnet | `docs/planning-artifacts/` |
|
|
249
220
|
|
|
250
221
|
### Phase 2: Planning
|
|
251
222
|
|
|
252
|
-
| Command | Workflow | Agent | Output |
|
|
253
|
-
|
|
254
|
-
| `/gaia-create-prd` | Create PRD | Derek | `docs/planning-artifacts/` |
|
|
255
|
-
| `/gaia-validate-prd` | Validate PRD | Derek | `docs/planning-artifacts/` |
|
|
256
|
-
| `/gaia-edit-prd` | Edit PRD | Derek | `docs/planning-artifacts/` |
|
|
257
|
-
| `/gaia-create-ux` | Create UX Design | Christy | `docs/planning-artifacts/` |
|
|
223
|
+
| Command | Workflow | Agent | Model | Output |
|
|
224
|
+
|---------|----------|-------|-------|--------|
|
|
225
|
+
| `/gaia-create-prd` | Create PRD | Derek | Opus | `docs/planning-artifacts/` |
|
|
226
|
+
| `/gaia-validate-prd` | Validate PRD | Derek | Sonnet | `docs/planning-artifacts/` |
|
|
227
|
+
| `/gaia-edit-prd` | Edit PRD | Derek | Opus | `docs/planning-artifacts/` |
|
|
228
|
+
| `/gaia-create-ux` | Create UX Design | Christy | Opus | `docs/planning-artifacts/` |
|
|
258
229
|
|
|
259
230
|
### Phase 3: Solutioning
|
|
260
231
|
|
|
261
|
-
| Command | Workflow | Agent | Output |
|
|
262
|
-
|
|
263
|
-
| `/gaia-create-arch` | Create Architecture | Theo | `docs/planning-artifacts/` |
|
|
264
|
-
| `/gaia-create-epics` | Create Epics & Stories | Derek | `docs/planning-artifacts/` |
|
|
265
|
-
| `/gaia-readiness-check` | Implementation Readiness | Theo | `docs/planning-artifacts/` |
|
|
266
|
-
| `/gaia-threat-model` | Security Threat Model | Zara | `docs/planning-artifacts/` |
|
|
267
|
-
| `/gaia-infra-design` | Infrastructure Design | Soren | `docs/planning-artifacts/` |
|
|
232
|
+
| Command | Workflow | Agent | Model | Output |
|
|
233
|
+
|---------|----------|-------|-------|--------|
|
|
234
|
+
| `/gaia-create-arch` | Create Architecture | Theo | Opus | `docs/planning-artifacts/` |
|
|
235
|
+
| `/gaia-create-epics` | Create Epics & Stories | Derek | Opus | `docs/planning-artifacts/` |
|
|
236
|
+
| `/gaia-readiness-check` | Implementation Readiness | Theo | Opus | `docs/planning-artifacts/` |
|
|
237
|
+
| `/gaia-threat-model` | Security Threat Model | Zara | Opus | `docs/planning-artifacts/` |
|
|
238
|
+
| `/gaia-infra-design` | Infrastructure Design | Soren | Opus | `docs/planning-artifacts/` |
|
|
268
239
|
|
|
269
240
|
### Phase 4: Implementation
|
|
270
241
|
|
|
271
|
-
| Command | Workflow | Agent | Output |
|
|
272
|
-
|
|
273
|
-
| `/gaia-sprint-plan` | Sprint Planning | Nate | `docs/implementation-artifacts/` |
|
|
274
|
-
| `/gaia-sprint-status` | Sprint Status | Nate | `docs/implementation-artifacts/` |
|
|
275
|
-
| `/gaia-epic-status` | Epic Status | Nate | `docs/implementation-artifacts/` |
|
|
276
|
-
| `/gaia-create-story` | Create Story | Derek | `docs/implementation-artifacts/` |
|
|
277
|
-
| `/gaia-validate-story` | Validate Story | Derek | `docs/implementation-artifacts/` |
|
|
278
|
-
| `/gaia-fix-story` | Fix Story | Nate | `docs/implementation-artifacts/` |
|
|
279
|
-
| `/gaia-dev-story` | Dev Story | Stack dev | `docs/implementation-artifacts/` |
|
|
280
|
-
| `/gaia-code-review` | Code Review | Stack dev | `docs/implementation-artifacts/` |
|
|
281
|
-
| `/gaia-qa-tests` | QA Generate Tests | Vera | `docs/implementation-artifacts/` |
|
|
282
|
-
| `/gaia-security-review` | Security Review | Zara | `docs/implementation-artifacts/` |
|
|
283
|
-
| `/gaia-triage-findings` | Triage Findings | Nate | `docs/implementation-artifacts/` |
|
|
284
|
-
| `/gaia-tech-debt-review` | Tech Debt Review | Nate | `docs/implementation-artifacts/` |
|
|
285
|
-
| `/gaia-change-request` | Change Request | Derek | `docs/planning-artifacts/` |
|
|
286
|
-
| `/gaia-add-stories` | Add Stories | Derek | `docs/planning-artifacts/` |
|
|
287
|
-
| `/gaia-correct-course` | Correct Course | Nate | `docs/implementation-artifacts/` |
|
|
288
|
-
| `/gaia-retro` | Retrospective | Nate | `docs/implementation-artifacts/` |
|
|
242
|
+
| Command | Workflow | Agent | Model | Output |
|
|
243
|
+
|---------|----------|-------|-------|--------|
|
|
244
|
+
| `/gaia-sprint-plan` | Sprint Planning | Nate | Sonnet | `docs/implementation-artifacts/` |
|
|
245
|
+
| `/gaia-sprint-status` | Sprint Status | Nate | Sonnet | `docs/implementation-artifacts/` |
|
|
246
|
+
| `/gaia-epic-status` | Epic Status | Nate | Sonnet | `docs/implementation-artifacts/` |
|
|
247
|
+
| `/gaia-create-story` | Create Story | Derek | Sonnet | `docs/implementation-artifacts/` |
|
|
248
|
+
| `/gaia-validate-story` | Validate Story | Derek | Sonnet | `docs/implementation-artifacts/` |
|
|
249
|
+
| `/gaia-fix-story` | Fix Story | Nate | Sonnet | `docs/implementation-artifacts/` |
|
|
250
|
+
| `/gaia-dev-story` | Dev Story | Stack dev | Opus | `docs/implementation-artifacts/` |
|
|
251
|
+
| `/gaia-code-review` | Code Review | Stack dev | Opus | `docs/implementation-artifacts/` |
|
|
252
|
+
| `/gaia-qa-tests` | QA Generate Tests | Vera | Opus | `docs/implementation-artifacts/` |
|
|
253
|
+
| `/gaia-security-review` | Security Review | Zara | Opus | `docs/implementation-artifacts/` |
|
|
254
|
+
| `/gaia-triage-findings` | Triage Findings | Nate | Sonnet | `docs/implementation-artifacts/` |
|
|
255
|
+
| `/gaia-tech-debt-review` | Tech Debt Review | Nate | Sonnet | `docs/implementation-artifacts/` |
|
|
256
|
+
| `/gaia-change-request` | Change Request | Derek | Opus | `docs/planning-artifacts/` |
|
|
257
|
+
| `/gaia-add-stories` | Add Stories | Derek | Sonnet | `docs/planning-artifacts/` |
|
|
258
|
+
| `/gaia-correct-course` | Correct Course | Nate | Sonnet | `docs/implementation-artifacts/` |
|
|
259
|
+
| `/gaia-retro` | Retrospective | Nate | Sonnet | `docs/implementation-artifacts/` |
|
|
289
260
|
|
|
290
261
|
### Phase 5: Deployment
|
|
291
262
|
|
|
292
|
-
| Command | Workflow | Agent | Output |
|
|
293
|
-
|
|
294
|
-
| `/gaia-release-plan` | Release Plan | Soren | `docs/implementation-artifacts/` |
|
|
295
|
-
| `/gaia-deploy-checklist` | Deployment Checklist | Soren | `docs/implementation-artifacts/` |
|
|
296
|
-
| `/gaia-post-deploy` | Post-Deploy Verify | Soren | `docs/implementation-artifacts/` |
|
|
297
|
-
| `/gaia-rollback-plan` | Rollback Plan | Soren | `docs/implementation-artifacts/` |
|
|
263
|
+
| Command | Workflow | Agent | Model | Output |
|
|
264
|
+
|---------|----------|-------|-------|--------|
|
|
265
|
+
| `/gaia-release-plan` | Release Plan | Soren | Sonnet | `docs/implementation-artifacts/` |
|
|
266
|
+
| `/gaia-deploy-checklist` | Deployment Checklist | Soren | Sonnet | `docs/implementation-artifacts/` |
|
|
267
|
+
| `/gaia-post-deploy` | Post-Deploy Verify | Soren | Sonnet | `docs/implementation-artifacts/` |
|
|
268
|
+
| `/gaia-rollback-plan` | Rollback Plan | Soren | Sonnet | `docs/implementation-artifacts/` |
|
|
298
269
|
|
|
299
270
|
### Quick Flow
|
|
300
271
|
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
|
304
|
-
|
|
305
|
-
| `/gaia-quick-spec` | Quick Spec | Rapid tech spec — skip full PRD |
|
|
306
|
-
| `/gaia-quick-dev` | Quick Dev | Implement a quick spec immediately |
|
|
272
|
+
| Command | Workflow | Model | Description |
|
|
273
|
+
|---------|----------|-------|-------------|
|
|
274
|
+
| `/gaia-quick-spec` | Quick Spec | Sonnet | Rapid tech spec — skip full PRD |
|
|
275
|
+
| `/gaia-quick-dev` | Quick Dev | Sonnet | Implement a quick spec immediately |
|
|
307
276
|
|
|
308
277
|
### Creative Workflows
|
|
309
278
|
|
|
310
|
-
| Command | Workflow | Agent | Output |
|
|
311
|
-
|
|
312
|
-
| `/gaia-creative-sprint` | Creative Sprint | Multi-agent | `docs/creative-artifacts/` |
|
|
313
|
-
| `/gaia-design-thinking` | Design Thinking | Lyra | `docs/creative-artifacts/` |
|
|
314
|
-
| `/gaia-innovation` | Innovation Strategy | Orion | `docs/creative-artifacts/` |
|
|
315
|
-
| `/gaia-problem-solving` | Problem Solving | Nova | `docs/creative-artifacts/` |
|
|
316
|
-
| `/gaia-storytelling` | Storytelling | Elara | `docs/creative-artifacts/` |
|
|
317
|
-
| `/gaia-slide-deck` | Slide Deck | Vermeer | `docs/creative-artifacts/` |
|
|
318
|
-
| `/gaia-pitch-deck` | Pitch Deck | Vermeer | `docs/creative-artifacts/` |
|
|
279
|
+
| Command | Workflow | Agent | Model | Output |
|
|
280
|
+
|---------|----------|-------|-------|--------|
|
|
281
|
+
| `/gaia-creative-sprint` | Creative Sprint | Multi-agent | Opus | `docs/creative-artifacts/` |
|
|
282
|
+
| `/gaia-design-thinking` | Design Thinking | Lyra | Opus | `docs/creative-artifacts/` |
|
|
283
|
+
| `/gaia-innovation` | Innovation Strategy | Orion | Opus | `docs/creative-artifacts/` |
|
|
284
|
+
| `/gaia-problem-solving` | Problem Solving | Nova | Opus | `docs/creative-artifacts/` |
|
|
285
|
+
| `/gaia-storytelling` | Storytelling | Elara | Sonnet | `docs/creative-artifacts/` |
|
|
286
|
+
| `/gaia-slide-deck` | Slide Deck | Vermeer | Sonnet | `docs/creative-artifacts/` |
|
|
287
|
+
| `/gaia-pitch-deck` | Pitch Deck | Vermeer | Sonnet | `docs/creative-artifacts/` |
|
|
319
288
|
|
|
320
289
|
### Testing Workflows
|
|
321
290
|
|
|
322
|
-
Testing workflows are **integrated into the main lifecycle** — they are not optional standalone tools.
|
|
323
|
-
|
|
324
|
-
|
|
|
325
|
-
|
|
326
|
-
|
|
|
327
|
-
|
|
|
328
|
-
|
|
|
329
|
-
|
|
|
330
|
-
|
|
|
331
|
-
|
|
|
332
|
-
|
|
333
|
-
|
|
|
334
|
-
|
|
335
|
-
| `/gaia-
|
|
336
|
-
| `/gaia-
|
|
337
|
-
| `/gaia-
|
|
338
|
-
| `/gaia-test-automate` | Test Automation | Sable | `docs/test-artifacts/` |
|
|
339
|
-
| `/gaia-test-review` | Test Review | Sable | `docs/test-artifacts/` |
|
|
340
|
-
| `/gaia-ci-setup` | CI Setup | Sable | `docs/test-artifacts/` |
|
|
341
|
-
| `/gaia-nfr` | NFR Assessment | Sable | `docs/test-artifacts/` |
|
|
342
|
-
| `/gaia-trace` | Traceability Matrix | Sable | `docs/test-artifacts/` |
|
|
343
|
-
| `/gaia-a11y-testing` | Accessibility Testing | Sable | `docs/test-artifacts/` |
|
|
344
|
-
| `/gaia-perf-testing` | Performance Testing | Sable | `docs/test-artifacts/` |
|
|
345
|
-
| `/gaia-mobile-testing` | Mobile Testing | Sable | `docs/test-artifacts/` |
|
|
346
|
-
| `/gaia-teach-testing` | Teach Me Testing | Sable | `docs/test-artifacts/` |
|
|
291
|
+
Testing workflows are **integrated into the main lifecycle** — they are not optional standalone tools.
|
|
292
|
+
|
|
293
|
+
| Command | Workflow | Agent | Model | Output |
|
|
294
|
+
|---------|----------|-------|-------|--------|
|
|
295
|
+
| `/gaia-test-design` | Test Design | Sable | Opus | `docs/test-artifacts/` |
|
|
296
|
+
| `/gaia-test-framework` | Test Framework | Sable | Sonnet | `docs/test-artifacts/` |
|
|
297
|
+
| `/gaia-atdd` | ATDD | Sable | Sonnet | `docs/test-artifacts/` |
|
|
298
|
+
| `/gaia-test-automate` | Test Automation | Sable | Sonnet | `docs/test-artifacts/` |
|
|
299
|
+
| `/gaia-test-review` | Test Review | Sable | Sonnet | `docs/test-artifacts/` |
|
|
300
|
+
| `/gaia-ci-setup` | CI Setup | Sable | Sonnet | `docs/test-artifacts/` |
|
|
301
|
+
| `/gaia-nfr` | NFR Assessment | Sable | Opus | `docs/test-artifacts/` |
|
|
302
|
+
| `/gaia-trace` | Traceability Matrix | Sable | Sonnet | `docs/test-artifacts/` |
|
|
303
|
+
| `/gaia-a11y-testing` | Accessibility Testing | Sable | Sonnet | `docs/test-artifacts/` |
|
|
304
|
+
| `/gaia-perf-testing` | Performance Testing | Sable | Sonnet | `docs/test-artifacts/` |
|
|
305
|
+
| `/gaia-mobile-testing` | Mobile Testing | Sable | Sonnet | `docs/test-artifacts/` |
|
|
306
|
+
| `/gaia-teach-testing` | Teach Me Testing | Sable | Sonnet | `docs/test-artifacts/` |
|
|
347
307
|
|
|
348
308
|
### Anytime Workflows
|
|
349
309
|
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
|
353
|
-
|
|
354
|
-
| `/gaia-
|
|
355
|
-
| `/gaia-
|
|
356
|
-
| `/gaia-
|
|
357
|
-
| `/gaia-
|
|
358
|
-
| `/gaia-
|
|
359
|
-
| `/gaia-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
|
370
|
-
|
|
371
|
-
| `
|
|
372
|
-
| `
|
|
373
|
-
| `
|
|
374
|
-
| `
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
|
387
|
-
|
|
388
|
-
| 5. Dependency Map | External services, infrastructure, library deps with CVE risk, Mermaid dependency graph |
|
|
389
|
-
| 6. NFR Assessment & Baselines | Code quality, security posture, performance, test coverage — output to `test-artifacts/nfr-assessment.md` (canonical) |
|
|
390
|
-
| 7. Performance Test Plan | Performance budgets, load test scenarios, Core Web Vitals targets — output to `test-artifacts/` (**REQUIRED**) |
|
|
391
|
-
| 8. Create PRD for Gaps | Gap-focused PRD with NFR baselines from step 6, references all upstream artifacts |
|
|
392
|
-
| 9. Map Architecture with Diagrams | C4 Mermaid diagrams (Level 1 + 2), 3–5 sequence diagrams, as-is/target delta |
|
|
393
|
-
| 10. Epics/Stories & Onboard Developer | Gap stories + developer knowledge base index linking all artifacts |
|
|
394
|
-
|
|
395
|
-
**Design rules:**
|
|
396
|
-
- All diagrams use **Mermaid syntax** — no ASCII art
|
|
397
|
-
- All API docs use **Swagger/OpenAPI format**
|
|
398
|
-
- Flow diagrams limited to **3–5 key flows** per document
|
|
399
|
-
- NFR baselines are **measured from the codebase**, not estimated
|
|
400
|
-
|
|
401
|
-
**Output artifacts** (up to 11, depending on detected capabilities):
|
|
402
|
-
|
|
403
|
-
| Artifact | Location | Always | Conditional |
|
|
404
|
-
|----------|----------|--------|-------------|
|
|
405
|
-
| `project-documentation.md` | `planning-artifacts/` | Yes | — |
|
|
406
|
-
| `api-documentation.md` | `planning-artifacts/` | — | `{has_apis}` |
|
|
407
|
-
| `ux-design.md` | `planning-artifacts/` | — | `{has_frontend}` |
|
|
408
|
-
| `event-catalog.md` | `planning-artifacts/` | — | `{has_events}` |
|
|
409
|
-
| `dependency-map.md` | `planning-artifacts/` | Yes | — |
|
|
410
|
-
| `nfr-assessment.md` | `test-artifacts/` | Yes | — |
|
|
411
|
-
| `performance-test-plan-{date}.md` | `test-artifacts/` | Yes | — |
|
|
412
|
-
| `prd.md` | `planning-artifacts/` | Yes | — |
|
|
413
|
-
| `architecture.md` | `planning-artifacts/` | Yes | — |
|
|
414
|
-
| `epics-and-stories.md` | `planning-artifacts/` | Yes | — |
|
|
415
|
-
| `brownfield-onboarding.md` | `planning-artifacts/` | Yes | — |
|
|
416
|
-
|
|
417
|
-
---
|
|
418
|
-
|
|
419
|
-
## Review & Utility Tasks
|
|
420
|
-
|
|
421
|
-
Standalone tasks that can be run anytime without a full workflow. These are single-step operations for reviews, audits, and document utilities.
|
|
422
|
-
|
|
423
|
-
### Code & Security Reviews
|
|
424
|
-
|
|
425
|
-
| Command | Task | Description |
|
|
426
|
-
|---------|------|-------------|
|
|
427
|
-
| `/gaia-adversarial` | Adversarial Review | Cynical critical review — finds weaknesses |
|
|
428
|
-
| `/gaia-edge-cases` | Edge Case Hunter | Identify edge cases and boundary conditions |
|
|
429
|
-
| `/gaia-review-security` | Security Review | OWASP-focused security review |
|
|
430
|
-
| `/gaia-review-api` | API Design Review | Review REST API against standards |
|
|
431
|
-
| `/gaia-review-deps` | Dependency Audit | Scan dependencies for vulnerabilities |
|
|
432
|
-
| `/gaia-review-a11y` | Accessibility Review | WCAG 2.1 compliance review |
|
|
433
|
-
| `/gaia-review-perf` | Performance Review | Code-level performance review |
|
|
434
|
-
|
|
435
|
-
### Adversarial Review (`/gaia-adversarial`)
|
|
436
|
-
|
|
437
|
-
The adversarial review is a cynical, critical examination designed to find flaws, gaps, and weaknesses in any document or design. It deliberately assumes nothing works as claimed and attacks from **10 different perspectives**:
|
|
438
|
-
|
|
439
|
-
| Perspective | What it challenges |
|
|
440
|
-
|---|---|
|
|
441
|
-
| **Feasibility** | Can this actually be built as described? |
|
|
442
|
-
| **Completeness** | What's missing that should be there? |
|
|
443
|
-
| **Contradictions** | Do any sections contradict each other? |
|
|
444
|
-
| **Assumptions** | What unstated assumptions could be wrong? |
|
|
445
|
-
| **Scale** | Will this work at 10x/100x expected load? |
|
|
446
|
-
| **Failure modes** | What happens when things go wrong? |
|
|
447
|
-
| **Dependencies** | What external factors could break this? |
|
|
448
|
-
| **Security** | What attack surfaces are exposed? |
|
|
449
|
-
| **User impact** | Where will users get confused or frustrated? |
|
|
450
|
-
| **Business risk** | What could make this commercially unviable? |
|
|
451
|
-
|
|
452
|
-
**Output:** A ranked findings report with severity (critical/high/medium/low), confidence (certain/likely/possible), a threat summary of the top 3 issues, and an overall risk assessment. The review only identifies problems — it does not suggest fixes.
|
|
453
|
-
|
|
454
|
-
**When to use it:** The adversarial review is integrated as an optional prompt at 4 key lifecycle points:
|
|
455
|
-
|
|
456
|
-
| Trigger Point | When Prompted | Recommended For |
|
|
457
|
-
|---|---|---|
|
|
458
|
-
| After `/gaia-create-prd` | End of PRD creation (step 11) | Complex or high-stakes products |
|
|
459
|
-
| After `/gaia-create-arch` | End of architecture design (step 9) | Distributed systems, high-scale projects |
|
|
460
|
-
| After `/gaia-create-epics` | End of epic/story creation (step 8) | Before sprint planning |
|
|
461
|
-
| After `/gaia-readiness-check` | End of readiness check (step 9) | Strongly recommended — last chance before build |
|
|
462
|
-
|
|
463
|
-
At each point you can accept or skip. It can also be run independently anytime with `/gaia-adversarial` on any artifact.
|
|
464
|
-
|
|
465
|
-
### Lifecycle-Integrated Reviews
|
|
466
|
-
|
|
467
|
-
In addition to the adversarial review, several other tasks are integrated into the lifecycle at natural trigger points:
|
|
468
|
-
|
|
469
|
-
**Review Gate members** (required — story cannot move to `done` without all 6 passing):
|
|
470
|
-
|
|
471
|
-
| Review Command | Gate Row | Verdict | What It Checks |
|
|
472
|
-
|---|---|---|---|
|
|
473
|
-
| `/gaia-code-review` | Code Review | APPROVE / REQUEST_CHANGES | Correctness, security, performance, readability |
|
|
474
|
-
| `/gaia-qa-tests` | QA Tests | PASSED / FAILED | E2E and API test generation + execution |
|
|
475
|
-
| `/gaia-security-review` | Security Review | PASSED / FAILED | OWASP Top 10, secrets, auth patterns |
|
|
476
|
-
| `/gaia-test-automate` | Test Automation | PASSED / FAILED | Coverage gaps, uncovered code paths |
|
|
477
|
-
| `/gaia-test-review` | Test Review | PASSED / FAILED | Test quality, flakiness, isolation, determinism |
|
|
478
|
-
| `/gaia-review-perf` | Performance Review | PASSED / FAILED | N+1 queries, memory, bundle size, caching, complexity. Auto-passes if no performance-relevant code changes |
|
|
479
|
-
|
|
480
|
-
**Optional prompts** (offered at natural lifecycle points — user can accept or skip):
|
|
481
|
-
|
|
482
|
-
| Review Command | Trigger Point | When Prompted | Recommended For |
|
|
483
|
-
|---|---|---|---|
|
|
484
|
-
| `/gaia-review-api` | After `/gaia-create-arch` | End of architecture design (step 9) | Projects with REST APIs |
|
|
485
|
-
| `/gaia-review-a11y` | After `/gaia-create-ux` | End of UX design (step 8) | User-facing applications |
|
|
486
|
-
| `/gaia-edge-cases` | After `/gaia-create-epics` | End of epic/story creation (step 8) | Before sprint planning |
|
|
487
|
-
| `/gaia-review-deps` | During `/gaia-brownfield` | After dependency map (step 5) | Brownfield projects |
|
|
488
|
-
| `/gaia-review-perf` | Review Gate member | Required (auto-passes if no perf-relevant changes) | See Review Gate members table above |
|
|
489
|
-
| `/gaia-a11y-testing` | During `/gaia-deploy-checklist` | After loading context (step 2) | Frontend/user-facing applications |
|
|
490
|
-
| `/gaia-mobile-testing` | During `/gaia-sprint-plan` | After story selection (step 4) | Mobile/responsive applications |
|
|
491
|
-
|
|
492
|
-
All reviews can also be run independently anytime on any artifact or codebase.
|
|
493
|
-
|
|
494
|
-
### Editorial & Documentation
|
|
495
|
-
|
|
496
|
-
| Command | Task | Description |
|
|
497
|
-
|---------|------|-------------|
|
|
498
|
-
| `/gaia-editorial-prose` | Editorial Prose | Clinical copy-editing review |
|
|
499
|
-
| `/gaia-editorial-structure` | Editorial Structure | Structural editing review |
|
|
500
|
-
| `/gaia-summarize` | Summarize Document | Generate executive summary |
|
|
501
|
-
| `/gaia-index-docs` | Index Docs | Generate document index for a folder |
|
|
502
|
-
| `/gaia-shard-doc` | Shard Document | Split large docs into sections |
|
|
503
|
-
| `/gaia-merge-docs` | Merge Documents | Merge multiple markdown files |
|
|
504
|
-
| `/gaia-changelog` | Generate Changelog | Changelog from git history |
|
|
505
|
-
|
|
506
|
-
### Framework
|
|
507
|
-
|
|
508
|
-
| Command | Task | Description |
|
|
509
|
-
|---------|------|-------------|
|
|
510
|
-
| `/gaia-build-configs` | Build Configs | Regenerate pre-resolved config files |
|
|
511
|
-
| `/gaia-validate-framework` | Validate Framework | Self-validation and consistency check |
|
|
512
|
-
| `/gaia-resume` | Resume | Resume from last checkpoint after context loss |
|
|
513
|
-
|
|
514
|
-
---
|
|
515
|
-
|
|
516
|
-
## Shared Skills
|
|
517
|
-
|
|
518
|
-
Skills are loaded just-in-time by developer agents. Each skill is divided into sections so only the relevant portion is loaded (keeping context usage low).
|
|
519
|
-
|
|
520
|
-
| Skill | Sections | Used by |
|
|
521
|
-
|-------|----------|---------|
|
|
522
|
-
| **Git Workflow** | branching, commits, pull-requests, conflict-resolution | All devs, Scrum Master, DevOps |
|
|
523
|
-
| **API Design** | rest-conventions, graphql, openapi, versioning, error-standards | All devs, Architect, Data Engineer |
|
|
524
|
-
| **Database Design** | schema-design, migrations, indexing, orm-patterns | Java, Python, Architect, Data Engineer |
|
|
525
|
-
| **Docker Workflow** | multi-stage-builds, compose, security-scanning | TS, Angular, Java, Python, Mobile, DevOps |
|
|
526
|
-
| **Testing Patterns** | tdd-cycle, unit-testing, integration-testing, test-doubles | All devs, QA, Test Architect |
|
|
527
|
-
| **Code Review Standards** | review-checklist, solid-principles, complexity-metrics | All devs |
|
|
528
|
-
| **Documentation Standards** | readme-template, adr-format, inline-comments, api-docs | All devs, Tech Writer, Analyst, PM |
|
|
529
|
-
| **Security Basics** | owasp-top-10, input-validation, secrets-management, cors-csrf | All devs, Architect, Security, DevOps |
|
|
530
|
-
|
|
531
|
-
---
|
|
532
|
-
|
|
533
|
-
## Knowledge Fragments
|
|
534
|
-
|
|
535
|
-
Stack-specific and domain-specific knowledge loaded on demand.
|
|
536
|
-
|
|
537
|
-
### Developer Knowledge (by stack)
|
|
538
|
-
|
|
539
|
-
| Stack | Fragments |
|
|
540
|
-
|-------|-----------|
|
|
541
|
-
| TypeScript | React patterns, Next.js patterns, Express patterns, TS conventions |
|
|
542
|
-
| Angular | Angular conventions, Angular patterns, NgRx state, RxJS patterns |
|
|
543
|
-
| Flutter | Dart conventions, Widget patterns, State management, Platform channels |
|
|
544
|
-
| Java | Spring Boot patterns, JPA patterns, Microservices, Maven/Gradle |
|
|
545
|
-
| Python | Python conventions, Django patterns, FastAPI patterns, Data pipelines |
|
|
546
|
-
| Mobile | React Native patterns, Swift patterns, Kotlin patterns, Mobile testing |
|
|
547
|
-
|
|
548
|
-
### Testing Knowledge (by tier)
|
|
549
|
-
|
|
550
|
-
| Tier | Fragments |
|
|
551
|
-
|------|-----------|
|
|
552
|
-
| **Core** | Test pyramid, Test isolation, Fixture architecture, Deterministic testing |
|
|
553
|
-
| **Extended** | API testing patterns, Data factories, Risk governance, Selector resilience |
|
|
554
|
-
| **Specialized** | Contract testing, Visual testing, Test healing |
|
|
555
|
-
| **Performance** | k6 patterns, Lighthouse CI |
|
|
556
|
-
| **Accessibility** | WCAG checks, Axe-core patterns |
|
|
557
|
-
| **Mobile** | Appium patterns, React Native testing, Responsive testing |
|
|
558
|
-
| **Unit Testing** | Jest/Vitest patterns, JUnit5 patterns, Pytest patterns |
|
|
310
|
+
| Command | Workflow | Model | Description |
|
|
311
|
+
|---------|----------|-------|-------------|
|
|
312
|
+
| `/gaia-brownfield` | Brownfield Onboarding | Opus | 6-step orchestration with subagents for existing projects |
|
|
313
|
+
| `/gaia-document-project` | Document Project | Sonnet | Document a project for AI context |
|
|
314
|
+
| `/gaia-project-context` | Generate Project Context | Sonnet | Generate context for AI consumption |
|
|
315
|
+
| `/gaia-performance-review` | Performance Review | Opus | Analyze performance bottlenecks |
|
|
316
|
+
| `/gaia-brainstorming` | Brainstorming | Sonnet | Facilitated brainstorming session |
|
|
317
|
+
| `/gaia-party` | Party Mode | Sonnet | Multi-agent group discussion |
|
|
318
|
+
| `/gaia-advanced-elicitation` | Advanced Elicitation | Opus | Deep requirements elicitation |
|
|
319
|
+
| `/gaia-memory-hygiene` | Memory Hygiene | Sonnet | Detect stale decisions in agent memory |
|
|
320
|
+
|
|
321
|
+
### Review & Utility Tasks
|
|
322
|
+
|
|
323
|
+
| Command | Task | Model | Description |
|
|
324
|
+
|---------|------|-------|-------------|
|
|
325
|
+
| `/gaia-adversarial` | Adversarial Review | Opus | Cynical critical review from 10 perspectives — finds weaknesses |
|
|
326
|
+
| `/gaia-edge-cases` | Edge Case Hunter | Opus | Identify edge cases and boundary conditions |
|
|
327
|
+
| `/gaia-review-security` | Security Review | Opus | OWASP-focused security review |
|
|
328
|
+
| `/gaia-review-api` | API Design Review | Opus | Review REST API against standards |
|
|
329
|
+
| `/gaia-review-deps` | Dependency Audit | Sonnet | Scan dependencies for vulnerabilities |
|
|
330
|
+
| `/gaia-review-a11y` | Accessibility Review | Sonnet | WCAG 2.1 compliance review |
|
|
331
|
+
| `/gaia-review-perf` | Performance Review | Opus | Code-level performance review |
|
|
332
|
+
| `/gaia-editorial-prose` | Editorial Prose | Sonnet | Clinical copy-editing review |
|
|
333
|
+
| `/gaia-editorial-structure` | Editorial Structure | Sonnet | Structural editing review |
|
|
334
|
+
| `/gaia-summarize` | Summarize Document | Sonnet | Generate executive summary |
|
|
335
|
+
| `/gaia-index-docs` | Index Docs | Sonnet | Generate document index for a folder |
|
|
336
|
+
| `/gaia-shard-doc` | Shard Document | Sonnet | Split large docs into sections |
|
|
337
|
+
| `/gaia-merge-docs` | Merge Documents | Sonnet | Merge multiple markdown files |
|
|
338
|
+
| `/gaia-changelog` | Generate Changelog | Sonnet | Changelog from git history |
|
|
339
|
+
|
|
340
|
+
### Framework Utilities
|
|
341
|
+
|
|
342
|
+
| Command | Task | Model | Description |
|
|
343
|
+
|---------|------|-------|-------------|
|
|
344
|
+
| `/gaia-build-configs` | Build Configs | Sonnet | Regenerate pre-resolved config files |
|
|
345
|
+
| `/gaia-validate-framework` | Validate Framework | Sonnet | Self-validation and consistency check |
|
|
346
|
+
| `/gaia-resume` | Resume | Sonnet | Resume from last checkpoint after context loss |
|
|
347
|
+
| `/gaia-run-all-reviews` | Run All Reviews | Sonnet | Execute all 6 review gate checks sequentially |
|
|
559
348
|
|
|
560
349
|
---
|
|
561
350
|
|
|
562
|
-
##
|
|
351
|
+
## Typical Workflow
|
|
563
352
|
|
|
564
|
-
|
|
353
|
+
### Greenfield — new project from idea to deployment
|
|
565
354
|
|
|
566
355
|
```
|
|
567
|
-
|
|
568
|
-
|
|
569
|
-
|
|
570
|
-
├── test-artifacts/ # Test plans, traceability, accessibility
|
|
571
|
-
└── creative-artifacts/ # Design thinking, innovation, pitch decks
|
|
572
|
-
```
|
|
573
|
-
|
|
574
|
-
---
|
|
356
|
+
# Phase 1: Analysis
|
|
357
|
+
/gaia-brainstorm → brainstorm the idea
|
|
358
|
+
/gaia-product-brief → create a product brief
|
|
575
359
|
|
|
576
|
-
|
|
577
|
-
|
|
578
|
-
|
|
579
|
-
|
|
580
|
-
| Template | Used By | Description |
|
|
581
|
-
|----------|---------|-------------|
|
|
582
|
-
| `prd-template.md` | create-prd | Product requirements document |
|
|
583
|
-
| `architecture-template.md` | create-architecture | Greenfield architecture document |
|
|
584
|
-
| `brownfield-architecture-template.md` | brownfield-onboarding | As-is/target architecture with Mermaid C4 diagrams |
|
|
585
|
-
| `story-template.md` | create-epics-stories | User story with acceptance criteria |
|
|
586
|
-
| `sprint-plan-template.md` | sprint-planning | Sprint plan with capacity and goals |
|
|
587
|
-
| `product-brief-template.md` | create-product-brief | Product brief for stakeholder alignment |
|
|
588
|
-
| `review-template.md` | code-review | Code review report |
|
|
589
|
-
| `test-plan-template.md` | test-design | Test plan with strategy and coverage |
|
|
590
|
-
| `deployment-template.md` | release-plan | Deployment plan and checklist |
|
|
591
|
-
| `api-documentation-template.md` | brownfield-onboarding | OpenAPI/Swagger API documentation |
|
|
592
|
-
| `event-catalog-template.md` | brownfield-onboarding | Event producer/consumer catalog |
|
|
593
|
-
| `dependency-map-template.md` | brownfield-onboarding | Service, infrastructure, and library dependencies |
|
|
594
|
-
| `nfr-assessment-template.md` | brownfield-onboarding | Non-functional requirements baselines |
|
|
595
|
-
| `ux-design-assessment-template.md` | brownfield-onboarding | UI patterns and accessibility assessment |
|
|
596
|
-
| `epic-status-template.md` | epic-status | Epic completion dashboard with progress bars |
|
|
597
|
-
| `brownfield-onboarding-template.md` | brownfield-onboarding | Developer knowledge base index |
|
|
360
|
+
# Phase 2: Planning
|
|
361
|
+
/gaia-create-prd → write the PRD
|
|
362
|
+
/gaia-create-ux → design the UX
|
|
598
363
|
|
|
599
|
-
|
|
364
|
+
# Phase 3: Solutioning
|
|
365
|
+
/gaia-create-arch → design the architecture
|
|
366
|
+
/gaia-test-design → create test plan
|
|
367
|
+
/gaia-create-epics → break into epics and stories
|
|
368
|
+
/gaia-trace → generate traceability matrix
|
|
369
|
+
/gaia-ci-setup → scaffold CI pipeline
|
|
370
|
+
/gaia-readiness-check → verify everything is ready
|
|
600
371
|
|
|
601
|
-
|
|
372
|
+
# Phase 4: Implementation (repeat per sprint)
|
|
373
|
+
/gaia-sprint-plan → plan the sprint
|
|
374
|
+
/gaia-dev-story → implement stories
|
|
375
|
+
/gaia-run-all-reviews → run all 6 review gates
|
|
376
|
+
/gaia-retro → sprint retrospective
|
|
602
377
|
|
|
603
|
-
|
|
378
|
+
# Phase 5: Deployment
|
|
379
|
+
/gaia-deploy-checklist → pre-deploy verification
|
|
380
|
+
/gaia-post-deploy → post-deploy health check
|
|
381
|
+
```
|
|
604
382
|
|
|
605
|
-
|
|
383
|
+
For **brownfield projects** (existing codebases), start with `/gaia-brownfield` — a 6-step orchestration that scans your codebase, generates documentation (APIs, UX, events, dependencies, NFR baselines), creates a gap-focused PRD, and maps the architecture. Then continue from Phase 3 above.
|
|
606
384
|
|
|
607
385
|
---
|
|
608
386
|
|
|
609
|
-
##
|
|
610
|
-
|
|
611
|
-
Each agent has a persistent memory sidecar that survives across sessions:
|
|
387
|
+
## Architecture
|
|
612
388
|
|
|
613
389
|
```
|
|
614
|
-
_gaia/
|
|
615
|
-
├──
|
|
616
|
-
├──
|
|
617
|
-
|
|
618
|
-
├──
|
|
619
|
-
├──
|
|
620
|
-
|
|
621
|
-
├──
|
|
622
|
-
|
|
623
|
-
|
|
390
|
+
_gaia/
|
|
391
|
+
├── _config/ # Global config, manifests
|
|
392
|
+
│ ├── global.yaml # Project settings — single source of truth
|
|
393
|
+
│ └── manifest.yaml # Module versions
|
|
394
|
+
├── _memory/ # Persistent agent memory + checkpoints
|
|
395
|
+
│ ├── checkpoints/ # Workflow progress snapshots (sha256-verified)
|
|
396
|
+
│ └── *-sidecar/ # Per-agent persistent memory (9 sidecars)
|
|
397
|
+
├── core/ # Execution engine, protocols, shared tasks
|
|
398
|
+
│ └── engine/ # workflow.xml (7-step flow), task-runner.xml
|
|
399
|
+
├── lifecycle/ # 5 phases: analysis → deployment
|
|
400
|
+
│ ├── agents/ # 11 lifecycle agents
|
|
401
|
+
│ ├── workflows/ # 36 workflows across 5 phases
|
|
402
|
+
│ └── templates/ # 18 document templates
|
|
403
|
+
├── dev/ # Developer tooling
|
|
404
|
+
│ ├── agents/ # 6 stack-specific developers
|
|
405
|
+
│ ├── skills/ # 8 shared skills (sectioned loading)
|
|
406
|
+
│ └── knowledge/ # Stack-specific patterns
|
|
407
|
+
├── creative/ # 6 creative agents + 7 workflows
|
|
408
|
+
└── testing/ # Test Architect + 12 testing workflows
|
|
624
409
|
```
|
|
625
410
|
|
|
626
|
-
|
|
411
|
+
### At a glance
|
|
412
|
+
|
|
413
|
+
| Component | Count |
|
|
414
|
+
|-----------|-------|
|
|
415
|
+
| Agents | 25 with distinct personas |
|
|
416
|
+
| Workflows | 64 across 5 lifecycle phases |
|
|
417
|
+
| Standalone tasks | 15 (reviews, audits, utilities) |
|
|
418
|
+
| Slash commands | 104 |
|
|
419
|
+
| Shared skills | 8 with 47 loadable sections |
|
|
420
|
+
| Knowledge fragments | 45 |
|
|
421
|
+
| Document templates | 18 |
|
|
422
|
+
| Quality gates | 17 (enforced, not advisory) |
|
|
627
423
|
|
|
628
424
|
---
|
|
629
425
|
|
|
630
426
|
## Configuration
|
|
631
427
|
|
|
632
|
-
|
|
633
|
-
|
|
634
|
-
The single source of truth for project settings at `_gaia/_config/global.yaml`:
|
|
428
|
+
The single source of truth is `_gaia/_config/global.yaml`:
|
|
635
429
|
|
|
636
430
|
```yaml
|
|
637
431
|
framework_name: "GAIA"
|
|
638
|
-
framework_version: "1.
|
|
639
|
-
|
|
432
|
+
framework_version: "1.27.1"
|
|
640
433
|
user_name: "your-name"
|
|
641
434
|
project_name: "your-project"
|
|
642
|
-
project_root: "{project-root}"
|
|
643
|
-
|
|
644
|
-
output_folder: "{project-root}/docs"
|
|
645
|
-
planning_artifacts: "{project-root}/docs/planning-artifacts"
|
|
646
|
-
implementation_artifacts: "{project-root}/docs/implementation-artifacts"
|
|
647
|
-
test_artifacts: "{project-root}/docs/test-artifacts"
|
|
648
|
-
creative_artifacts: "{project-root}/docs/creative-artifacts"
|
|
649
435
|
```
|
|
650
436
|
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
### Pre-resolved configs
|
|
654
|
-
|
|
655
|
-
Each module (core, lifecycle, creative, testing) has a `.resolved/` directory for pre-built config files. These eliminate runtime config resolution overhead. Generate them with `/gaia-build-configs`.
|
|
437
|
+
After changing `global.yaml`, run `/gaia-build-configs` to regenerate pre-resolved configs. Each module has a `.resolved/` directory that eliminates runtime config resolution overhead.
|
|
656
438
|
|
|
657
439
|
---
|
|
658
440
|
|
|
659
|
-
##
|
|
660
|
-
|
|
661
|
-
Pre-built team compositions for different project types:
|
|
441
|
+
## Checkpoint & Resume
|
|
662
442
|
|
|
663
|
-
|
|
664
|
-
|------|-------|--------|
|
|
665
|
-
| Full | Complete coverage | All lifecycle + dev agents |
|
|
666
|
-
| Planning | Requirements & design | Analyst, PM, UX Designer, Architect |
|
|
667
|
-
| Implementation | Build & ship | SM, dev agents, QA, DevOps |
|
|
668
|
-
| Quick Ship | Minimal ceremony | PM, dev agent, QA |
|
|
669
|
-
| Enterprise | Governance-heavy | Full team + Security, Performance |
|
|
670
|
-
| Security-Focused | Security-first | Architect, Security, DevOps, QA |
|
|
671
|
-
| Data-Intensive | Data pipelines | Architect, Data Engineer, Python Dev |
|
|
443
|
+
Long-running workflows save checkpoints to `_gaia/_memory/checkpoints/` with sha256 checksums of all files touched. If your session is interrupted, run `/gaia-resume` — it validates file integrity before resuming from the last completed step.
|
|
672
444
|
|
|
673
445
|
---
|
|
674
446
|
|
|
675
|
-
##
|
|
676
|
-
|
|
677
|
-
### Greenfield — New project from idea to deployment
|
|
678
|
-
|
|
679
|
-
```
|
|
680
|
-
# Phase 1: Analysis
|
|
681
|
-
/gaia-brainstorm → brainstorm the idea
|
|
682
|
-
/gaia-product-brief → create a product brief
|
|
683
|
-
/gaia-market-research → validate market fit
|
|
684
|
-
|
|
685
|
-
# Phase 2: Planning
|
|
686
|
-
/gaia-create-prd → write the PRD (optional: adversarial review)
|
|
687
|
-
/gaia-create-ux → design the UX (optional: accessibility review)
|
|
688
|
-
|
|
689
|
-
# Phase 3: Solutioning
|
|
690
|
-
/gaia-create-arch → design the architecture (optional: API review, adversarial review)
|
|
691
|
-
/gaia-test-design → create test plan (optional: scaffold test framework)
|
|
692
|
-
/gaia-create-epics → break into epics and stories (optional: edge cases, adversarial review)
|
|
693
|
-
/gaia-trace → generate traceability matrix
|
|
694
|
-
/gaia-ci-setup → scaffold CI pipeline
|
|
695
|
-
/gaia-readiness-check → verify everything is ready (optional: adversarial review)
|
|
447
|
+
## Agent Memory
|
|
696
448
|
|
|
697
|
-
|
|
698
|
-
/gaia-sprint-plan → plan the sprint (optional: mobile testing)
|
|
699
|
-
/gaia-create-story → create detailed stories
|
|
700
|
-
/gaia-validate-story → validate story completeness
|
|
701
|
-
/gaia-fix-story → fix issues from validation
|
|
702
|
-
/gaia-atdd → write acceptance tests (REQUIRED for high-risk stories)
|
|
703
|
-
/gaia-dev-story → implement stories
|
|
704
|
-
/gaia-code-review → review the code ─┐
|
|
705
|
-
/gaia-qa-tests → generate tests │
|
|
706
|
-
/gaia-security-review → security audit │ Review Gate
|
|
707
|
-
/gaia-test-automate → expand test coverage │ (all 6 must
|
|
708
|
-
/gaia-test-review → review test quality │ PASS before
|
|
709
|
-
/gaia-review-perf → performance review ─┘ story → done)
|
|
710
|
-
/gaia-triage-findings → triage dev findings into backlog
|
|
711
|
-
/gaia-retro → sprint retrospective
|
|
449
|
+
Each agent has a persistent memory sidecar (`_gaia/_memory/*-sidecar/`) that stores decisions, patterns, and context across sessions. Agents become more effective the more you use them. Run `/gaia-memory-hygiene` periodically to detect stale or contradicted decisions.
|
|
712
450
|
|
|
713
|
-
|
|
714
|
-
/gaia-release-plan → plan the release
|
|
715
|
-
/gaia-deploy-checklist → pre-deploy verification (optional: a11y testing)
|
|
716
|
-
/gaia-post-deploy → post-deploy health check
|
|
717
|
-
```
|
|
451
|
+
---
|
|
718
452
|
|
|
719
|
-
|
|
453
|
+
## Limitations
|
|
720
454
|
|
|
721
|
-
|
|
722
|
-
|
|
723
|
-
|
|
724
|
-
1. Scan codebase → project-documentation.md
|
|
725
|
-
2. API documentation (if APIs detected)
|
|
726
|
-
3. UX assessment (if frontend detected)
|
|
727
|
-
4. Event catalog (if messaging detected)
|
|
728
|
-
5. Dependency map
|
|
729
|
-
6. NFR assessment & baselines
|
|
730
|
-
7. Performance test plan
|
|
731
|
-
8. Gap-focused PRD (gaps only, not existing features)
|
|
732
|
-
9. Architecture with as-is/target diagrams
|
|
733
|
-
10. Epics/stories for gaps + developer knowledge base
|
|
734
|
-
|
|
735
|
-
# Phase 3: Readiness
|
|
736
|
-
/gaia-test-design → create test plan (optional: scaffold test framework)
|
|
737
|
-
/gaia-trace → generate traceability matrix
|
|
738
|
-
/gaia-ci-setup → scaffold CI pipeline
|
|
739
|
-
/gaia-readiness-check → verify everything is ready (optional: adversarial review)
|
|
455
|
+
- **Single-user only** — GAIA uses markdown files for state management (stories, sprint status, architecture docs). Multiple team members editing the same project will run into file conflicts.
|
|
456
|
+
- **Claude Code required** — GAIA is built specifically for Claude Code and cannot run on other AI coding assistants.
|
|
457
|
+
- **Context budget** — Complex workflows can consume significant context. The framework enforces a 40K token budget per activation with just-in-time loading to manage this, but very large projects may hit limits.
|
|
740
458
|
|
|
741
|
-
|
|
742
|
-
/gaia-sprint-plan → plan the sprint (optional: mobile testing)
|
|
743
|
-
/gaia-create-story → create detailed stories
|
|
744
|
-
/gaia-validate-story → validate story completeness
|
|
745
|
-
/gaia-fix-story → fix issues from validation
|
|
746
|
-
/gaia-atdd → write acceptance tests (REQUIRED for high-risk stories)
|
|
747
|
-
/gaia-dev-story → implement gap stories
|
|
748
|
-
/gaia-code-review → review the code ─┐
|
|
749
|
-
/gaia-qa-tests → generate tests │
|
|
750
|
-
/gaia-security-review → security audit │ Review Gate
|
|
751
|
-
/gaia-test-automate → expand test coverage │ (all 6 must
|
|
752
|
-
/gaia-test-review → review test quality │ PASS before
|
|
753
|
-
/gaia-review-perf → performance review ─┘ story → done)
|
|
754
|
-
/gaia-triage-findings → triage dev findings into backlog
|
|
755
|
-
/gaia-retro → sprint retrospective
|
|
459
|
+
---
|
|
756
460
|
|
|
757
|
-
|
|
758
|
-
/gaia-release-plan → plan the release
|
|
759
|
-
/gaia-deploy-checklist → pre-deploy verification (optional: a11y testing)
|
|
760
|
-
/gaia-post-deploy → post-deploy health check
|
|
761
|
-
```
|
|
461
|
+
## Contributing
|
|
762
462
|
|
|
763
|
-
|
|
463
|
+
Contributions are welcome. Please open an issue to discuss your idea before submitting a PR.
|
|
764
464
|
|
|
765
|
-
|
|
766
|
-
/gaia-quick-spec → rapid tech spec
|
|
767
|
-
/gaia-quick-dev → implement it
|
|
768
|
-
```
|
|
465
|
+
By contributing, you agree that your contributions will be licensed under the same AGPL-3.0 license and that you grant the project maintainers the right to relicense your contributions under a commercial license (CLA).
|
|
769
466
|
|
|
770
467
|
---
|
|
771
468
|
|
|
772
469
|
## License
|
|
773
470
|
|
|
774
|
-
|
|
471
|
+
[AGPL-3.0](LICENSE)
|
|
472
|
+
|
|
473
|
+
The open-source framework is licensed under the GNU Affero General Public License v3.0. A commercial license is available for teams and enterprises that want to use GAIA without AGPL obligations or connect to the GAIA SaaS platform.
|
package/gaia-install.sh
CHANGED
|
@@ -6,7 +6,7 @@ set -euo pipefail
|
|
|
6
6
|
# Installs, updates, validates, and reports on GAIA installations.
|
|
7
7
|
# ─────────────────────────────────────────────────────────────────────────────
|
|
8
8
|
|
|
9
|
-
readonly VERSION="1.
|
|
9
|
+
readonly VERSION="1.27.1"
|
|
10
10
|
readonly GITHUB_REPO="https://github.com/J-louage/Gaia-framework.git"
|
|
11
11
|
readonly MANIFEST_REL="_gaia/_config/manifest.yaml"
|
|
12
12
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "gaia-framework",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.27.1",
|
|
4
4
|
"description": "GAIA — Generative Agile Intelligence Architecture installer",
|
|
5
5
|
"bin": {
|
|
6
6
|
"gaia-framework": "./bin/gaia-framework.js"
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
"type": "git",
|
|
19
19
|
"url": "https://github.com/J-louage/Gaia-framework.git"
|
|
20
20
|
},
|
|
21
|
-
"license": "
|
|
21
|
+
"license": "AGPL-3.0",
|
|
22
22
|
"engines": {
|
|
23
23
|
"node": ">=18"
|
|
24
24
|
},
|