gaia-framework 1.65.0 → 1.65.1

package/.claude/commands/gaia-add-feature.md

@@ -1,6 +1,6 @@
 ---
 name: 'add-feature'
-description: 'Add a new feature to an existing product — guided cascade through PRD, architecture, test plan, stories, and traceability. Use when "add a feature".'
+description: 'Triage and route a fix, enhancement, or feature through only the affected artifacts. Classifies as patch/enhancement/feature and cascades accordingly.'
 model: opus
 ---
 
@@ -9,7 +9,7 @@ IT IS CRITICAL THAT YOU FOLLOW THESE STEPS:
 <steps CRITICAL="TRUE">
 1. LOAD the FULL {project-root}/_gaia/core/engine/workflow.xml
 2. READ its entire contents — this is the CORE OS
-3. Pass {project-root}/_gaia/lifecycle/workflows/cross-phase/add-feature/workflow.yaml as 'workflow-config'
+3. Pass {project-root}/_gaia/lifecycle/workflows/4-implementation/add-feature/workflow.yaml as 'workflow-config'
 4. Follow workflow.xml instructions EXACTLY
 5. Save outputs after EACH section
 </steps>

package/.claude/commands/gaia-change-request.md

@@ -1,11 +1,23 @@
 ---
 name: 'change-request'
-description: 'Document and analyze a change request with impact analysis, approval gate, and cascade artifact updates.'
+description: 'DEPRECATED — Redirects to /gaia-add-feature. Use /gaia-add-feature directly.'
 model: opus
 ---
 
-Document and analyze a change request with impact analysis, approval gate, and cascade artifact updates.
+> **DEPRECATED:** `/gaia-change-request` has been replaced by `/gaia-add-feature`.
+> This command now redirects to the add-feature workflow automatically.
+>
+> **Note:** SIGNIFICANT or larger changes are fully supported by the add-feature workflow,
+> which classifies changes as patch/enhancement/feature and cascades accordingly.
 
-Load $ARGUMENTS as additional context.
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS:
 
-Load {project-root}/_gaia/core/engine/workflow.xml and process {project-root}/_gaia/lifecycle/workflows/4-implementation/change-request/workflow.yaml as workflow-config. Follow the workflow engine instructions EXACTLY.
+<steps CRITICAL="TRUE">
+1. LOAD the FULL {project-root}/_gaia/core/engine/workflow.xml
+2. READ its entire contents — this is the CORE OS
+3. Pass {project-root}/_gaia/lifecycle/workflows/4-implementation/add-feature/workflow.yaml as 'workflow-config'
+4. Follow workflow.xml instructions EXACTLY
+5. Save outputs after EACH section
+</steps>
+
+$ARGUMENTS

package/.claude/commands/gaia-edit-ux.md

@@ -0,0 +1,17 @@
+---
+name: 'edit-ux'
+description: 'Edit an existing UX design. Use when "edit the UX design".'
+model: opus
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THESE STEPS:
+
+<steps CRITICAL="TRUE">
+1. LOAD the FULL {project-root}/_gaia/core/engine/workflow.xml
+2. READ its entire contents — this is the CORE OS
+3. Pass {project-root}/_gaia/lifecycle/workflows/2-planning/edit-ux-design/workflow.yaml as 'workflow-config'
+4. Follow workflow.xml instructions EXACTLY
+5. Save outputs after EACH section
+</steps>
+
+$ARGUMENTS

package/.claude/commands/gaia-resume.md

@@ -7,7 +7,7 @@ model: sonnet
 IT IS CRITICAL THAT YOU FOLLOW THESE STEPS:
 
 <steps CRITICAL="TRUE">
-1. SCAN {project-root}/_gaia/_memory/checkpoints/ for .yaml files (exclude completed/)
+1. SCAN {project-root}/_memory/checkpoints/ for .yaml files (exclude completed/)
 2. If no checkpoints found: report "No active workflows to resume" and suggest /gaia
 3. If one checkpoint: display its summary and offer Resume / Restart / Discard
 4. If multiple checkpoints: list all with timestamps, ask user which to resume

package/.claude/commands/gaia-validate-prd.md

@@ -1,15 +1,21 @@
 ---
 name: 'validate-prd'
-description: 'Validate a PRD against standards. Use when "validate the PRD".'
+description: 'DEPRECATED — Redirects to /gaia-val-validate'
 model: sonnet
 ---
 
-IT IS CRITICAL THAT YOU FOLLOW THESE STEPS:
+> **This command is deprecated.**
+>
+> `/gaia-validate-prd` has been replaced by `/gaia-val-validate`, which provides unified artifact validation through Val's document-specific rulesets.
+>
+> **What changed:** Val now handles all artifact validation (PRDs, architecture docs, UX designs, and more) using document-specific rulesets. There is no longer a separate PRD-only validation workflow.
+>
+> **What to do:** Run `/gaia-val-validate` instead. It accepts any artifact type and applies the appropriate validation rules automatically.
 
 <steps CRITICAL="TRUE">
 1. LOAD the FULL {project-root}/_gaia/core/engine/workflow.xml
 2. READ its entire contents — this is the CORE OS
-3. Pass {project-root}/_gaia/lifecycle/workflows/2-planning/validate-prd/workflow.yaml as 'workflow-config'
+3. Pass {project-root}/_gaia/lifecycle/workflows/4-implementation/val-validate-artifact/workflow.yaml as 'workflow-config'
 4. Follow workflow.xml instructions EXACTLY
 5. Save outputs after EACH section
 </steps>

package/CLAUDE.md

@@ -1,5 +1,5 @@
 
-# GAIA Framework v1.65.0
+# GAIA Framework v1.65.1
 
 This project uses the **GAIA** (Generative Agile Intelligence Architecture) framework — an AI agent framework for Claude Code that orchestrates software product development through 26 specialized agents, 65 workflows, and 8 shared skills.
 

package/README.md

@@ -1,6 +1,6 @@
 # GAIA — Generative Agile Intelligence Architecture
 
-[![Framework](https://img.shields.io/badge/framework-v1.57.1-blue)]()
+[![Framework](https://img.shields.io/badge/framework-v1.65.1-blue)]()
 [![License](https://img.shields.io/badge/license-AGPL--3.0-green)]()
 [![Agents](https://img.shields.io/badge/agents-26-purple)]()
 [![Workflows](https://img.shields.io/badge/workflows-73-orange)]()
@@ -245,7 +245,7 @@ Workflows are structured multi-step processes. Each has a `workflow.yaml` config
 | Command | Workflow | Agent | Model | Output |
 |---------|----------|-------|-------|--------|
 | `/gaia-create-prd` | Create PRD | Derek | Opus | `docs/planning-artifacts/` |
-| `/gaia-validate-prd` | Validate PRD | Derek | Sonnet | `docs/planning-artifacts/` |
+| `/gaia-validate-prd` | ~~Validate PRD~~ (deprecated -- use `/gaia-val-validate`) | Derek | Sonnet | `docs/planning-artifacts/` |
 | `/gaia-edit-prd` | Edit PRD | Derek | Opus | `docs/planning-artifacts/` |
 | `/gaia-create-ux` | Create UX Design | Christy | Opus | `docs/planning-artifacts/` |
 
@@ -460,7 +460,7 @@ The single source of truth is `_gaia/_config/global.yaml`:
 
 ```yaml
 framework_name: "GAIA"
-framework_version: "1.65.0"
+framework_version: "1.65.1"
 user_name: "your-name"
 project_name: "your-project"
 ```

package/_gaia/_config/adversarial-triggers.yaml

@@ -0,0 +1,91 @@
+# Adversarial Review Trigger Rules
+# Declarative config governing when adversarial reviews are triggered.
+# Change types: feature, high-risk-enhancement, low-risk-enhancement, bug-fix, documentation, patch
+# Artifacts: prd, architecture, ux-design, test-plan
+# When no change_type context is available (standalone creation), default to "feature".
+
+high_risk_enhancement_criteria:
+  description: "A high-risk enhancement is any enhancement where the story risk field is 'high'"
+  matches:
+    - field: risk
+      value: high
+    - field: change_type
+      value: enhancement
+
+trigger_rules:
+  # --- PRD artifact ---
+  - change_type: feature
+    artifact: prd
+    adversarial: true
+  - change_type: high-risk-enhancement
+    artifact: prd
+    adversarial: true
+  - change_type: low-risk-enhancement
+    artifact: prd
+    adversarial: false
+  - change_type: bug-fix
+    artifact: prd
+    adversarial: false
+  - change_type: documentation
+    artifact: prd
+    adversarial: false
+  - change_type: patch
+    artifact: prd
+    adversarial: false
+
+  # --- Architecture artifact ---
+  # Architecture adversarial requires BOTH a triggering change type AND magnitude >= SIGNIFICANT
+  - change_type: feature
+    artifact: architecture
+    adversarial: true
+    magnitude_threshold: SIGNIFICANT
+  - change_type: high-risk-enhancement
+    artifact: architecture
+    adversarial: true
+    magnitude_threshold: SIGNIFICANT
+  - change_type: low-risk-enhancement
+    artifact: architecture
+    adversarial: false
+  - change_type: bug-fix
+    artifact: architecture
+    adversarial: false
+  - change_type: documentation
+    artifact: architecture
+    adversarial: false
+  - change_type: patch
+    artifact: architecture
+    adversarial: false
+
+  # --- UX Design artifact --- (never triggers adversarial)
+  - change_type: feature
+    artifact: ux-design
+    adversarial: false
+  - change_type: high-risk-enhancement
+    artifact: ux-design
+    adversarial: false
+  - change_type: low-risk-enhancement
+    artifact: ux-design
+    adversarial: false
+  - change_type: bug-fix
+    artifact: ux-design
+    adversarial: false
+  - change_type: documentation
+    artifact: ux-design
+    adversarial: false
+  - change_type: patch
+    artifact: ux-design
+    adversarial: false
+
+  # --- Test Plan artifact --- (never triggers adversarial)
+  - change_type: feature
+    artifact: test-plan
+    adversarial: false
+  - change_type: high-risk-enhancement
+    artifact: test-plan
+    adversarial: false
+  - change_type: low-risk-enhancement
+    artifact: test-plan
+    adversarial: false
+  - change_type: bug-fix
+    artifact: test-plan
+    adversarial: false

package/_gaia/_config/files-manifest.csv

@@ -1,5 +1,6 @@
 path,type,module,description
 "_gaia/_config/global.yaml","config","core","Global framework configuration"
+"_gaia/_config/adversarial-triggers.yaml","config","core","Declarative trigger rules for adversarial reviews"
 "_gaia/core/config.yaml","config","core","Core module configuration"
 "_gaia/lifecycle/config.yaml","config","lifecycle","Lifecycle module configuration"
 "_gaia/dev/config.yaml","config","dev","Developer module configuration"

package/_gaia/_config/gaia-help.csv

@@ -11,9 +11,10 @@ module,phase,name,code,command,required,agent-name,description,output-location
 "lifecycle","1-analysis","technical-research","tech-research","gaia-tech-research","false","analyst","Research a technology","docs/planning-artifacts"
 "lifecycle","1-analysis","create-product-brief","product-brief","gaia-product-brief","false","analyst","Create a product brief","docs/planning-artifacts"
 "lifecycle","2-planning","create-prd","create-prd","gaia-create-prd","true","pm","Create a Product Requirements Document","docs/planning-artifacts"
-"lifecycle","2-planning","validate-prd","validate-prd","gaia-validate-prd","false","pm","Validate PRD against standards","docs/planning-artifacts"
+"lifecycle","2-planning","validate-prd","validate-prd","gaia-validate-prd","false","pm","DEPRECATED — Replaced by unified artifact validation","docs/planning-artifacts"
 "lifecycle","2-planning","edit-prd","edit-prd","gaia-edit-prd","false","pm","Edit an existing PRD","docs/planning-artifacts"
 "lifecycle","2-planning","create-ux-design","create-ux","gaia-create-ux","false","ux-designer","Create UX design specifications","docs/planning-artifacts"
+"lifecycle","2-planning","edit-ux-design","edit-ux","gaia-edit-ux","false","ux-designer","Edit an existing UX design","docs/planning-artifacts"
 "lifecycle","3-solutioning","create-architecture","create-arch","gaia-create-arch","true","architect","Design system architecture","docs/planning-artifacts"
 "lifecycle","3-solutioning","create-epics-stories","create-epics","gaia-create-epics","true","pm","Break requirements into epics and stories","docs/planning-artifacts"
 "lifecycle","3-solutioning","implementation-readiness","readiness-check","gaia-readiness-check","true","architect","Validate readiness for implementation","docs/planning-artifacts"
@@ -73,10 +74,13 @@ module,phase,name,code,command,required,agent-name,description,output-location
 "testing","anytime","mobile-testing","mobile-testing","gaia-mobile-testing","false","test-architect","Create mobile test plan covering devices and responsive","docs/test-artifacts"
 "creative","anytime","creative-sprint","creative-sprint","gaia-creative-sprint","false","orchestrator","Multi-agent creative pipeline: empathize → solve → innovate","docs/creative-artifacts"
 "core","anytime","validate-framework","validate-framework","gaia-validate-framework","false","orchestrator","Run GAIA framework self-validation","n/a"
-"lifecycle","4-implementation","change-request","change-request","gaia-change-request","false","pm","Impact-driven change request with analysis, approval gate, and cascade updates","docs/planning-artifacts"
+"lifecycle","4-implementation","change-request","change-request","gaia-change-request","false","pm","DEPRECATED — Redirects to /gaia-add-feature. Use add-feature instead.","docs/planning-artifacts"
+"lifecycle","4-implementation","add-feature","add-feature","gaia-add-feature","false","pm","Triage and route a fix, enhancement, or feature through affected artifacts","docs/planning-artifacts"
 "lifecycle","4-implementation","add-stories","add-stories","gaia-add-stories","false","pm","Add incremental stories to existing epics-and-stories.md","docs/planning-artifacts"
 "lifecycle","4-implementation","tech-debt-review","tech-debt-review","gaia-tech-debt-review","false","sm","Aggregate, classify, and prioritize technical debt","docs/implementation-artifacts"
-"lifecycle","4-implementation","agent-validator","agent-validator","gaia-agent-validator","false","Val","Val — Validator Agent for artifact verification","n/a"
-"lifecycle","4-implementation","val-validate","val-validate","gaia-val-validate","false","Val","Validate artifact against codebase and ground truth","docs/implementation-artifacts"
-"lifecycle","4-implementation","val-validate-plan","val-validate-plan","gaia-val-validate-plan","false","Val","Validate implementation plan before execution","docs/implementation-artifacts"
-"lifecycle","4-implementation","refresh-ground-truth","refresh-ground-truth","gaia-refresh-ground-truth","false","Val","Rescan filesystem and update verified ground truth","_memory/validator-sidecar"
+"lifecycle","4-implementation","agent-validator","agent-validator","gaia-agent-validator","false","validator","Val — Validator Agent for artifact verification","n/a"
+"lifecycle","4-implementation","val-validate","val-validate","gaia-val-validate","false","validator","Validate artifact against codebase and ground truth","docs/implementation-artifacts"
+"lifecycle","4-implementation","val-validate-artifact","val-validate-artifact","gaia-val-validate","false","validator","Validate artifact against codebase and ground truth","docs/implementation-artifacts"
+"lifecycle","4-implementation","val-validate-plan","val-validate-plan","gaia-val-validate-plan","false","validator","Validate implementation plan before execution","docs/implementation-artifacts"
+"lifecycle","4-implementation","val-refresh-ground-truth","val-refresh-ground-truth","gaia-refresh-ground-truth","false","validator","Rescan filesystem and update verified ground truth","_memory/validator-sidecar"
+"lifecycle","4-implementation","val-save-session","val-save-session","gaia-val-save-session","false","validator","Persist validation decisions to memory sidecar","_memory/validator-sidecar"

package/_gaia/_config/global.yaml

@@ -3,7 +3,7 @@
 # After modifying this file, run /gaia-build-configs to regenerate resolved configs.
 
 framework_name: "GAIA"
-framework_version: "1.65.0"
+framework_version: "1.65.1"
 
 # User settings
 user_name: "jlouage"
@@ -23,6 +23,7 @@ project_path: "Gaia-framework"
 # Val integration — feature gates for inline validation
 val_integration:
   template_output_review: true   # Show [v] Review with Val at template-output prompts
+  val_validate_output: true      # Enable automatic Val validation when workflow declares val_validate_output: true
 
 # Output paths
 output_folder: "{project-root}/docs"

package/_gaia/_config/lifecycle-sequence.yaml

@@ -72,11 +72,11 @@ sequence:
     phase: 2-planning
     command: /gaia-create-prd
     next:
-      primary: /gaia-validate-prd
+      primary: /gaia-val-validate
 
-  validate-prd:
+  val-validate:
     phase: 2-planning
-    command: /gaia-validate-prd
+    command: /gaia-val-validate
     next:
       on_pass: /gaia-create-ux
       on_fail: /gaia-edit-prd
@@ -85,7 +85,7 @@ sequence:
     phase: 2-planning
     command: /gaia-edit-prd
     next:
-      primary: /gaia-validate-prd
+      primary: /gaia-val-validate
 
   create-ux-design:
     phase: 2-planning
@@ -340,6 +340,12 @@ sequence:
         - command: /gaia-create-story
           context: "To create individual stories from triaged findings"
 
+  action-items:
+    phase: 4-implementation
+    command: /gaia-action-items
+    next:
+      standalone: true
+
   retrospective:
     phase: 4-implementation
     command: /gaia-retro
@@ -453,6 +459,22 @@ sequence:
         - command: /gaia-dev-story
           context: "To implement performance fixes"
 
+  # -- Deprecated (kept for manifest consistency until workflows are removed) --
+  validate-prd:
+    module: lifecycle
+    command: /gaia-validate-prd
+    deprecated: true
+    next:
+      standalone: true
+      note: "Deprecated — superseded by /gaia-val-validate. Will be removed in E10-S3."
+
+  edit-ux-design:
+    module: lifecycle
+    command: /gaia-edit-ux
+    next:
+      standalone: true
+      note: "Standalone UX design editor"
+
   # -- Quick flow --
   quick-spec:
     module: lifecycle

package/_gaia/_config/manifest.yaml

@@ -3,11 +3,11 @@
 
 modules:
   - name: core
-    version: "1.12.0"
+    version: "1.12.2"
     path: "_gaia/core"
     type: built-in
   - name: lifecycle
-    version: "1.37.0"
+    version: "1.37.2"
     path: "_gaia/lifecycle"
     type: built-in
   - name: dev
@@ -19,6 +19,6 @@ modules:
     path: "_gaia/creative"
     type: built-in
   - name: testing
-    version: "1.8.0"
+    version: "1.8.1"
     path: "_gaia/testing"
     type: built-in

package/_gaia/_config/skill-manifest.csv

@@ -9,4 +9,6 @@ name,displayName,description,path,applicable_agents
 "security-basics","Security Basics","OWASP Top 10, input validation, secrets, CORS/CSRF","_gaia/dev/skills/security-basics.md","all-dev,architect,security,devops"
 "validation-patterns","Validation Patterns","Claim extraction, filesystem verification, cross-reference, severity classification, findings formatting","_gaia/lifecycle/skills/validation-patterns.md","validator"
 "ground-truth-management","Ground Truth Management","Entry structure, incremental/full refresh, conflict resolution, archival, token budget, brownfield extraction","_gaia/lifecycle/skills/ground-truth-management.md","validator"
-"memory-management","Memory Management","Session load/save, decision formatting, stale detection, deduplication, context summarization","_gaia/lifecycle/skills/memory-management.md","all"
+"memory-management","Memory Management","Session load/save, decision formatting, stale detection, deduplication, context summarization, cross-ref loading, budget-monitoring","_gaia/lifecycle/skills/memory-management.md","all"
+"memory-management-cross-agent","Memory Management Cross-Agent","Cross-agent memory read protocol for loading other agents' sidecar files","_gaia/lifecycle/skills/memory-management-cross-agent.md","all"
+"document-rulesets","Document Rulesets","Artifact type detection, document-specific validation rulesets (prd, arch, ux, test-plan, epics), two-pass validation logic","_gaia/lifecycle/skills/document-rulesets.md","validator"

package/_gaia/_config/workflow-manifest.csv

@@ -8,9 +8,10 @@ name,displayName,description,module,phase,path,command,agent
 "technical-research","Technical Research","Research a technology","lifecycle","1-analysis","_gaia/lifecycle/workflows/1-analysis/technical-research/workflow.yaml","gaia-tech-research","analyst"
 "create-product-brief","Create Product Brief","Create a product brief","lifecycle","1-analysis","_gaia/lifecycle/workflows/1-analysis/create-product-brief/workflow.yaml","gaia-product-brief","analyst"
 "create-prd","Create PRD","Create a Product Requirements Document","lifecycle","2-planning","_gaia/lifecycle/workflows/2-planning/create-prd/workflow.yaml","gaia-create-prd","pm"
-"validate-prd","Validate PRD","Validate PRD against standards","lifecycle","2-planning","_gaia/lifecycle/workflows/2-planning/validate-prd/workflow.yaml","gaia-validate-prd","pm"
+"validate-prd","Validate PRD (deprecated)","DEPRECATED — Use /gaia-val-validate instead","lifecycle","2-planning","_gaia/lifecycle/workflows/2-planning/validate-prd/workflow.yaml","gaia-validate-prd","pm"
 "edit-prd","Edit PRD","Edit an existing PRD","lifecycle","2-planning","_gaia/lifecycle/workflows/2-planning/edit-prd/workflow.yaml","gaia-edit-prd","pm"
 "create-ux-design","Create UX Design","Plan UX patterns and design specs","lifecycle","2-planning","_gaia/lifecycle/workflows/2-planning/create-ux-design/workflow.yaml","gaia-create-ux","ux-designer"
+"edit-ux-design","Edit UX Design","Edit an existing UX design","lifecycle","2-planning","_gaia/lifecycle/workflows/2-planning/edit-ux-design/workflow.yaml","gaia-edit-ux","ux-designer"
 "create-architecture","Create Architecture","Design system architecture","lifecycle","3-solutioning","_gaia/lifecycle/workflows/3-solutioning/create-architecture/workflow.yaml","gaia-create-arch","architect"
 "edit-architecture","Edit Architecture","Edit an existing architecture document","lifecycle","3-solutioning","_gaia/lifecycle/workflows/3-solutioning/edit-architecture/workflow.yaml","gaia-edit-arch","architect"
 "create-epics-stories","Create Epics and Stories","Break requirements into epics and stories","lifecycle","3-solutioning","_gaia/lifecycle/workflows/3-solutioning/create-epics-stories/workflow.yaml","gaia-create-epics","pm"
@@ -60,9 +61,9 @@ name,displayName,description,module,phase,path,command,agent
 "epic-status","Epic Status","Show epic completion dashboard across all sprints","lifecycle","4-implementation","_gaia/lifecycle/workflows/4-implementation/epic-status/workflow.yaml","gaia-epic-status","sm"
 "triage-findings","Triage Findings","Triage development findings into backlog stories","lifecycle","4-implementation","_gaia/lifecycle/workflows/4-implementation/triage-findings/workflow.yaml","gaia-triage-findings","sm"
 "creative-sprint","Creative Sprint","Multi-agent creative pipeline: empathize → solve → innovate","creative","anytime","_gaia/creative/workflows/creative-sprint/workflow.yaml","gaia-creative-sprint","orchestrator"
-"change-request","Change Request","Impact-driven change request with analysis and cascade updates","lifecycle","4-implementation","_gaia/lifecycle/workflows/4-implementation/change-request/workflow.yaml","gaia-change-request","pm"
+"change-request","Change Request (deprecated)","DEPRECATED — Use /gaia-add-feature instead. Redirects to add-feature workflow.","lifecycle","4-implementation","_gaia/lifecycle/workflows/4-implementation/change-request/workflow.yaml","gaia-change-request","pm"
 "add-stories","Add Stories","Add new stories to existing epics or create new epics with stories","lifecycle","4-implementation","_gaia/lifecycle/workflows/4-implementation/add-stories/workflow.yaml","gaia-add-stories","pm"
-"add-feature","Add Feature","Guided cascade for adding a new feature to an existing product","lifecycle","cross-phase","_gaia/lifecycle/workflows/cross-phase/add-feature/workflow.yaml","gaia-add-feature","orchestrator"
+"add-feature","Add Feature","Triage and route a fix, enhancement, or feature through affected artifacts","lifecycle","4-implementation","_gaia/lifecycle/workflows/4-implementation/add-feature/workflow.yaml","gaia-add-feature","pm"
 "tech-debt-review","Tech Debt Review","Aggregate and prioritize technical debt","lifecycle","4-implementation","_gaia/lifecycle/workflows/4-implementation/tech-debt-review/workflow.yaml","gaia-tech-debt-review","sm"
 "val-validate-artifact","Validate Artifact","Validate artifact against codebase and ground truth","lifecycle","4-implementation","_gaia/lifecycle/workflows/4-implementation/val-validate-artifact/workflow.yaml","gaia-val-validate","validator"
 "val-validate-plan","Validate Plan","Validate implementation plan before execution","lifecycle","4-implementation","_gaia/lifecycle/workflows/4-implementation/val-validate-plan/workflow.yaml","gaia-val-validate-plan","validator"
@@ -71,3 +72,4 @@ name,displayName,description,module,phase,path,command,agent
 "check-dod","Check Definition of Done","Check Definition of Done criteria for a story before review transition","lifecycle","4-implementation","_gaia/lifecycle/workflows/4-implementation/check-dod/workflow.yaml","gaia-check-dod","sm"
 "run-all-reviews","Run All Reviews","Runs all 6 review workflows sequentially via subagents","lifecycle","4-implementation","_gaia/lifecycle/workflows/4-implementation/run-all-reviews/workflow.yaml","gaia-run-all-reviews","orchestrator"
 "check-review-gate","Check Review Gate","Check composite review gate status and transition story to done if all reviews pass","lifecycle","4-implementation","_gaia/lifecycle/workflows/4-implementation/check-review-gate/workflow.yaml","gaia-check-review-gate","sm"
+"action-items","Action Items","Process and resolve action items from retro, triage, tech-debt, and correct-course","lifecycle","4-implementation","_gaia/lifecycle/workflows/4-implementation/action-items/workflow.yaml","gaia-action-items","orchestrator"

package/_gaia/core/config.yaml

@@ -2,7 +2,7 @@
 inherits: "{project-root}/_gaia/_config/global.yaml"
 
 module_name: "core"
-module_version: "1.12.0"
+module_version: "1.12.2"
 
 engine_path: "{project-root}/_gaia/core/engine/workflow.xml"
 tasks_path: "{project-root}/_gaia/core/tasks"

package/_gaia/core/engine/workflow.xml

@@ -68,8 +68,17 @@ execution modes (normal/yolo/planning), checkpoints, and quality gates.
     <action if="agent is 'dev-*' (wildcard)">Check if workflow.yaml declares agent_auto_detect: true. If true, execute the agent_auto_detect_strategy from workflow.yaml to determine the stack. If auto-detection succeeds, resolve to {project-root}/_gaia/dev/agents/{detected_stack}-dev.md and inform user: "Auto-detected developer: {agent_name} based on {detection_source}." If auto-detection fails or agent_auto_detect is false/absent: ask user which stack developer to use (typescript, angular, flutter, java, python, mobile, go), then resolve to {project-root}/_gaia/dev/agents/{stack}-dev.md</action>
     <action if="agent file resolved">Read the agent persona file — adopt its persona, name, communication style, rules, and domain knowledge for the duration of this workflow</action>
     <action if="agent file resolved">Do NOT execute the agent's activation protocol, greeting, or menu — the workflow engine controls step execution</action>
-    <action if="agent file resolved">Do NOT load the agent's memory sidecar — the workflow engine manages its own checkpoints</action>
     <action if="agent file resolved">Check for {project-root}/_gaia/_config/agents/{agent-id}.customize.yaml. If found, load and merge overrides (persona_overrides, menu_additions, menu_removals, skill_additions, rule_additions, skill_overrides, skill_section_overrides). For dev agents, also check all-dev.customize.yaml and merge (agent-specific takes precedence over all-dev).</action>
+
+    <!-- Memory Load Protocol (E9-S7) — Load agent memory sidecar files after persona, before instructions -->
+    <action if="agent file resolved">Read {project-root}/_memory/config.yaml to resolve agent tier and sidecar path. If the file does not exist, log "Memory config not found — skipping memory loading." and skip all remaining memory load actions in this step.</action>
+    <action if="agent file resolved">Resolve the agent's tier classification: look up the resolved agent ID in _memory/config.yaml tier lists — check tiers.tier_1.agents, tiers.tier_2.agents, and tiers.tier_3.agents in that order. If the agent ID is not found in any tier list (untiered), treat as Tier 3 by default — load decision-log.md only if it exists, with no budget enforcement.</action>
+    <action if="agent file resolved">Resolve sidecar path: read agents.{agent-id}.sidecar from _memory/config.yaml, construct absolute path as {project-root}/_memory/{sidecar_value}/. If the agent entry is not found in the agents section, construct path as {project-root}/_memory/{agent-id}-sidecar/.</action>
+    <action if="agent file resolved">Check if the sidecar directory exists. If the directory does not exist or is empty, skip all file loading silently — no error, no warning. Proceed to Step 4.</action>
+    <action if="agent file resolved and tier == 1">Load canonical sidecar files (silently skip any that do not exist): ground-truth.md, decision-log.md, conversation-context.md (3 files). These provide the agent's persistent ground truth, decision history, and recent conversation context.</action>
+    <action if="agent file resolved and tier == 2">Load canonical sidecar files (silently skip any that do not exist): decision-log.md, conversation-context.md (2 files). Tier 2 agents do not have ground-truth.md.</action>
+    <action if="agent file resolved and tier == 3 or untiered">Load canonical sidecar file (silently skip if it does not exist): decision-log.md (1 file). Tier 3 and untiered agents receive minimal memory context.</action>
+    <action if="agent file resolved and tier in [1, 2]">Estimate token budget usage: sum the byte lengths of all loaded sidecar files, divide by the token_approximation value (default: 4 chars per token, from _memory/config.yaml archival.token_approximation). Compare against the agent's session_budget from the tier definition in _memory/config.yaml. If usage reaches or exceeds the budget_warn_at threshold (0.8 / 80% from _memory/config.yaml archival.budget_warn_at): display warning "Memory budget at {N}% for {agent_name} — {used}K of {budget}K tokens." For Tier 3 and untiered agents (session_budget: null), skip the token budget check entirely.</action>
   </step>
 
   <step n="4" title="Load Instructions">
@@ -82,16 +91,23 @@ execution modes (normal/yolo/planning), checkpoints, and quality gates.
     <action>Check workflow.yaml for 'execution_mode' field — default to 'normal' if absent</action>
     <action if="execution_mode != 'planning'">Skip this step — proceed to Process Instructions</action>
     <action if="mode was explicitly set by caller (subagent prompt) AND mode is NOT yolo">Skip this step — use the caller-requested mode</action>
-    <action if="mode was explicitly set by caller as yolo">Still execute the Planning Gate to generate the plan. After generating, check if workflow.yaml declares val_auto_in_yolo: true and the planning step number (5) is in val_auto_in_yolo_steps. If so, auto-invoke val-validate-artifact to validate the plan. If Val returns CRITICAL/WARNING findings: auto-fix the plan, re-invoke Val, repeat up to 3 iterations. If resolved: auto-approve the plan and set runtime mode to yolo. If unresolved after 3 iterations: HALT with findings list. If Val prerequisites not met or val_auto_in_yolo is false: auto-approve the plan without Val and set runtime mode to yolo. Do NOT present the [a]/[y]/[r]/[x] prompt — the plan is auto-approved after Val passes.</action>
+    <action if="mode was explicitly set by caller as yolo">Still execute the Planning Gate to generate the plan. After generating, check if workflow.yaml declares val_auto_in_yolo: true and the planning step number (5) is in val_auto_in_yolo_steps. If so, auto-invoke val-validate-plan to validate the plan. If Val returns CRITICAL/WARNING findings: auto-fix the plan, re-invoke Val, repeat up to 3 iterations. If resolved: auto-approve the plan and set runtime mode to yolo. If unresolved after 3 iterations: HALT with findings list. If Val prerequisites not met or val_auto_in_yolo is false: auto-approve the plan without Val and set runtime mode to yolo. Do NOT present the [a]/[y]/[r]/[x] prompt — the plan is auto-approved after Val passes.</action>
     <action>Invoke discover-inputs protocol to load all declared input files</action>
     <action>Parse the loaded instructions to extract: step titles, action summaries, template-output paths, optional steps, skill references, subagent invocations</action>
     <action>For input files: extract brief context (key metadata, not full content)</action>
     <action>Present structured execution plan to user using the planning-output format: Context, Files to Modify, Detailed Edits, Version Bumps (if applicable), Implementation Order, Verification. Omit empty sections.</action>
-    <action>Prompt: "[a] Approve (normal) | [y] Approve (YOLO) | [r] Revise plan | [x] Abort"</action>
+    <action>Check if Val integration is available for the planning gate: read {project-root}/_gaia/_config/global.yaml and check if val_integration.template_output_review is true. Check if {project-root}/_gaia/lifecycle/agents/validator.md exists AND {project-root}/_memory/validator-sidecar/ exists. Set val_review_available = true only if all three conditions pass. If any condition fails, set val_review_available = false.</action>
+    <action if="val_review_available == true">Prompt: "[a] Approve (normal) | [y] Approve (YOLO) | [r] Revise plan | [v] Review with Val (recommended) | [x] Abort"</action>
+    <action if="val_review_available == false">Prompt: "[a] Approve (normal) | [y] Approve (YOLO) | [r] Revise plan | [x] Abort"</action>
     <action if="[a]">Set runtime mode to normal — proceed to Process Instructions</action>
     <action if="[y]">Set runtime mode to yolo — proceed to Process Instructions</action>
-    <action if="[r]">Ask for feedback, regenerate plan, re-prompt</action>
+    <action if="[r]">Ask for feedback, regenerate plan. Previous findings are discarded — each [v] press triggers fresh validation with no caching. Re-prompt with the same options.</action>
     <action if="[x]">HALT — write checkpoint noting user abort</action>
+    <action if="[v] and plan has zero steps">Display "Plan contains no steps to validate." and return to the planning gate prompt without invoking Val.</action>
+    <action if="[v]">Invoke val-validate-plan as a subagent, passing the execution plan and the source_workflow (current workflow name). Each [v] press runs fresh validation — previous findings are discarded after plan revision, no caching. The discussion loop allows the user to discuss findings with Val, selectively accept or dismiss individual findings, and re-validate after making changes.</action>
+    <action if="Val returns zero findings">Display "Validation complete: no issues found." and return to the planning gate prompt with options [a] | [y] | [r] | [v] | [x].</action>
+    <action if="Val returns findings">Present findings to the user. Enter the discussion loop: user can selectively accept, dismiss, or discuss individual findings. After the user finishes reviewing, return to the planning gate prompt with all options [a] | [y] | [r] | [v] | [x].</action>
+    <action if="Val subagent fails (model unavailable, crash, timeout, context too large)">Display "Val validation could not complete: {reason}. Continuing without validation." and return to the planning gate prompt with [a] | [y] | [r] | [x] options (no [v]).</action>
     <action>Write checkpoint: planning gate approved, selected runtime mode</action>
   </step>
 
@@ -122,6 +138,7 @@ execution modes (normal/yolo/planning), checkpoints, and quality gates.
     <action>At template-output in normal mode: first check if workflow.yaml declares a template_output_prompt field. If set to "auto": skip the template-output prompt entirely — save the file and auto-proceed to the next step with no user interaction. This is for read-only outputs (dashboards, reports) that need no user review. If set to a custom string (not "auto"): use that custom prompt string instead of the default options — parse [e] and [v] handlers from it as usual, and for any other user input auto-proceed to the next step. If template_output_prompt is absent: use the default prompt — if Val integration is enabled, show user the output and offer [c] Continue | [y] YOLO | [e] Edit | [v] Review with Val. If Val integration is not enabled, show user the output and offer [c]ontinue [y]olo [e]dit.</action>
     <action>At [v] handler: when user presses [v], first check if the artifact file path has content. If the artifact has not been written yet or is empty, display "No artifact content to validate yet." and return to the template-output prompt without invoking Val. If content exists, invoke val-validate-artifact as a subagent, passing the artifact_path (the file just saved at template-output) and the source_workflow (the current workflow name from workflow.yaml). If Val completes and returns findings, present findings to the user and let user approve which findings to apply. Only approved findings are written to the artifact under a "## Validation Findings" section. After writing, return to the template-output prompt with the updated artifact content. If Val completes with zero findings, display "Validation complete: no issues found." and return to the template-output prompt with [c]/[y]/[e]/[v] options. If Val's subagent invocation fails for any reason (model unavailable, context too large, timeout), display "Val validation could not complete: {reason}. Continuing without validation." and return to the template-output prompt with [c]/[y]/[e]/[v] options. The user is never left stuck.</action>
     <action>At template-output in yolo mode: auto-continue UNLESS open question indicators were detected — if detected, pause and display guidance as in normal mode. Open questions require human input and cannot be auto-answered. The [v] option is not auto-triggered in YOLO mode UNLESS the workflow.yaml declares val_auto_in_yolo: true AND the current instruction step number is listed in val_auto_in_yolo_steps AND Val integration prerequisites pass (global.yaml val_integration.template_output_review is true, validator.md exists, validator-sidecar/ exists). When all conditions are met: auto-invoke val-validate-artifact as a subagent with the artifact_path (file just saved) and source_workflow. If Val returns CRITICAL or WARNING findings: the dev agent must auto-fix them, then re-invoke Val to re-validate. Repeat this fix→validate loop up to 3 iterations. If resolved: save findings and fixes to artifact and validator-sidecar memory, then auto-continue. If unresolved after 3 iterations: HALT and inform user with the list of unresolved findings. INFO-level findings are logged to artifact and validator-sidecar memory but do not block. If Val invocation fails (model unavailable, timeout, context too large): HALT and inform user "Val validation could not complete: {reason}. Cannot proceed without validation in YOLO mode." — do NOT auto-continue.</action>
+    <action>At template-output with val_validate_output flag (per-workflow mandatory validation — ADR-017): after saving a template-output, check if the loaded workflow.yaml declares val_validate_output: true. If the flag is absent or false, skip this action entirely (backward compatible — no change in behavior for existing workflows). If the flag is true: first check the global emergency disable toggle by reading {project-root}/_gaia/_config/global.yaml and checking val_integration.val_validate_output. If the global toggle is false, skip validation entirely regardless of the workflow flag — this is the emergency kill switch. If both the workflow flag and global toggle are true: check Val integration prerequisites (validator.md exists, validator-sidecar/ exists). If prerequisites fail, skip validation silently — do not error. If prerequisites pass: auto-invoke val-validate-artifact as a subagent with the artifact_path (file just saved at template-output) and source_workflow. This applies in ALL execution modes — normal, yolo, and planning — because val_validate_output is a per-workflow mandatory validation requirement independent of user interaction mode. Precedence: if val_auto_in_yolo already triggered Val for this template-output (yolo mode only), val_validate_output does NOT re-invoke — one validation per template-output is sufficient. If Val returns CRITICAL or WARNING findings: auto-fix them, then re-invoke Val to re-validate. Repeat this auto-fix loop up to 3 iterations. If resolved within 3 iterations: save findings and fixes to artifact and validator-sidecar memory, then continue. If unresolved after 3 iterations: HALT and present the list of unresolved findings to the user. INFO-level findings are logged but do not block. If Val invocation fails (model unavailable, timeout, context too large): HALT and inform user "Val validation could not complete: {reason}."</action>
     <action>When a subagent returns: present summary of results. In normal mode: wait for user [c]ontinue before proceeding. Subagent completion MUST NOT auto-advance the workflow.</action>
     <action>After each step completes: write checkpoint with step number, key variables, output paths, and files_touched (for each file created/modified during this workflow, run shasum -a 256 {path} and record path, checksum as "sha256:{hex}", last_modified as ISO 8601)</action>
   </step>
@@ -171,7 +188,10 @@ execution modes (normal/yolo/planning), checkpoints, and quality gates.
 <execution-modes>
   <mode name="normal">
     Pause at every template-output for user confirmation.
-    Prompt: "[c] Continue | [y] Switch to YOLO | [e] Edit output"
+    Prompt: "[c] Continue | [y] Switch to YOLO | [e] Edit output | [v] Review with Val"
+    The [v] option is shown when Val integration is enabled (val_integration.template_output_review: true in global.yaml,
+    validator.md exists, and validator-sidecar/ exists). When [v] is selected, the engine invokes val-validate-artifact
+    as a subagent to validate the saved artifact. If Val is not enabled, only [c]/[y]/[e] are shown.
     Pause at every ask tag — present the question and WAIT for user response.
     NEVER infer or skip an ask, even if the answer appears available from context.
     Pause when a subagent returns — show results summary and wait for [c]ontinue.

package/_gaia/core/workflows/brainstorming/template.md

@@ -1,3 +1,9 @@
+---
+template: 'brainstorming'
+version: 1.0.0
+used_by: ['brainstorming']
+---
+
 # Brainstorming Session: {topic}
 
 **Date:** {date}

package/_gaia/lifecycle/agents/pm.md

@@ -34,7 +34,7 @@ You must fully embody this agent's persona and follow the activation protocol EX
   <r>PRDs must be discoverable requirements, not guesses</r>
   <r>Validate with user before finalizing each PRD section</r>
   <r>Consume upstream analysis artifacts from {planning_artifacts}/</r>
-  <r>Quality gate: validate-prd must pass before architecture begins</r>
+  <r>Quality gate: /gaia-val-validate must pass before architecture begins</r>
 </rules>
 
 <memory-reads>
@@ -61,18 +61,18 @@ You must fully embody this agent's persona and follow the activation protocol EX
   </authority>
   <dod>
     <criterion>PRD saved to {planning_artifacts}/prd.md with all sections complete</criterion>
-    <criterion>validate-prd workflow passes with no critical findings</criterion>
+    <criterion>/gaia-val-validate passes with no critical findings</criterion>
     <criterion>Every requirement traces to a user need or business objective</criterion>
     <criterion>User has confirmed PRD accuracy at each section</criterion>
   </dod>
   <constraints>
     <constraint>NEVER invent requirements — all must come from user input or evidence</constraint>
-    <constraint>NEVER bypass validate-prd gate — architecture cannot start without it</constraint>
+    <constraint>NEVER bypass validation gate — architecture cannot start without /gaia-val-validate passing</constraint>
     <constraint>NEVER make technical architecture decisions — defer to Theo</constraint>
   </constraints>
   <handoffs>
-    <handoff to="architect" when="PRD validated" gate="validate-prd PASSED" />
-    <handoff to="ux-designer" when="PRD validated and UX design needed" gate="validate-prd PASSED" />
+    <handoff to="architect" when="PRD validated" gate="/gaia-val-validate PASSED" />
+    <handoff to="ux-designer" when="PRD validated and UX design needed" gate="/gaia-val-validate PASSED" />
     <handoff to="sm" when="Epics and stories created" gate="epics-and-stories.md exists" />
   </handoffs>
 </specification>
@@ -101,11 +101,10 @@ You must fully embody this agent's persona and follow the activation protocol EX
 
 <menu>
   <item cmd="1" label="Create PRD" description="Create Product Requirements Document" workflow="lifecycle/workflows/2-planning/create-prd/workflow.yaml" />
-  <item cmd="2" label="Validate PRD" description="Validate PRD against standards" workflow="lifecycle/workflows/2-planning/validate-prd/workflow.yaml" />
-  <item cmd="3" label="Edit PRD" description="Edit an existing PRD" workflow="lifecycle/workflows/2-planning/edit-prd/workflow.yaml" />
-  <item cmd="4" label="Create Epics & Stories" description="Break requirements into epics" workflow="lifecycle/workflows/3-solutioning/create-epics-stories/workflow.yaml" />
-  <item cmd="5" label="Change Request" description="Triage and route a change request" workflow="lifecycle/workflows/4-implementation/change-request/workflow.yaml" />
-  <item cmd="6" label="Add Stories" description="Add stories to existing epics" workflow="lifecycle/workflows/4-implementation/add-stories/workflow.yaml" />
+  <item cmd="2" label="Edit PRD" description="Edit an existing PRD" workflow="lifecycle/workflows/2-planning/edit-prd/workflow.yaml" />
+  <item cmd="3" label="Create Epics & Stories" description="Break requirements into epics" workflow="lifecycle/workflows/3-solutioning/create-epics-stories/workflow.yaml" />
+  <item cmd="5" label="Add Stories" description="Add stories to existing epics" workflow="lifecycle/workflows/4-implementation/add-stories/workflow.yaml" />
+  <item cmd="6" label="Add Feature" description="Triage and route a fix, enhancement, or feature" workflow="lifecycle/workflows/4-implementation/add-feature/workflow.yaml" />
 </menu>
 
 </agent>

package/_gaia/lifecycle/agents/ux-designer.md

@@ -88,6 +88,7 @@ You must fully embody this agent's persona and follow the activation protocol EX
 
 <menu>
   <item cmd="1" label="Create UX Design" description="Plan UX patterns and design specs" workflow="lifecycle/workflows/2-planning/create-ux-design/workflow.yaml" />
+  <item cmd="2" label="Edit UX Design" description="Edit existing UX design" workflow="lifecycle/workflows/2-planning/edit-ux-design/workflow.yaml" />
 </menu>
 
 </agent>

package/_gaia/lifecycle/agents/validator.md

@@ -165,7 +165,8 @@ You must fully embody this agent's persona and follow the activation protocol EX
   <item cmd="3" label="Revalidate" description="Re-run validation on a previously validated artifact" workflow="lifecycle/workflows/4-implementation/val-validate-artifact/workflow.yaml" />
   <item cmd="4" label="Review Findings" description="Review and discuss findings from the most recent validation" exec="lifecycle/tasks/val-review-findings.md" />
   <item cmd="5" label="Refresh Ground Truth" description="Scan framework and project directories to update ground-truth.md" workflow="lifecycle/workflows/4-implementation/val-refresh-ground-truth/workflow.yaml" />
-  <item cmd="6" label="Memory Status" description="Show ground truth freshness, decision count, and token budget usage" exec="lifecycle/tasks/val-memory-status.md" />
+  <item cmd="6" label="Save Session" description="Persist validation decisions and ground truth updates to memory sidecar" exec="lifecycle/tasks/val-save-session.md" />
+  <item cmd="7" label="Memory Status" description="Show ground truth freshness, decision count, and token budget usage" exec="lifecycle/tasks/val-memory-status.md" />
 </menu>
 
 <greeting>