gaia-framework 1.35.2 → 1.35.4
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 +34 -22
- package/gaia-install.sh +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# GAIA — Generative Agile Intelligence Architecture
|
|
2
2
|
|
|
3
|
-
[]()
|
|
4
4
|
[]()
|
|
5
|
-
[]()
|
|
6
|
+
[]()
|
|
7
7
|
|
|
8
|
-
AI agent framework for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) that orchestrates software product development through **
|
|
8
|
+
AI agent framework for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) that orchestrates software product development through **25 specialized agents**, **73 workflows**, and **11 shared skills** — from initial research all the way to deployment.
|
|
9
9
|
|
|
10
10
|

|
|
11
11
|
|
|
@@ -20,7 +20,7 @@ Without guardrails, every AI session starts from zero. There's no traceability f
|
|
|
20
20
|
**What this gives you:**
|
|
21
21
|
|
|
22
22
|
- **A structured lifecycle, not ad-hoc prompting** — 5 phases from analysis to deployment, with quality gates that enforce standards at every transition
|
|
23
|
-
- **
|
|
23
|
+
- **25 specialized agents** — each with a persona, domain expertise, and persistent memory that improves over time
|
|
24
24
|
- **Enforced quality gates** — 17 gates that HALT workflows when standards aren't met (not advisory — hard stops)
|
|
25
25
|
- **6-gate review process** — every story passes code review, QA, security, test automation, test review, and performance review before completion
|
|
26
26
|
- **Full traceability** — every line of code traces back through stories, epics, architecture decisions, and requirements to the original product brief
|
|
@@ -118,7 +118,7 @@ bash Gaia-framework/gaia-install.sh init ~/my-project
|
|
|
118
118
|
3. Creates memory sidecar directories
|
|
119
119
|
4. Prompts for project name and user name → writes to `global.yaml`
|
|
120
120
|
5. Copies `CLAUDE.md` to your project root
|
|
121
|
-
6. Installs
|
|
121
|
+
6. Installs 117 slash commands to `.claude/commands/`
|
|
122
122
|
7. Appends GAIA entries to `.gitignore`
|
|
123
123
|
|
|
124
124
|
### Updating
|
|
@@ -162,7 +162,7 @@ Every phase has **quality gates** — enforced checks that halt the workflow if
|
|
|
162
162
|
|
|
163
163
|
### Model assignment
|
|
164
164
|
|
|
165
|
-
Each command declares which Claude model to use. **Opus** handles deep reasoning, architectural decisions, and complex analysis (
|
|
165
|
+
Each command declares which Claude model to use. **Opus** handles deep reasoning, architectural decisions, and complex analysis (37 commands). **Sonnet** handles structured generation, template-following, and status reporting (80 commands). Claude Code auto-selects the model per workflow.
|
|
166
166
|
|
|
167
167
|
### Execution modes
|
|
168
168
|
|
|
@@ -190,6 +190,7 @@ Every agent has a name, persona, and specialization. Activate any agent directly
|
|
|
190
190
|
| DevOps Engineer | Soren | Infrastructure, deployment, rollback planning | `/gaia-agent-devops` |
|
|
191
191
|
| Data Engineer | Milo | Schema design, ETL guidance, data quality | `/gaia-agent-data-engineer` |
|
|
192
192
|
| Performance Specialist | Juno | Load testing, profiling, Core Web Vitals | `/gaia-agent-performance` |
|
|
193
|
+
| Validator | Val | Artifact validation, ground truth management | `/gaia-agent-validator` |
|
|
193
194
|
|
|
194
195
|
### Developer Agents
|
|
195
196
|
|
|
@@ -252,6 +253,7 @@ Workflows are structured multi-step processes. Each has a `workflow.yaml` config
|
|
|
252
253
|
|---------|----------|-------|-------|--------|
|
|
253
254
|
| `/gaia-create-arch` | Create Architecture | Theo | Opus | `docs/planning-artifacts/` |
|
|
254
255
|
| `/gaia-create-epics` | Create Epics & Stories | Derek | Opus | `docs/planning-artifacts/` |
|
|
256
|
+
| `/gaia-edit-arch` | Edit Architecture | Theo | Opus | `docs/planning-artifacts/` |
|
|
255
257
|
| `/gaia-readiness-check` | Implementation Readiness | Theo | Opus | `docs/planning-artifacts/` |
|
|
256
258
|
| `/gaia-threat-model` | Security Threat Model | Zara | Opus | `docs/planning-artifacts/` |
|
|
257
259
|
| `/gaia-infra-design` | Infrastructure Design | Soren | Opus | `docs/planning-artifacts/` |
|
|
@@ -276,6 +278,9 @@ Workflows are structured multi-step processes. Each has a `workflow.yaml` config
|
|
|
276
278
|
| `/gaia-add-stories` | Add Stories | Derek | Sonnet | `docs/planning-artifacts/` |
|
|
277
279
|
| `/gaia-correct-course` | Correct Course | Nate | Sonnet | `docs/implementation-artifacts/` |
|
|
278
280
|
| `/gaia-retro` | Retrospective | Nate | Sonnet | `docs/implementation-artifacts/` |
|
|
281
|
+
| `/gaia-add-feature` | Add Feature | Derek | Opus | `docs/planning-artifacts/` |
|
|
282
|
+
| `/gaia-check-dod` | Check Definition of Done | Nate | Sonnet | `docs/implementation-artifacts/` |
|
|
283
|
+
| `/gaia-check-review-gate` | Check Review Gate | Nate | Sonnet | `docs/implementation-artifacts/` |
|
|
279
284
|
|
|
280
285
|
### Phase 5: Deployment
|
|
281
286
|
|
|
@@ -323,6 +328,7 @@ Testing workflows are **integrated into the main lifecycle** — they are not op
|
|
|
323
328
|
| `/gaia-perf-testing` | Performance Testing | Sable | Sonnet | `docs/test-artifacts/` |
|
|
324
329
|
| `/gaia-mobile-testing` | Mobile Testing | Sable | Sonnet | `docs/test-artifacts/` |
|
|
325
330
|
| `/gaia-teach-testing` | Teach Me Testing | Sable | Sonnet | `docs/test-artifacts/` |
|
|
331
|
+
| `/gaia-edit-test-plan` | Edit Test Plan | Sable | Sonnet | `docs/test-artifacts/` |
|
|
326
332
|
|
|
327
333
|
### Anytime Workflows
|
|
328
334
|
|
|
@@ -336,6 +342,10 @@ Testing workflows are **integrated into the main lifecycle** — they are not op
|
|
|
336
342
|
| `/gaia-party` | Party Mode | Sonnet | Multi-agent group discussion |
|
|
337
343
|
| `/gaia-advanced-elicitation` | Advanced Elicitation | Opus | Deep requirements elicitation |
|
|
338
344
|
| `/gaia-memory-hygiene` | Memory Hygiene | Sonnet | Detect stale decisions in agent memory |
|
|
345
|
+
| `/gaia-val-validate` | Validate Artifact | Opus | Validate artifact against codebase and ground truth |
|
|
346
|
+
| `/gaia-val-validate-plan` | Validate Plan | Opus | Validate implementation plan before execution |
|
|
347
|
+
| `/gaia-val-save` | Save Val Session | Sonnet | Persist Val session decisions and findings |
|
|
348
|
+
| `/gaia-refresh-ground-truth` | Refresh Ground Truth | Sonnet | Rescan filesystem and update ground truth |
|
|
339
349
|
|
|
340
350
|
### Review & Utility Tasks
|
|
341
351
|
|
|
@@ -410,34 +420,35 @@ _gaia/
|
|
|
410
420
|
├── _config/ # Global config, manifests
|
|
411
421
|
│ ├── global.yaml # Project settings — single source of truth
|
|
412
422
|
│ └── manifest.yaml # Module versions
|
|
413
|
-
├── _memory/ # Persistent agent memory + checkpoints
|
|
414
|
-
│ ├── checkpoints/ # Workflow progress snapshots (sha256-verified)
|
|
415
|
-
│ └── *-sidecar/ # Per-agent persistent memory (9 sidecars)
|
|
416
423
|
├── core/ # Execution engine, protocols, shared tasks
|
|
417
424
|
│ └── engine/ # workflow.xml (7-step flow), task-runner.xml
|
|
418
425
|
├── lifecycle/ # 5 phases: analysis → deployment
|
|
419
|
-
│ ├── agents/ #
|
|
420
|
-
│ ├── workflows/ #
|
|
426
|
+
│ ├── agents/ # 12 lifecycle agents
|
|
427
|
+
│ ├── workflows/ # 51 workflows across 5 phases
|
|
421
428
|
│ └── templates/ # 18 document templates
|
|
422
429
|
├── dev/ # Developer tooling
|
|
423
430
|
│ ├── agents/ # 6 stack-specific developers
|
|
424
431
|
│ ├── skills/ # 8 shared skills (sectioned loading)
|
|
425
432
|
│ └── knowledge/ # Stack-specific patterns
|
|
426
433
|
├── creative/ # 6 creative agents + 7 workflows
|
|
427
|
-
└── testing/ # Test Architect +
|
|
434
|
+
└── testing/ # Test Architect + 13 testing workflows
|
|
435
|
+
|
|
436
|
+
_memory/ # Persistent agent memory (project root)
|
|
437
|
+
├── checkpoints/ # Workflow progress snapshots (sha256-verified)
|
|
438
|
+
└── *-sidecar/ # Per-agent persistent memory (26 sidecars)
|
|
428
439
|
```
|
|
429
440
|
|
|
430
441
|
### At a glance
|
|
431
442
|
|
|
432
443
|
| Component | Count |
|
|
433
444
|
|-----------|-------|
|
|
434
|
-
| Agents |
|
|
435
|
-
| Workflows |
|
|
445
|
+
| Agents | 25 with distinct personas |
|
|
446
|
+
| Workflows | 73 across 5 lifecycle phases |
|
|
436
447
|
| Standalone tasks | 15 (reviews, audits, utilities) |
|
|
437
|
-
| Slash commands |
|
|
438
|
-
| Shared skills |
|
|
448
|
+
| Slash commands | 117 |
|
|
449
|
+
| Shared skills | 11 with 49 loadable sections |
|
|
439
450
|
| Knowledge fragments | 45 |
|
|
440
|
-
| Document templates |
|
|
451
|
+
| Document templates | 19 |
|
|
441
452
|
| Quality gates | 17 (enforced, not advisory) |
|
|
442
453
|
|
|
443
454
|
---
|
|
@@ -448,7 +459,7 @@ The single source of truth is `_gaia/_config/global.yaml`:
|
|
|
448
459
|
|
|
449
460
|
```yaml
|
|
450
461
|
framework_name: "GAIA"
|
|
451
|
-
framework_version: "1.35.
|
|
462
|
+
framework_version: "1.35.4"
|
|
452
463
|
user_name: "your-name"
|
|
453
464
|
project_name: "your-project"
|
|
454
465
|
```
|
|
@@ -459,13 +470,13 @@ After changing `global.yaml`, run `/gaia-build-configs` to regenerate pre-resolv
|
|
|
459
470
|
|
|
460
471
|
## Checkpoint & Resume
|
|
461
472
|
|
|
462
|
-
Long-running workflows save checkpoints to `
|
|
473
|
+
Long-running workflows save checkpoints to `_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.
|
|
463
474
|
|
|
464
475
|
---
|
|
465
476
|
|
|
466
477
|
## Agent Memory
|
|
467
478
|
|
|
468
|
-
Each agent has a persistent memory sidecar (`
|
|
479
|
+
Each agent has a persistent memory sidecar (`_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.
|
|
469
480
|
|
|
470
481
|
---
|
|
471
482
|
|
|
@@ -489,4 +500,5 @@ By contributing, you agree that your contributions will be licensed under the sa
|
|
|
489
500
|
|
|
490
501
|
[AGPL-3.0](LICENSE)
|
|
491
502
|
|
|
492
|
-
The open-source framework is licensed under the GNU Affero General Public License v3.0.
|
|
503
|
+
The open-source framework is licensed under the GNU Affero General Public License v3.0.
|
|
504
|
+
|
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.35.
|
|
9
|
+
readonly VERSION="1.35.4"
|
|
10
10
|
readonly GITHUB_REPO="https://github.com/jlouage/Gaia-framework.git"
|
|
11
11
|
readonly MANIFEST_REL="_gaia/_config/manifest.yaml"
|
|
12
12
|
|