chati-dev 1.0.0

package/framework/schemas/session.schema.json

@@ -0,0 +1,103 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "chati.dev Session",
+  "description": "Schema for .chati/session.yaml - runtime state tracking",
+  "type": "object",
+  "required": ["project", "current_agent", "language", "execution_mode"],
+  "properties": {
+    "project": {
+      "type": "object",
+      "required": ["name", "type", "state"],
+      "properties": {
+        "name": { "type": "string", "description": "Project name" },
+        "type": { "enum": ["greenfield", "brownfield"], "description": "Project type" },
+        "state": { "enum": ["clarity", "build", "validate", "deploy", "completed"], "description": "Current pipeline macro-phase" }
+      }
+    },
+    "execution_mode": {
+      "enum": ["interactive", "autonomous"],
+      "default": "interactive",
+      "description": "interactive = agent-driven guided mode; autonomous = Ralph Wiggum mode (Dev agent)"
+    },
+    "current_agent": {
+      "type": "string",
+      "description": "Currently active agent name"
+    },
+    "language": {
+      "enum": ["en", "pt", "es", "fr"],
+      "default": "en",
+      "description": "User interaction language (artifacts always English)"
+    },
+    "ides": {
+      "type": "array",
+      "items": {
+        "enum": ["claude-code", "vscode", "antigravity", "cursor", "windsurf", "gemini-cli", "github-copilot"]
+      },
+      "description": "Configured IDEs"
+    },
+    "mcps": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Installed MCPs"
+    },
+    "user_level": {
+      "enum": ["auto", "vibecoder", "power_user"],
+      "default": "auto",
+      "description": "Detected user expertise level"
+    },
+    "user_level_confidence": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1,
+      "default": 0,
+      "description": "Progressive detection confidence (0.0 - 1.0)"
+    },
+    "agents": {
+      "type": "object",
+      "description": "Status tracking for all 12 specialized agents",
+      "patternProperties": {
+        ".*": {
+          "type": "object",
+          "required": ["status", "score", "criteria_count"],
+          "properties": {
+            "status": { "enum": ["pending", "in_progress", "completed"] },
+            "score": { "type": "number", "minimum": 0, "maximum": 100 },
+            "criteria_count": { "type": "integer", "minimum": 0 },
+            "completed_at": { "type": ["string", "null"], "format": "date-time" }
+          }
+        }
+      }
+    },
+    "backlog": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "title", "priority", "status"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^BL-\\d{3}$" },
+          "title": { "type": "string" },
+          "priority": { "enum": ["high", "medium", "low"] },
+          "status": { "enum": ["pending", "in_progress", "done", "deferred"] },
+          "source_agent": { "type": "string" },
+          "target_agent": { "type": "string" },
+          "created_at": { "type": ["string", "null"], "format": "date-time" },
+          "notes": { "type": "string" }
+        }
+      }
+    },
+    "last_handoff": { "type": "string" },
+    "deviations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "timestamp": { "type": "string", "format": "date-time" },
+          "from_agent": { "type": "string" },
+          "to_agent": { "type": "string" },
+          "reason": { "type": "string" },
+          "resolved": { "type": "boolean" }
+        }
+      }
+    }
+  }
+}

package/framework/schemas/task.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "chati.dev Task",
+  "description": "Schema for task definitions created by the Tasks agent",
+  "type": "object",
+  "required": ["id", "title", "phase", "criteria", "status"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^T\\d+\\.\\d+$",
+      "description": "Task identifier (e.g., T1.1, T2.3)"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 5,
+      "description": "Short, descriptive task title"
+    },
+    "description": {
+      "type": "string",
+      "description": "Detailed task description"
+    },
+    "phase": {
+      "type": "string",
+      "description": "Parent phase identifier (e.g., Phase 1)"
+    },
+    "priority": {
+      "enum": ["critical", "high", "medium", "low"],
+      "description": "Task priority level"
+    },
+    "size": {
+      "enum": ["XS", "S", "M", "L", "XL"],
+      "description": "Estimated effort size (XS=<1h, S=1-2h, M=2-4h, L=4-8h, XL=8h+)"
+    },
+    "criteria": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["given", "when", "then"],
+        "properties": {
+          "given": { "type": "string", "description": "Initial context/state" },
+          "when": { "type": "string", "description": "Action performed" },
+          "then": { "type": "string", "description": "Expected outcome (verifiable)" }
+        }
+      },
+      "description": "Acceptance criteria in Given-When-Then format"
+    },
+    "status": {
+      "enum": ["pending", "in_progress", "completed", "blocked"],
+      "default": "pending"
+    },
+    "dependencies": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Task IDs that must complete before this task"
+    },
+    "requirement_refs": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "PRD requirement IDs this task addresses"
+    },
+    "blocker": {
+      "type": ["string", "null"],
+      "description": "Blocker code (C01-C14, G01-G08) if status is blocked"
+    },
+    "completed_at": {
+      "type": ["string", "null"],
+      "format": "date-time"
+    }
+  }
+}

package/framework/templates/brownfield-prd-tmpl.yaml

@@ -0,0 +1,103 @@
+# PRD Template — Brownfield Projects
+# Used by: Detail Agent (brownfield flow)
+# Language: English (Constitution Article VII)
+
+template:
+  name: Brownfield Product Requirements Document
+  version: "1.0.0"
+  type: brownfield
+
+sections:
+  - id: executive_summary
+    title: "1. Executive Summary"
+    description: "Product overview including current state and proposed changes"
+    required: true
+
+  - id: current_state
+    title: "2. Current State Analysis"
+    description: "Summary of existing system from WU analysis"
+    required: true
+    subsections:
+      - "Existing Architecture"
+      - "Technical Debt Summary"
+      - "Integration Points"
+    source: wu-full-report.md
+
+  - id: goals_metrics
+    title: "3. Goals & Success Metrics"
+    description: "What changes we want to achieve, measured against current baseline"
+    required: true
+    format: table
+    columns: [Goal, Current Baseline, Target, Metric]
+
+  - id: target_users
+    title: "4. Target Users"
+    description: "Existing and new user segments affected by changes"
+    required: true
+
+  - id: scope_boundaries
+    title: "5. Scope Boundaries"
+    description: "What will change vs what stays the same"
+    required: true
+    subsections:
+      - "Changes (In Scope)"
+      - "Preserved (No Changes)"
+      - "Out of Scope"
+
+  - id: architecture_impact
+    title: "6. Architecture Impact"
+    description: "How proposed changes affect existing architecture"
+    required: true
+    source: architecture.md
+
+  - id: functional_requirements
+    title: "7. Functional Requirements"
+    description: "New and modified requirements"
+    required: true
+    categories:
+      - "New Requirements"
+      - "Modified Requirements"
+      - "Deprecated Features"
+    fields:
+      - id: "FR-XXX"
+      - type: "new | modified | deprecated"
+      - title: "Short description"
+      - description: "Detailed specification"
+      - priority: "Must Have | Should Have | Could Have | Won't Have"
+      - brief_reference: "Which Brief problem this addresses"
+      - acceptance_criteria: "Given-When-Then format"
+      - migration_notes: "How to transition from current behavior (if modified)"
+
+  - id: nonfunctional_requirements
+    title: "8. Non-Functional Requirements"
+    required: true
+
+  - id: migration_strategy
+    title: "9. Migration Strategy"
+    description: "How to transition from current state to new state"
+    required: true
+    subsections:
+      - "Data Migration"
+      - "Feature Flags"
+      - "Rollback Plan"
+      - "Backward Compatibility"
+
+  - id: risks_mitigations
+    title: "10. Risks & Mitigations"
+    required: true
+
+  - id: dependencies_constraints
+    title: "11. Dependencies & Constraints"
+    required: true
+
+  - id: traceability
+    title: "Traceability Matrix"
+    required: true
+    format: table
+    columns: [Brief Problem, PRD Requirements, Existing Code Impact]
+
+validation:
+  - "All Brief problems have corresponding requirements"
+  - "All modified requirements have migration notes"
+  - "Migration strategy includes rollback plan"
+  - "No placeholders ([TODO], [TBD])"

package/framework/templates/fullstack-architecture-tmpl.yaml

@@ -0,0 +1,101 @@
+# Architecture Template — Fullstack Projects
+# Used by: Architect Agent
+# Language: English (Constitution Article VII)
+
+template:
+  name: Fullstack Architecture Document
+  version: "1.0.0"
+  type: fullstack
+
+sections:
+  - id: overview
+    title: "1. Architecture Overview"
+    description: "High-level system description and architecture diagram"
+    required: true
+
+  - id: tech_stack
+    title: "2. Tech Stack"
+    description: "Selected technologies with version and justification"
+    required: true
+    format: table
+    columns: [Layer, Technology, Version, Justification]
+    layers:
+      - Frontend
+      - Backend
+      - Database
+      - Authentication
+      - Hosting
+      - CI/CD
+      - Testing
+
+  - id: system_components
+    title: "3. System Components"
+    description: "Component diagram with responsibilities and interactions"
+    required: true
+
+  - id: api_design
+    title: "4. API Design"
+    description: "Endpoint patterns, authentication, error handling"
+    required: true
+    subsections:
+      - "API Style (REST/GraphQL/tRPC)"
+      - "Authentication Flow"
+      - "Error Response Format"
+      - "Pagination Strategy"
+      - "Rate Limiting"
+
+  - id: data_model
+    title: "5. Data Model"
+    description: "Database schema with entities, relationships, and constraints"
+    required: true
+    subsections:
+      - "Entity-Relationship Diagram"
+      - "Table Definitions"
+      - "Indexes"
+      - "RLS Policies"
+      - "Migration Strategy"
+
+  - id: auth_model
+    title: "6. Authentication & Authorization"
+    description: "Auth model, roles, permissions, session management"
+    required: true
+
+  - id: deployment
+    title: "7. Deployment Architecture"
+    description: "Infrastructure, environments, CI/CD pipeline"
+    required: true
+    subsections:
+      - "Environments (dev, staging, production)"
+      - "Infrastructure Diagram"
+      - "CI/CD Pipeline"
+      - "Environment Variables"
+
+  - id: security
+    title: "8. Security Model"
+    description: "OWASP considerations, input validation, secrets management"
+    required: true
+
+  - id: scalability
+    title: "9. Scalability Strategy"
+    description: "Current approach and future scaling path"
+    required: true
+
+  - id: decisions
+    title: "10. Architecture Decisions"
+    description: "Record of decisions with options considered and rationale"
+    required: true
+    format: table
+    columns: [Decision, Options Considered, Chosen, Rationale]
+
+  - id: traceability
+    title: "Traceability"
+    description: "Maps PRD requirements to architecture components"
+    required: true
+    format: table
+    columns: [PRD Requirement, Architecture Component]
+
+validation:
+  - "Every PRD requirement maps to an architecture component"
+  - "Every technology choice is justified"
+  - "Security model covers OWASP Top 10"
+  - "No placeholders ([TODO], [TBD])"

package/framework/templates/prd-tmpl.yaml

@@ -0,0 +1,94 @@
+# PRD Template — Greenfield Projects
+# Used by: Detail Agent
+# Language: English (Constitution Article VII)
+
+template:
+  name: Product Requirements Document
+  version: "1.0.0"
+  type: greenfield
+
+sections:
+  - id: executive_summary
+    title: "1. Executive Summary"
+    description: "2-3 paragraphs describing the product, its purpose, and value proposition"
+    required: true
+
+  - id: goals_metrics
+    title: "2. Goals & Success Metrics"
+    description: "Measurable goals with specific metrics and targets"
+    required: true
+    format: table
+    columns: [Goal, Metric, Target, Timeline]
+
+  - id: target_users
+    title: "3. Target Users"
+    description: "User personas or segments with characteristics and primary needs"
+    required: true
+    source: brief-report.md
+
+  - id: scope_boundaries
+    title: "4. Scope Boundaries"
+    description: "Explicit in-scope and out-of-scope items"
+    required: true
+    subsections:
+      - "In Scope"
+      - "Out of Scope"
+
+  - id: architecture_overview
+    title: "5. High-Level Architecture Overview"
+    description: "System components and their relationships (high-level, not detailed)"
+    required: true
+
+  - id: functional_requirements
+    title: "6. Functional Requirements"
+    description: "Detailed requirements with ID, description, priority, and acceptance criteria"
+    required: true
+    format: structured
+    fields:
+      - id: "FR-XXX"
+      - title: "Short description"
+      - description: "Detailed specification"
+      - priority: "Must Have | Should Have | Could Have | Won't Have"
+      - brief_reference: "Which Brief problem this addresses"
+      - acceptance_criteria: "Given-When-Then format"
+
+  - id: nonfunctional_requirements
+    title: "7. Non-Functional Requirements"
+    description: "Performance, security, accessibility, scalability requirements"
+    required: true
+    categories:
+      - Performance
+      - Security
+      - Accessibility
+      - Scalability
+      - Reliability
+
+  - id: business_rules
+    title: "8. Business Rules"
+    description: "Domain-specific rules that govern behavior"
+    required: true
+
+  - id: risks_mitigations
+    title: "9. Risks & Mitigations"
+    description: "Identified risks with probability, impact, and mitigation strategies"
+    required: true
+    format: table
+    columns: [Risk, Probability, Impact, Mitigation]
+
+  - id: dependencies_constraints
+    title: "10. Dependencies & Constraints"
+    description: "External dependencies, technology constraints, team limitations"
+    required: true
+
+  - id: traceability
+    title: "Traceability Matrix"
+    description: "Maps Brief problems to PRD requirements"
+    required: true
+    format: table
+    columns: [Brief Problem, PRD Requirements]
+
+validation:
+  - "All Brief problems have corresponding requirements"
+  - "All requirements have acceptance criteria"
+  - "No placeholders ([TODO], [TBD])"
+  - "Traceability matrix is complete"

package/framework/templates/qa-gate-tmpl.yaml

@@ -0,0 +1,96 @@
+# QA Gate Template
+# Used by: QA-Planning and QA-Implementation Agents
+# Language: English (Constitution Article VII)
+
+template:
+  name: Quality Gate Report
+  version: "1.0.0"
+
+sections:
+  - id: header
+    fields:
+      - gate_type: "planning | implementation"
+      - result: "APPROVED | NEEDS CORRECTION | ESCALATED"
+      - score: "0-100"
+      - timestamp: "ISO 8601"
+
+  - id: planning_gate
+    applicable_to: planning
+    checks:
+      - name: "Brief -> PRD Traceability"
+        description: "Every Brief problem has a PRD requirement"
+        penalty_on_fail: -10
+
+      - name: "PRD -> Phases Traceability"
+        description: "Every PRD requirement appears in a phase"
+        penalty_on_fail: -10
+
+      - name: "Phases -> Tasks Traceability"
+        description: "Every phase has at least one task"
+        penalty_on_fail: -10
+
+      - name: "Tasks -> Criteria Traceability"
+        description: "Every task has Given-When-Then acceptance criteria"
+        penalty_on_fail: -5
+
+      - name: "Brief-PRD Consistency"
+        description: "No PRD requirements without Brief origin"
+        penalty_on_fail: -15
+
+      - name: "Placeholder Check"
+        description: "No [TODO], [TBD], [PLACEHOLDER] in artifacts"
+        penalty_on_fail: -5
+        per_occurrence: true
+
+      - name: "Agent Criteria Quality"
+        description: "Each agent defined rigorous, binary criteria"
+        penalty_on_fail: -10
+
+  - id: implementation_gate
+    applicable_to: implementation
+    checks:
+      - name: "Test Execution"
+        description: "All tests pass"
+        weight: 0.30
+        threshold: "100% pass rate"
+
+      - name: "Code Coverage"
+        description: "Line and branch coverage"
+        weight: 0.20
+        threshold: ">= 80%"
+
+      - name: "Security Scan (SAST)"
+        description: "No critical or high vulnerabilities"
+        weight: 0.25
+        threshold: "0 critical, 0 high"
+
+      - name: "Code Review"
+        description: "Architecture adherence, patterns, quality"
+        weight: 0.15
+
+      - name: "Acceptance Criteria"
+        description: "All Given-When-Then criteria verified"
+        weight: 0.10
+
+  - id: correction_loop
+    max_loops: 3
+    protocol:
+      - step: "Identify failing check"
+      - step: "Send correction to responsible agent"
+      - step: "Agent corrects"
+      - step: "Re-validate"
+      - step: "If still failing after max_loops -> escalate to user"
+
+  - id: escalation
+    options:
+      - "1. Manually address the gaps"
+      - "2. Override and proceed (with documented risk)"
+      - "3. Return to a specific agent for rework"
+
+scoring:
+  start: 100
+  threshold: 95
+  decision:
+    approved: ">= 95"
+    correction: "< 95 (enter silent loop)"
+    escalated: "< 95 after max loops"

package/framework/templates/task-tmpl.yaml

@@ -0,0 +1,85 @@
+# Task Template
+# Used by: Tasks Agent
+# Language: English (Constitution Article VII)
+
+template:
+  name: Task Definition
+  version: "1.0.0"
+
+fields:
+  - name: id
+    type: string
+    pattern: "T{phase}.{sequence}"
+    example: "T1.1"
+    required: true
+
+  - name: title
+    type: string
+    description: "Short, action-oriented title"
+    min_length: 5
+    required: true
+
+  - name: description
+    type: string
+    description: "What needs to be implemented"
+    required: true
+
+  - name: phase
+    type: string
+    description: "Parent phase"
+    required: true
+
+  - name: requirement_ref
+    type: string
+    description: "PRD requirement ID (FR-XXX)"
+    required: true
+
+  - name: priority
+    type: enum
+    values: [critical, high, medium, low]
+    required: true
+
+  - name: size
+    type: enum
+    values: [XS, S, M, L]
+    descriptions:
+      XS: "< 1 hour"
+      S: "1-2 hours"
+      M: "2-4 hours"
+      L: "4-8 hours"
+    required: true
+    note: "XL (8h+) must be split into smaller tasks"
+
+  - name: dependencies
+    type: array
+    items: string
+    description: "Task IDs that must complete before this task"
+    required: false
+
+  - name: acceptance_criteria
+    type: array
+    items:
+      type: object
+      fields:
+        - given: "Initial context/state"
+        - when: "Action performed"
+        - then: "Expected outcome (verifiable)"
+    min_items: 1
+    required: true
+
+  - name: definition_of_done
+    type: array
+    items: string
+    description: "Checklist of completion requirements"
+    default:
+      - "Code implemented"
+      - "Tests written and passing"
+      - "Design System tokens used"
+      - "No lint errors"
+      - "Self-critique completed (5.5 + 6.5)"
+
+validation:
+  - "Size must not be XL (split into sub-tasks)"
+  - "At least 1 Given-When-Then acceptance criterion"
+  - "Requirement reference must exist in PRD"
+  - "No placeholders ([TODO], [TBD])"