gaia-framework 1.57.0 → 1.57.2

package/_gaia/lifecycle/templates/deployment-template.md

@@ -1,52 +0,0 @@
----
-template: 'deployment'
-version: 1.0.0
-used_by: ['deployment-checklist']
----
-
-# Deployment Plan: {release_name}
-
-> **Project:** {project_name}
-> **Date:** {date}
-> **Author:** {agent_name}
-> **Target Environment:** {environment}
-
-## Release Summary
-
-{What is being deployed and key changes included.}
-
-## Pre-Deployment Checklist
-
-- [ ] All tests passing in CI
-- [ ] Code reviewed and approved
-- [ ] Database migrations tested
-- [ ] Environment variables configured
-- [ ] Rollback plan documented
-
-## Deployment Steps
-
-1. {Step 1 — e.g., enable maintenance mode}
-2. {Step 2 — e.g., run database migrations}
-3. {Step 3 — e.g., deploy application}
-4. {Step 4 — e.g., run smoke tests}
-5. {Step 5 — e.g., disable maintenance mode}
-
-## Post-Deployment Verification
-
-| Check | Expected | Actual |
-|-------|----------|--------|
-| Health endpoint | 200 OK | {result} |
-| Key metric | {baseline} | {result} |
-
-## Rollback Plan
-
-**Trigger criteria:** {When to roll back}
-
-1. {Rollback step 1}
-2. {Rollback step 2}
-
-## Communication
-
-| Audience | When | Channel | Message |
-|----------|------|---------|---------|
-| {team} | {timing} | {channel} | {message} |

package/_gaia/lifecycle/templates/epic-status-template.md

@@ -1,64 +0,0 @@
----
-template: 'epic-status'
-version: 1.0.0
-used_by: ['epic-status']
----
-
-# Epic Status Dashboard
-
-> **Project:** {project_name}
-> **Date:** {date}
-> **Sprint Coverage:** all sprints
-
----
-
-## Summary
-
-| # | Epic | Stories | Done | In Progress | Remaining | Completion |
-|---|------|---------|------|-------------|-----------|------------|
-{epic_summary_rows}
-
-**Overall: {total_done}/{total_stories} stories done ({overall_percent}%)**
-
----
-
-## Epic Details
-
-{per_epic_details}
-
-### Epic {epic_number}: {epic_title}
-
-**Goal:** {epic_goal}
-
-**Progress:** `[{progress_bar}]` {done_count}/{story_count} ({percent}%) {complete_tag}
-
-| Story | Title | Status | Sprint |
-|-------|-------|--------|--------|
-{story_rows}
-
-**Done criteria:** {done_criteria}
-
----
-
-## Untracked Stories
-
-Stories listed in epics-and-stories.md with no `.md` file found (assumed `backlog`):
-
-| Story | Epic | Assumed Status |
-|-------|------|----------------|
-{untracked_rows}
-
----
-
-## Legend
-
-| Status | Description |
-|--------|-------------|
-| `backlog` | Not yet started, no story file or story file with backlog status |
-| `validating` | Story created, awaiting validation before development |
-| `ready-for-dev` | Story validated and ready for development |
-| `in-progress` | Currently being worked on |
-| `invalid` | Story no longer needed for implementation |
-| `review` | Implementation complete, awaiting review |
-| `done` | Accepted and complete |
-| `[COMPLETE]` | All stories in the epic are done |

package/_gaia/lifecycle/templates/event-catalog-template.md

@@ -1,78 +0,0 @@
----
-template: 'event-catalog'
-version: 1.0.0
-used_by: ['brownfield-onboarding']
----
-
-# Event & Messaging Catalog: {product_name}
-
-> **Project:** {project_name}
-> **Date:** {date}
-> **Author:** {agent_name}
-> **Mode:** Brownfield — discovered from codebase scan
-
-## 1. Messaging Infrastructure
-
-| Aspect | Detail |
-|--------|--------|
-| Messaging system(s) | {Kafka / RabbitMQ / SNS-SQS / Redis Pub-Sub / NATS / Other} |
-| Client library | {library name and version} |
-| Configuration location | {path to config files} |
-| Connection management | {connection pooling, retry config} |
-| Serialization format | {JSON / Avro / Protobuf / Other} |
-
-## 2. Produced Events
-
-| Event Name | Topic/Queue | Schema | Trigger | Publisher Module |
-|------------|-------------|--------|---------|-----------------|
-| {event_name} | {topic} | {schema_ref_or_inline} | {what triggers it} | {module/service} |
-
-## 3. Consumed Events
-
-| Event Name | Topic/Queue | Handler | Error Handling | Consumer Module |
-|------------|-------------|---------|----------------|-----------------|
-| {event_name} | {topic} | {handler_function} | {retry/DLQ/ignore} | {module/service} |
-
-## 4. External Events
-
-| Event Name | Source Service | Topic/Queue | Direction | Schema |
-|------------|---------------|-------------|-----------|--------|
-| {event_name} | {service_name} | {topic} | {Consumed / Produced} | {schema_ref} |
-
-## 5. Delivery Guarantees & Configuration
-
-| Aspect | Configuration |
-|--------|--------------|
-| Delivery guarantee | {At-least-once / At-most-once / Exactly-once} |
-| Retry policy | {max retries, backoff strategy} |
-| Dead letter queue | {Yes — DLQ name / No} |
-| Idempotency handling | {Yes — mechanism / No} |
-| Message ordering | {Guaranteed / Best-effort / N/A} |
-| Consumer groups | {group names and purpose} |
-
-## 6. Event Flow Diagrams
-
-```mermaid
-flowchart LR
-    subgraph Producers
-        {producer_1}["{Producer 1}"]
-        {producer_2}["{Producer 2}"]
-    end
-
-    subgraph Messaging
-        {topic_1}[("{Topic 1}")]
-        {topic_2}[("{Topic 2}")]
-    end
-
-    subgraph Consumers
-        {consumer_1}["{Consumer 1}"]
-        {consumer_2}["{Consumer 2}"]
-    end
-
-    {producer_1} --> {topic_1}
-    {producer_2} --> {topic_2}
-    {topic_1} --> {consumer_1}
-    {topic_2} --> {consumer_2}
-```
-
-{Add sequence diagrams for 2-3 key event-driven flows.}

package/_gaia/lifecycle/templates/nfr-assessment-template.md

@@ -1,96 +0,0 @@
----
-template: 'nfr-assessment'
-version: 1.0.0
-used_by: ['brownfield-onboarding']
----
-
-# Non-Functional Requirements Assessment: {product_name}
-
-> **Project:** {project_name}
-> **Date:** {date}
-> **Author:** {agent_name}
-> **Mode:** Brownfield — baselines measured from codebase
-
-## 1. Code Quality Baselines
-
-| Metric | Current State | Tool/Source |
-|--------|--------------|-------------|
-| Linting | {ESLint / Pylint / etc. — config found / not found} | {config path} |
-| Lint violations | {count or N/A} | {tool output} |
-| Complexity hotspots | {list of files with high cyclomatic complexity} | {analysis} |
-| Duplication | {estimated % or specific duplicated patterns} | {analysis} |
-| Code style | {Prettier / Black / etc. — enforced / not enforced} | {config path} |
-
-## 2. Security Posture
-
-| Aspect | Current State | Risk Level |
-|--------|--------------|------------|
-| Dependency vulnerabilities | {X known CVEs / 0 / Not scanned} | {High / Medium / Low} |
-| Secrets handling | {env vars / vault / hardcoded — details} | {High / Medium / Low} |
-| Authentication quality | {mechanism and strength assessment} | {High / Medium / Low} |
-| Authorization model | {RBAC / ABAC / none — details} | {High / Medium / Low} |
-| Input validation | {consistent / partial / missing} | {High / Medium / Low} |
-| HTTPS/TLS | {enforced / optional / missing} | {High / Medium / Low} |
-
-## 3. Performance Baselines
-
-| Metric | Current State | Notes |
-|--------|--------------|-------|
-| Bundle size (if frontend) | {size or N/A} | {tree-shaking, code splitting status} |
-| Query patterns | {ORM usage, N+1 risks, raw queries} | {specific concerns} |
-| Caching strategy | {what's cached, TTL, invalidation} | {gaps identified} |
-| Response time indicators | {any benchmarks or load tests found} | {details} |
-| Memory/resource patterns | {connection pooling, cleanup, leaks} | {details} |
-
-## 4. Accessibility Status
-
-| Aspect | Current State | Compliance Level |
-|--------|--------------|-----------------|
-| ARIA attributes | {present / partial / missing} | {WCAG A / AA / AAA / Non-compliant} |
-| Semantic HTML | {used consistently / partially / not used} | {details} |
-| Keyboard navigation | {supported / partial / not supported} | {details} |
-| Screen reader support | {tested / untested} | {details} |
-| Color contrast | {meets standards / unknown} | {details} |
-| a11y testing tools | {configured / not configured} | {tool names} |
-
-## 5. Test Coverage Baselines
-
-| Metric | Current State | Notes |
-|--------|--------------|-------|
-| Test framework | {Jest / pytest / JUnit / etc.} | {config path} |
-| Test count | {X unit / Y integration / Z e2e} | {details} |
-| Coverage % | {line / branch / function coverage} | {coverage report path} |
-| Untested areas | {list of modules/features with no tests} | {risk assessment} |
-| Test quality patterns | {assertions per test, fixture usage, mocking approach} | {details} |
-| CI test execution | {runs on PR / runs on push / not automated} | {CI config path} |
-
-## 6. CI/CD Assessment
-
-| Aspect | Current State | Notes |
-|--------|--------------|-------|
-| CI platform | {GitHub Actions / Jenkins / CircleCI / etc.} | {config path} |
-| Build pipeline | {steps: lint, test, build, deploy} | {details} |
-| Deploy strategy | {manual / CD / blue-green / canary} | {details} |
-| Environment management | {dev / staging / prod — how managed} | {details} |
-| Infrastructure as code | {Terraform / CloudFormation / Docker / none} | {details} |
-
-## 7. Migration & Coexistence (Brownfield Only)
-
-| Aspect | Current State | Target | Risk Level |
-|--------|--------------|--------|------------|
-| Data migration performance | {volume, estimated migration time, downtime budget} | {target window} | {High / Medium / Low} |
-| Backward compatibility | {API versioning, schema compatibility, client impact} | {zero breaking changes / managed deprecation} | {High / Medium / Low} |
-| Dual-write latency | {if dual-write strategy: measured overhead, consistency lag} | {max acceptable lag} | {High / Medium / Low / N/A} |
-| Legacy API parity | {response time of legacy endpoints vs. new replacements} | {equal or better} | {High / Medium / Low} |
-| Session continuity | {user session handling during cutover: sticky sessions, token migration} | {zero session loss} | {High / Medium / Low} |
-
-## 8. NFR Baseline Summary
-
-| Category | Current Baseline | Recommended Target | Gap Severity |
-|----------|-----------------|-------------------|-------------|
-| Code Quality | {summary} | {target} | {High / Medium / Low / None} |
-| Security | {summary} | {target} | {High / Medium / Low / None} |
-| Performance | {summary} | {target} | {High / Medium / Low / None} |
-| Accessibility | {summary} | {target} | {High / Medium / Low / None} |
-| Test Coverage | {summary} | {target} | {High / Medium / Low / None} |
-| CI/CD | {summary} | {target} | {High / Medium / Low / None} |

package/_gaia/lifecycle/templates/prd-template.md

@@ -1,83 +0,0 @@
----
-template: 'prd'
-version: 1.0.0
-used_by: ['create-prd']
----
-
-# Product Requirements Document: {product_name}
-
-> **Project:** {project_name}
-> **Date:** {date}
-> **Author:** {agent_name}
-> **Status:** Draft | In Review | Approved
-
-## 1. Overview
-
-{Brief product overview and context. What is being built and why.}
-
-## 2. Goals and Non-Goals
-
-### Goals
-- {Goal 1}
-- {Goal 2}
-
-### Non-Goals
-- {Explicitly out of scope item 1}
-
-## 3. User Stories
-
-| ID | As a... | I want to... | So that... | Priority |
-|----|---------|-------------|-----------|----------|
-| US-01 | {role} | {action} | {benefit} | {P0-P3} |
-
-## 4. Functional Requirements
-
-### 4.1 {Feature Area}
-
-- **FR-01:** {Requirement description}
-- **FR-02:** {Requirement description}
-
-## 5. Non-Functional Requirements
-
-| ID | Category | Requirement | Target |
-|----|----------|------------|--------|
-| NFR-001 | Performance | {requirement} | {target} |
-| NFR-002 | Security | {requirement} | {target} |
-| NFR-003 | Accessibility | {requirement} | {target} |
-
-## 6. Out of Scope
-
-| Exclusion | Reason |
-|-----------|--------|
-| {feature or integration} | {deferred / not needed / separate product} |
-
-## 7. UX Requirements
-
-{Key interaction patterns, wireframe references, accessibility needs.}
-
-## 8. Technical Constraints
-
-- {Platform, language, or integration constraint}
-
-## 9. Dependencies
-
-| Dependency | Type | Failure Mode | Fallback Behavior | SLA Expectation |
-|------------|------|-------------|-------------------|-----------------|
-| {service or system} | {API / Database / Message Queue / CDN / Auth Provider} | {What happens when it's unavailable} | {Graceful degradation / Retry / Queue / Circuit breaker / Hard fail} | {Expected uptime / latency / throughput} |
-
-## 10. Milestones
-
-| Milestone | Target Date | Deliverables |
-|-----------|------------|-------------|
-| {milestone} | {date} | {deliverables} |
-
-## 11. Requirements Summary
-
-| ID | Description | Priority | Status |
-|----|------------|----------|--------|
-| FR-001 | {description} | {Must-Have/Should-Have/Nice-to-Have} | {Draft/Approved} |
-| NFR-001 | {description} | {Must-Have/Should-Have/Nice-to-Have} | {Draft/Approved} |
-
-## 12. Open Questions
-
-- [ ] {Unresolved question}

package/_gaia/lifecycle/templates/product-brief-template.md

@@ -1,48 +0,0 @@
----
-template: 'product-brief'
-version: 1.0.0
-used_by: ['create-product-brief']
----
-
-# Product Brief: {product_name}
-
-> **Project:** {project_name}
-> **Date:** {date}
-> **Author:** {agent_name}
-
-## Vision
-
-{One-sentence vision statement for what this product achieves.}
-
-## Problem Statement
-
-{What user problem does this solve? Who experiences it? How severe is it?}
-
-## Target Users
-
-{Primary and secondary user personas. Key demographics, behaviors, needs.}
-
-## Proposed Solution
-
-{High-level description of the product approach. What does it do?}
-
-## Key Features
-
-1. {Feature 1 — brief description}
-2. {Feature 2 — brief description}
-3. {Feature 3 — brief description}
-
-## Success Metrics
-
-| Metric | Target | Measurement |
-|--------|--------|-------------|
-| {metric} | {target} | {how measured} |
-
-## Constraints and Assumptions
-
-- {Constraint or assumption 1}
-- {Constraint or assumption 2}
-
-## Open Questions
-
-- [ ] {Question needing resolution}

package/_gaia/lifecycle/templates/review-template.md

@@ -1,47 +0,0 @@
----
-template: 'review'
-version: 1.0.0
-used_by: ['code-review']
----
-
-# Code Review: {review_subject}
-
-> **Project:** {project_name}
-> **Date:** {date}
-> **Reviewer:** {agent_name}
-
-## Summary
-
-{Brief summary of what was reviewed and overall assessment.}
-
-## Files Reviewed
-
-| File | Lines | Changes |
-|------|-------|---------|
-| {path} | {count} | {description} |
-
-## Findings
-
-### Critical
-
-{Issues that must be fixed before merge.}
-
-### Warnings
-
-{Issues that should be addressed but are not blocking.}
-
-### Suggestions
-
-{Optional improvements for consideration.}
-
-## Checklist
-
-- [ ] Correctness: Logic is sound
-- [ ] Security: No OWASP top 10 vulnerabilities
-- [ ] Performance: No obvious bottlenecks
-- [ ] Readability: Code is clear and well-named
-- [ ] Tests: Adequate coverage for changes
-
-## Verdict
-
-{APPROVE | REQUEST_CHANGES | COMMENT}

package/_gaia/lifecycle/templates/sprint-plan-template.md

@@ -1,45 +0,0 @@
----
-template: 'sprint-plan'
-version: 1.0.0
-used_by: ['sprint-planning']
----
-
-# Sprint Plan: Sprint {sprint_number}
-
-> **Project:** {project_name}
-> **Date:** {date}
-> **Author:** {agent_name}
-> **Duration:** {start_date} to {end_date}
-
-## Sprint Goal
-
-{One-sentence sprint goal describing the key outcome.}
-
-## Committed Stories
-
-| ID | Story | Points | Assignee | Status |
-|----|-------|--------|----------|--------|
-| {id} | {title} | {pts} | {agent} | pending |
-
-## Capacity
-
-| Agent | Available | Allocated | Remaining |
-|-------|-----------|-----------|-----------|
-| {agent} | {points} | {points} | {points} |
-
-## Total Commitment
-
-- **Stories:** {count}
-- **Points:** {total}
-- **Velocity (avg):** {velocity}
-
-## Risks and Dependencies
-
-- {Risk or dependency that could impact the sprint}
-
-## Definition of Done
-
-- [ ] All acceptance criteria met
-- [ ] Tests passing
-- [ ] Code reviewed
-- [ ] Documentation updated

package/_gaia/lifecycle/templates/story-template.md

@@ -1,118 +0,0 @@
----
-template: 'story'
-version: 1.2.0
-used_by: ['create-story']
-key: "{story_key}"
-title: "{story_title}"
-epic: "{epic_key}"
-status: backlog
-priority: "{P0/P1/P2}"
-size: "{S/M/L/XL}"
-points: "{story_points}"
-risk: "{high/medium/low}"
-sprint_id: null
-depends_on: []
-blocks: []
-traces_to: []
-date: "{creation_date}"
-author: "{agent_name}"
----
-
-# Story: {story_title}
-
-> **Epic:** {epic_key}
-> **Priority:** {P0/P1/P2}
-> **Status:** backlog
-> **Date:** {creation_date}
-> **Author:** {agent_name}
-
-## User Story
-
-As a {role}, I want to {action}, so that {benefit}.
-
-## Acceptance Criteria
-
-- [ ] Given {context}, when {action}, then {expected result}
-- [ ] Given {context}, when {action}, then {expected result}
-
-## Tasks / Subtasks
-
-- [ ] Task 1 (AC: #)
-  - [ ] Subtask 1.1
-- [ ] Task 2 (AC: #)
-  - [ ] Subtask 2.1
-
-## Dev Notes
-
-- Relevant architecture patterns and constraints
-- Source tree components to touch
-- Testing standards summary
-
-## Technical Notes
-
-{Implementation guidance, architecture constraints, relevant patterns.}
-
-## Dependencies
-
-- {Dependency on other story or system}
-
-## Test Scenarios
-
-| # | Scenario | Input | Expected |
-|---|----------|-------|----------|
-| 1 | {happy path} | {input} | {output} |
-| 2 | {edge case} | {input} | {output} |
-
-### Project Structure Notes
-
-- Alignment with unified project structure (paths, modules, naming)
-- Detected conflicts or variances (with rationale)
-
-### References
-
-- Cite all technical details with source paths and sections, e.g. [Source: docs/<file>.md#Section]
-
-## Dev Agent Record
-
-### Agent Model Used
-
-{agent_model_name_version}
-
-### Debug Log References
-
-### Completion Notes List
-
-### File List
-
-## Findings
-
-> Out-of-scope issues discovered during implementation. Each finding becomes a candidate for a backlog story.
-
-| # | Type | Severity | Finding | Suggested Action |
-|---|------|----------|---------|-----------------|
-| — | — | — | — | — |
-
-> **Types:** bug, tech-debt, enhancement, missing-setup, documentation
-> **Severity:** critical, high, medium, low
-
-## Review Gate
-
-| Review | Status | Report |
-|--------|--------|--------|
-| Code Review | PENDING | — |
-| QA Tests | PENDING | — |
-| Security Review | PENDING | — |
-| Test Automation | PENDING | — |
-| Test Review | PENDING | — |
-| Performance Review | PENDING | — |
-
-> Story moves to `done` only when ALL reviews show PASSED.
-
-## Estimate
-
-- **Points:** {story points}
-- **Developer:** {assigned agent}
-
-## Definition of Done
-
-- [ ] Define all the Definition of Done

package/_gaia/lifecycle/templates/tech-debt-dashboard-template.md

@@ -1,71 +0,0 @@
----
-template: 'tech-debt-dashboard'
-version: 1.0.0
-used_by: ['tech-debt-review']
----
-
-# Tech Debt Dashboard
-
-> **Project:** {project_name}
-> **Date:** {date}
-> **Sprint:** {sprint_id}
-
----
-
-## Summary
-
-| Metric | Value |
-|--------|-------|
-| Total debt items | {total_count} |
-| FIX NOW | {fix_now_count} |
-| PLAN NEXT | {plan_next_count} |
-| TRACK | {track_count} |
-| Overdue (SLA breach) | {overdue_count} |
-| Debt ratio (debt / total backlog) | {debt_ratio}% |
-
-## By Category
-
-| Category | Count | Oldest (sprints) |
-|----------|-------|------------------|
-| Design | {design_count} | {design_oldest} |
-| Code | {code_count} | {code_oldest} |
-| Test | {test_count} | {test_oldest} |
-| Infrastructure | {infra_count} | {infra_oldest} |
-
-## Aging Distribution
-
-```
-{aging_histogram}
-```
-
-## Top 10 Debt Items
-
-| # | Item | Category | Impact | Effort | Risk | Score | Age | Priority | Source | Action |
-|---|------|----------|--------|--------|------|-------|-----|----------|--------|--------|
-{top_items_rows}
-
-**Scoring:** Score = Impact (1-5) + Risk of Inaction (1-5) - Effort (1-5). Higher = fix sooner.
-
-## Overdue Alerts
-
-{overdue_alerts}
-
-**SLA thresholds:** FIX NOW > 1 sprint = OVERDUE | PLAN NEXT > 3 sprints = escalate | TRACK > 5 sprints = review relevance
-
-## Trend (vs Previous Review)
-
-| Metric | Previous | Current | Delta |
-|--------|----------|---------|-------|
-| Total items | {prev_total} | {curr_total} | {delta_total} |
-| FIX NOW | {prev_fix} | {curr_fix} | {delta_fix} |
-| Resolved since last | — | {resolved_count} | — |
-| New since last | — | {new_count} | — |
-
-## Recommended Actions
-
-{recommendations}
-
----
-
-> Run `/gaia-correct-course` to inject high-priority debt items into the current sprint.
-> Run `/gaia-triage-findings` first if there are untriaged findings pending.