gaia-framework 1.57.0 → 1.57.2

package/_gaia/_config/agents/CUSTOMIZATION-README.md

@@ -1,117 +0,0 @@
-# Agent Customization
-
-Place `{agent-id}.customize.yaml` files here to override agent defaults.
-
-## Scope Files
-
-- `{agent-id}.customize.yaml` — applies to one specific agent
-- `all-dev.customize.yaml` — applies to all 6 dev agents (angular-dev, typescript-dev, flutter-dev, java-dev, python-dev, mobile-dev)
-
-**Precedence:** agent-specific > all-dev > default. If both `flutter-dev.customize.yaml` and `all-dev.customize.yaml` define the same key, the agent-specific value wins.
-
-These files are loaded AFTER the agent's base `.md` file and merged at runtime.
-
-## Available Override Keys
-
-- `persona_overrides` — Modify persona fields (communication_style, principles, etc.)
-- `menu_additions` — Add extra menu items
-- `menu_removals` — Remove menu items by cmd number
-- `skill_additions` — Add extra skills to the agent's skill set (accepts `{name, path}` objects for custom skills)
-- `rule_additions` — Add extra rules
-- `skill_overrides` — Replace an entire skill file with a custom one (dev agents only)
-- `skill_section_overrides` — Replace specific sections within a skill (dev agents only)
-
-> **Note:** `skill_overrides` and `skill_section_overrides` apply only to dev agents (agents that extend `_base-dev.md`). Other agents use knowledge fragments, which are not currently overridable via this mechanism.
-
-## Examples
-
-### Persona Override
-
-`architect.customize.yaml`:
-
-```yaml
-persona_overrides:
-  communication_style: "More detailed, include architecture diagrams"
-  additional_principles:
-    - "Always consider serverless-first"
-```
-
-### Adding a Custom Skill to a Developer
-
-`flutter-dev.customize.yaml`:
-
-```yaml
-skill_additions:
-  - name: "aws-patterns"
-    path: "{project-root}/custom/skills/aws-patterns.md"
-```
-
-This gives Freya (flutter-dev) access to a custom `aws-patterns` skill. The `path` points to a file in the user-owned `custom/skills/` directory, which survives framework updates.
-
-### Full Skill Override
-
-Replace the entire `git-workflow` skill with a custom version for all dev agents:
-
-`all-dev.customize.yaml`:
-
-```yaml
-skill_overrides:
-  git-workflow:
-    source: "{project-root}/custom/skills/git-workflow.md"
-```
-
-When any dev agent loads `git-workflow`, it reads from the custom path instead of `_gaia/dev/skills/git-workflow.md`. The custom file must use the same `<!-- SECTION: name -->` delimiter format as framework skills.
-
-A relative path (no `{project-root}` prefix) is resolved against `custom_skills_path` from `dev/config.yaml`:
-
-```yaml
-skill_overrides:
-  git-workflow:
-    source: "git-workflow.md"  # resolves to {project-root}/custom/skills/git-workflow.md
-```
-
-### Section Override
-
-Replace only the `branching` and `commits` sections of `git-workflow`, keeping `pull-requests` and `conflict-resolution` from the default:
-
-`all-dev.customize.yaml`:
-
-```yaml
-skill_section_overrides:
-  git-workflow:
-    branching: "{project-root}/custom/skills/git-branching.md"
-    commits: "{project-root}/custom/skills/git-commits.md"
-```
-
-Relative paths also resolve against `custom_skills_path`.
-
-### Override for One Agent Only
-
-Give Hugo (java-dev) a different database-design skill while all other devs keep the default:
-
-`java-dev.customize.yaml`:
-
-```yaml
-skill_overrides:
-  database-design:
-    source: "{project-root}/custom/skills/database-design-postgres.md"
-```
-
-## Override Resolution Order
-
-When the engine JIT-loads a skill or skill section, it checks in this order:
-
-1. Active agent's `{agent-id}.customize.yaml` — `skill_overrides` then `skill_section_overrides`
-2. `all-dev.customize.yaml` (for dev agents only) — same check
-3. Default path from `<skill-registry>` in `_base-dev.md`
-
-When loading from an override path, the engine scans the file for `<!-- SECTION: xxx -->` markers dynamically instead of using `_skill-index.yaml` cached line ranges.
-
-## Custom Skills Directory
-
-Custom skill files should be placed in `custom/skills/` at the project root (outside `_gaia/`). This directory:
-
-- Survives framework updates (`gaia-install.sh update` only touches `_gaia/` contents)
-- Should be committed to version control
-- Files must use the same `<!-- SECTION: name -->` delimiter format as framework skills
-- Is referenced by `custom_skills_path` in `_gaia/dev/config.yaml`

package/_gaia/_config/files-manifest.csv

@@ -1,30 +0,0 @@
-path,type,module,description
-"_gaia/_config/global.yaml","config","core","Global framework configuration"
-"_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"
-"_gaia/creative/config.yaml","config","creative","Creative module configuration"
-"_gaia/testing/config.yaml","config","testing","Testing module configuration"
-"_gaia/core/engine/workflow.xml","engine","core","Workflow execution engine"
-"_gaia/core/engine/protocols/discover-inputs.xml","protocol","core","Input file discovery protocol"
-"_gaia/core/engine/protocols/preflight-check.xml","protocol","core","Pre-execution validation protocol"
-"_gaia/core/engine/protocols/handoff.xml","protocol","core","Workflow handoff protocol"
-"_gaia/core/engine/error-recovery.xml","engine","core","Error recovery handlers"
-"_gaia/core/agents/orchestrator.md","agent","core","Master orchestrator agent"
-"_gaia/core/tasks/help.md","task","core","Context-sensitive help routing"
-"_gaia/core/tasks/index-docs.xml","task","core","Document index generator"
-"_gaia/core/tasks/shard-doc.xml","task","core","Document sharding task"
-"_gaia/core/tasks/editorial-review-prose.xml","task","core","Prose editorial review"
-"_gaia/core/tasks/editorial-review-structure.xml","task","core","Structural editorial review"
-"_gaia/core/tasks/review-adversarial.xml","task","core","Adversarial review task"
-"_gaia/core/tasks/review-edge-case-hunter.xml","task","core","Edge case hunter task"
-"_gaia/core/tasks/review-security.xml","task","core","OWASP-focused security review"
-"_gaia/core/tasks/review-api-design.xml","task","core","REST API design review"
-"_gaia/core/tasks/review-dependency-audit.xml","task","core","Dependency vulnerability audit"
-"_gaia/core/tasks/review-accessibility.xml","task","core","WCAG 2.1 accessibility review"
-"_gaia/core/tasks/review-performance.xml","task","core","Performance issue review"
-"_gaia/core/tasks/merge-docs.xml","task","core","Merge multiple markdown files"
-"_gaia/core/tasks/generate-changelog.xml","task","core","Generate changelog from git history"
-"_gaia/core/tasks/summarize-doc.xml","task","core","Generate executive summary"
-"_gaia/core/tasks/validate-framework.xml","task","core","Framework self-validation"
-"_gaia/core/engine/task-runner.xml","engine","core","Task execution engine"

package/_gaia/_config/gaia-help.csv

@@ -1,82 +0,0 @@
-module,phase,name,code,command,required,agent-name,description,output-location
-"core","anytime","help","help","gaia-help","false","orchestrator","Context-sensitive help and routing","n/a"
-"core","anytime","resume","resume","gaia-resume","false","orchestrator","Resume from last checkpoint","n/a"
-"core","anytime","build-configs","build-configs","gaia-build-configs","false","orchestrator","Regenerate resolved configs","n/a"
-"core","anytime","brainstorming","brainstorming","gaia-brainstorming","false","orchestrator","Facilitated brainstorming session","docs/creative-artifacts"
-"core","anytime","party-mode","party-mode","gaia-party","false","orchestrator","Multi-agent group discussion","n/a"
-"lifecycle","1-analysis","advanced-elicitation","advanced-elicitation","gaia-advanced-elicitation","false","orchestrator","Deep requirements elicitation","docs/planning-artifacts"
-"lifecycle","1-analysis","brainstorm-project","brainstorm","gaia-brainstorm","false","analyst","Brainstorm a new project idea","docs/planning-artifacts"
-"lifecycle","1-analysis","market-research","market-research","gaia-market-research","false","analyst","Conduct market research","docs/planning-artifacts"
-"lifecycle","1-analysis","domain-research","domain-research","gaia-domain-research","false","analyst","Research a domain or industry","docs/planning-artifacts"
-"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","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","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"
-"lifecycle","4-implementation","sprint-planning","sprint-plan","gaia-sprint-plan","true","sm","Plan sprint from epics and stories","docs/implementation-artifacts"
-"lifecycle","4-implementation","sprint-status","sprint-status","gaia-sprint-status","false","sm","Show current sprint status","docs/implementation-artifacts"
-"lifecycle","4-implementation","create-story","create-story","gaia-create-story","false","sm","Create detailed story file","docs/implementation-artifacts"
-"lifecycle","4-implementation","validate-story","validate-story","gaia-validate-story","false","validator","Full story validation with factual verification","docs/implementation-artifacts"
-"lifecycle","4-implementation","dev-story","dev-story","gaia-dev-story","false","dev-*","Implement a user story","docs/implementation-artifacts"
-"lifecycle","4-implementation","code-review","code-review","gaia-code-review","false","dev-*","Perform code review","docs/implementation-artifacts"
-"lifecycle","4-implementation","qa-generate-tests","qa-tests","gaia-qa-tests","false","qa","Generate automated QA tests","docs/test-artifacts"
-"lifecycle","4-implementation","retrospective","retro","gaia-retro","false","sm","Post-sprint retrospective","docs/implementation-artifacts"
-"lifecycle","4-implementation","correct-course","correct-course","gaia-correct-course","false","sm","Manage sprint scope changes","docs/implementation-artifacts"
-"lifecycle","anytime","document-project","document-project","gaia-document-project","false","analyst","Document project for AI context","docs/planning-artifacts"
-"lifecycle","anytime","generate-project-context","project-context","gaia-project-context","false","analyst","Generate project context for AI","docs/planning-artifacts"
-"lifecycle","anytime","brownfield-onboarding","brownfield","gaia-brownfield","false","orchestrator","Onboard existing project to GAIA","docs/planning-artifacts"
-"lifecycle","quick-flow","quick-spec","quick-spec","gaia-quick-spec","false","dev-*","Create a quick tech spec","docs/implementation-artifacts"
-"lifecycle","quick-flow","quick-dev","quick-dev","gaia-quick-dev","false","dev-*","Implement a quick spec","docs/implementation-artifacts"
-"core","anytime","editorial-review-prose","editorial-prose","gaia-editorial-prose","false","tech-writer","Clinical copy-editing review","n/a"
-"core","anytime","editorial-review-structure","editorial-structure","gaia-editorial-structure","false","tech-writer","Structural editing review","n/a"
-"core","anytime","review-adversarial","adversarial","gaia-adversarial","false","orchestrator","Cynical adversarial review","n/a"
-"core","anytime","review-edge-case-hunter","edge-cases","gaia-edge-cases","false","orchestrator","Edge case analysis","n/a"
-"core","anytime","shard-doc","shard-doc","gaia-shard-doc","false","tech-writer","Split large doc into sections","n/a"
-"core","anytime","index-docs","index-docs","gaia-index-docs","false","tech-writer","Generate doc index for folder","n/a"
-"creative","anytime","design-thinking","design-thinking","gaia-design-thinking","false","design-thinking-coach","Guide human-centered design process","docs/creative-artifacts"
-"creative","anytime","innovation-strategy","innovation","gaia-innovation","false","innovation-strategist","Identify disruption opportunities","docs/creative-artifacts"
-"creative","anytime","problem-solving","problem-solving","gaia-problem-solving","false","problem-solver","Apply systematic problem-solving","docs/creative-artifacts"
-"creative","anytime","storytelling","storytelling","gaia-storytelling","false","storyteller","Craft compelling narratives","docs/creative-artifacts"
-"testing","anytime","teach-me-testing","teach-testing","gaia-teach-testing","false","test-architect","Teach testing progressively","n/a"
-"testing","anytime","test-design","test-design","gaia-test-design","false","test-architect","Create risk-based test plans","docs/test-artifacts"
-"testing","anytime","test-framework","test-framework","gaia-test-framework","false","test-architect","Initialize test framework","docs/test-artifacts"
-"testing","anytime","ci-setup","ci-setup","gaia-ci-setup","false","test-architect","Scaffold CI/CD quality pipeline","docs/test-artifacts"
-"testing","anytime","atdd","atdd","gaia-atdd","false","test-architect","Generate failing acceptance tests","docs/test-artifacts"
-"testing","anytime","test-automation","test-automate","gaia-test-automate","false","test-architect","Expand automated test coverage","docs/test-artifacts"
-"testing","anytime","test-review","test-review","gaia-test-review","false","test-architect","Review test quality","docs/test-artifacts"
-"testing","anytime","nfr-assessment","nfr","gaia-nfr","false","test-architect","Assess non-functional requirements","docs/test-artifacts"
-"testing","anytime","traceability","trace","gaia-trace","false","test-architect","Generate traceability matrix","docs/test-artifacts"
-"lifecycle","3-solutioning","security-threat-model","threat-model","gaia-threat-model","false","security","Create STRIDE/DREAD threat model","docs/planning-artifacts"
-"lifecycle","4-implementation","security-review","security-review","gaia-security-review","false","security","Pre-merge OWASP security review","docs/implementation-artifacts"
-"lifecycle","3-solutioning","infrastructure-design","infra-design","gaia-infra-design","false","devops","Design deployment topology and IaC","docs/planning-artifacts"
-"lifecycle","5-deployment","deployment-checklist","deploy-checklist","gaia-deploy-checklist","false","devops","Pre-deployment verification checklist","docs/implementation-artifacts"
-"lifecycle","5-deployment","release-plan","release-plan","gaia-release-plan","false","devops","Staged rollout and release strategy","docs/implementation-artifacts"
-"lifecycle","5-deployment","post-deploy-verify","post-deploy","gaia-post-deploy","false","devops","Post-deployment health validation","docs/implementation-artifacts"
-"lifecycle","5-deployment","rollback-plan","rollback-plan","gaia-rollback-plan","false","devops","Rollback trigger criteria and procedures","docs/implementation-artifacts"
-"lifecycle","anytime","performance-review","performance-review","gaia-performance-review","false","performance","Analyze performance bottlenecks","docs/test-artifacts"
-"creative","anytime","slide-deck","slide-deck","gaia-slide-deck","false","presentation-designer","Create presentation slide deck","docs/creative-artifacts"
-"creative","anytime","pitch-deck","pitch-deck","gaia-pitch-deck","false","presentation-designer","Create investor/partner pitch deck","docs/creative-artifacts"
-"core","anytime","review-security","review-security","gaia-review-security","false","security","OWASP-focused security review task","n/a"
-"core","anytime","review-api-design","review-api","gaia-review-api","false","orchestrator","Review REST API design","n/a"
-"core","anytime","review-dependency-audit","review-deps","gaia-review-deps","false","orchestrator","Audit project dependencies","n/a"
-"core","anytime","review-accessibility","review-a11y","gaia-review-a11y","false","orchestrator","Review for WCAG 2.1 compliance","n/a"
-"core","anytime","review-performance","review-perf","gaia-review-perf","false","orchestrator","Review code for performance issues","n/a"
-"core","anytime","merge-docs","merge-docs","gaia-merge-docs","false","tech-writer","Merge multiple markdown files","n/a"
-"core","anytime","generate-changelog","changelog","gaia-changelog","false","orchestrator","Generate changelog from git history","n/a"
-"core","anytime","summarize-doc","summarize","gaia-summarize","false","orchestrator","Generate executive summary of a document","n/a"
-"testing","anytime","accessibility-testing","a11y-testing","gaia-a11y-testing","false","test-architect","Create accessibility test plan for WCAG compliance","docs/test-artifacts"
-"testing","anytime","performance-testing","perf-testing","gaia-perf-testing","false","test-architect","Create performance test plan with load testing","docs/test-artifacts"
-"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","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"

package/_gaia/_config/global.yaml

@@ -1,45 +0,0 @@
-# GAIA Framework — Global Configuration
-# Single source of truth for all shared settings.
-# After modifying this file, run /gaia-build-configs to regenerate resolved configs.
-
-framework_name: "GAIA"
-framework_version: "1.57.0"
-
-# User settings
-user_name: "jlouage"
-communication_language: "English"
-document_output_language: "English"
-user_skill_level: "intermediate"  # beginner | intermediate | expert
-
-# Project settings
-project_name: "GAIA-Framework"
-project_root: "{project-root}"
-# Project path — relative directory within the root where application source code lives.
-# Use "." (default) if the project code lives at the root alongside _gaia/.
-# Use a folder name (e.g., "app", "project", "my-app") if the code lives in a subdirectory.
-# The resolved {project-path} variable expands to the full absolute path.
-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
-
-# Output paths
-output_folder: "{project-root}/docs"
-planning_artifacts: "{project-root}/docs/planning-artifacts"
-implementation_artifacts: "{project-root}/docs/implementation-artifacts"
-test_artifacts: "{project-root}/docs/test-artifacts"
-creative_artifacts: "{project-root}/docs/creative-artifacts"
-
-# Story sizing — canonical T-shirt-to-points mapping (Fibonacci scale)
-sizing_map:
-  S: 2
-  M: 5
-  L: 8
-  XL: 13
-
-# Framework paths
-installed_path: "{project-root}/_gaia"
-config_path: "{project-root}/_gaia/_config"
-memory_path: "{project-root}/_memory"
-checkpoint_path: "{project-root}/_memory/checkpoints"