create-genia-os 2.4.0 → 3.0.0

package/template/.aiox-core/schemas/agent-v3-schema.json

@@ -0,0 +1,394 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://synkra.dev/schemas/agent-v3-schema.json",
+  "title": "AIOX Agent V3 Schema",
+  "description": "Schema for AIOX agent definitions with Auto-Claude capabilities",
+  "type": "object",
+  "required": ["agent", "persona", "commands"],
+  "properties": {
+    "IDE-FILE-RESOLUTION": {
+      "type": "array",
+      "description": "Instructions for resolving file paths in IDE context",
+      "items": { "type": "string" }
+    },
+    "REQUEST-RESOLUTION": {
+      "type": "string",
+      "description": "Instructions for matching user requests to commands"
+    },
+    "activation-instructions": {
+      "type": "array",
+      "description": "Steps to execute when agent is activated",
+      "items": { "type": "string" }
+    },
+    "agent": {
+      "type": "object",
+      "description": "Core agent identification",
+      "required": ["name", "id", "title", "icon"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Agent persona name (e.g., 'Dex', 'Quinn')"
+        },
+        "id": {
+          "type": "string",
+          "description": "Unique agent identifier (e.g., 'dev', 'qa')",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        "title": {
+          "type": "string",
+          "description": "Agent role title (e.g., 'Full Stack Developer')"
+        },
+        "icon": {
+          "type": "string",
+          "description": "Emoji icon for the agent"
+        },
+        "whenToUse": {
+          "type": "string",
+          "description": "Guidance on when to use this agent"
+        },
+        "customization": {
+          "type": ["string", "null"],
+          "description": "Custom overrides for this agent"
+        }
+      }
+    },
+    "persona_profile": {
+      "type": "object",
+      "description": "Personality and communication style",
+      "properties": {
+        "archetype": {
+          "type": "string",
+          "description": "Persona archetype (e.g., 'Builder', 'Guardian')"
+        },
+        "zodiac": {
+          "type": "string",
+          "description": "Zodiac sign for persona flavor"
+        },
+        "communication": {
+          "type": "object",
+          "properties": {
+            "tone": {
+              "type": "string",
+              "enum": ["pragmatic", "conceptual", "analytical", "supportive", "precise"]
+            },
+            "emoji_frequency": {
+              "type": "string",
+              "enum": ["low", "medium", "high"]
+            },
+            "vocabulary": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "greeting_levels": {
+              "type": "object",
+              "properties": {
+                "minimal": { "type": "string" },
+                "named": { "type": "string" },
+                "archetypal": { "type": "string" }
+              }
+            },
+            "signature_closing": { "type": "string" }
+          }
+        }
+      }
+    },
+    "persona": {
+      "type": "object",
+      "description": "Core persona definition",
+      "required": ["role"],
+      "properties": {
+        "role": { "type": "string" },
+        "style": { "type": "string" },
+        "identity": { "type": "string" },
+        "focus": { "type": "string" },
+        "core_principles": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "responsibility_boundaries": {
+          "type": "object",
+          "description": "Scope and delegation rules"
+        }
+      }
+    },
+    "core_principles": {
+      "type": "array",
+      "description": "Guiding principles for agent behavior",
+      "items": { "type": "string" }
+    },
+    "commands": {
+      "type": "array",
+      "description": "Available commands for this agent",
+      "items": {
+        "type": "object",
+        "required": ["name", "description"],
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Command name without * prefix"
+          },
+          "visibility": {
+            "type": "array",
+            "description": "When to show: full (all), quick (essential), key (critical)",
+            "items": {
+              "type": "string",
+              "enum": ["full", "quick", "key"]
+            }
+          },
+          "args": {
+            "type": "string",
+            "description": "Command arguments, e.g., '{story}' or '{topic}'"
+          },
+          "description": {
+            "type": "string",
+            "description": "What this command does"
+          }
+        }
+      }
+    },
+    "dependencies": {
+      "type": "object",
+      "description": "External resources this agent depends on",
+      "properties": {
+        "tasks": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "templates": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "checklists": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "data": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "tools": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "git_restrictions": {
+          "type": "object",
+          "properties": {
+            "allowed_operations": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "blocked_operations": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "redirect_message": { "type": "string" }
+          }
+        },
+        "coderabbit_integration": {
+          "type": "object",
+          "description": "CodeRabbit code review integration config"
+        },
+        "decision_logging": {
+          "type": "object",
+          "description": "Decision logging configuration for yolo mode"
+        }
+      }
+    },
+    "develop-story": {
+      "type": "object",
+      "description": "Story development workflow (for @dev agent)",
+      "properties": {
+        "order-of-execution": { "type": "string" },
+        "story-file-updates-ONLY": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "blocking": { "type": "string" },
+        "ready-for-review": { "type": "string" },
+        "completion": { "type": "string" }
+      }
+    },
+
+    "autoClaude": {
+      "type": "object",
+      "description": "V3: Auto-Claude autonomous development capabilities",
+      "properties": {
+        "version": {
+          "type": "string",
+          "description": "Schema version",
+          "const": "3.0"
+        },
+        "migratedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "When this agent was migrated to V3"
+        },
+        "specPipeline": {
+          "type": "object",
+          "description": "Specification pipeline capabilities",
+          "properties": {
+            "canGather": {
+              "type": "boolean",
+              "description": "Can gather requirements (typically @pm)",
+              "default": false
+            },
+            "canAssess": {
+              "type": "boolean",
+              "description": "Can assess complexity (typically @architect)",
+              "default": false
+            },
+            "canResearch": {
+              "type": "boolean",
+              "description": "Can research dependencies (typically @analyst)",
+              "default": false
+            },
+            "canWrite": {
+              "type": "boolean",
+              "description": "Can write specifications (typically @pm)",
+              "default": false
+            },
+            "canCritique": {
+              "type": "boolean",
+              "description": "Can critique specs (typically @qa)",
+              "default": false
+            }
+          }
+        },
+        "execution": {
+          "type": "object",
+          "description": "Implementation execution capabilities",
+          "properties": {
+            "canCreatePlan": {
+              "type": "boolean",
+              "description": "Can create implementation plans (typically @architect)",
+              "default": false
+            },
+            "canCreateContext": {
+              "type": "boolean",
+              "description": "Can generate project context files (typically @architect)",
+              "default": false
+            },
+            "canExecute": {
+              "type": "boolean",
+              "description": "Can execute subtasks (typically @dev)",
+              "default": false
+            },
+            "canVerify": {
+              "type": "boolean",
+              "description": "Can verify subtask completion (typically @dev, @qa)",
+              "default": false
+            },
+            "selfCritique": {
+              "type": "object",
+              "description": "Self-critique configuration for execution",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": true
+                },
+                "checklistRef": {
+                  "type": "string",
+                  "description": "Reference to self-critique checklist"
+                }
+              }
+            }
+          }
+        },
+        "recovery": {
+          "type": "object",
+          "description": "Recovery and rollback capabilities",
+          "properties": {
+            "canTrack": {
+              "type": "boolean",
+              "description": "Can track implementation attempts (typically @dev)",
+              "default": false
+            },
+            "canRollback": {
+              "type": "boolean",
+              "description": "Can rollback to previous state (typically @dev)",
+              "default": false
+            },
+            "maxAttempts": {
+              "type": "integer",
+              "description": "Max attempts before stuck detection",
+              "default": 3
+            },
+            "stuckDetection": {
+              "type": "boolean",
+              "description": "Enable stuck detection",
+              "default": true
+            }
+          }
+        },
+        "qa": {
+          "type": "object",
+          "description": "QA review capabilities",
+          "properties": {
+            "canReview": {
+              "type": "boolean",
+              "description": "Can perform QA reviews (typically @qa)",
+              "default": false
+            },
+            "canFixRequest": {
+              "type": "boolean",
+              "description": "Can create fix requests (typically @qa)",
+              "default": false
+            },
+            "reviewPhases": {
+              "type": "integer",
+              "description": "Number of review phases (default 10)",
+              "default": 10
+            },
+            "maxIterations": {
+              "type": "integer",
+              "description": "Max QA loop iterations",
+              "default": 5
+            }
+          }
+        },
+        "memory": {
+          "type": "object",
+          "description": "Memory and learning capabilities",
+          "properties": {
+            "canCaptureInsights": {
+              "type": "boolean",
+              "description": "Can capture session insights",
+              "default": false
+            },
+            "canExtractPatterns": {
+              "type": "boolean",
+              "description": "Can extract code patterns",
+              "default": false
+            },
+            "canDocumentGotchas": {
+              "type": "boolean",
+              "description": "Can document gotchas",
+              "default": false
+            }
+          }
+        },
+        "worktree": {
+          "type": "object",
+          "description": "Worktree management capabilities",
+          "properties": {
+            "canCreate": {
+              "type": "boolean",
+              "description": "Can create worktrees (typically @devops)",
+              "default": false
+            },
+            "canMerge": {
+              "type": "boolean",
+              "description": "Can merge worktrees (typically @devops)",
+              "default": false
+            },
+            "canCleanup": {
+              "type": "boolean",
+              "description": "Can cleanup stale worktrees (typically @devops)",
+              "default": false
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/template/.aiox-core/schemas/squad-design-schema.json

@@ -0,0 +1,299 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://synkra.dev/schemas/squad-design.json",
+  "title": "Squad Design Blueprint",
+  "description": "Schema for squad design blueprints generated by *design-squad",
+  "type": "object",
+  "required": ["squad", "recommendations", "metadata"],
+  "properties": {
+    "squad": {
+      "type": "object",
+      "description": "Basic squad information",
+      "required": ["name", "domain"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9](-squad)?$",
+          "minLength": 2,
+          "maxLength": 64,
+          "description": "Squad name in kebab-case"
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 500,
+          "description": "Human-readable description of the squad"
+        },
+        "domain": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "minLength": 2,
+          "maxLength": 50,
+          "description": "Domain identifier in kebab-case"
+        }
+      }
+    },
+    "analysis": {
+      "type": "object",
+      "description": "Domain analysis results",
+      "properties": {
+        "entities": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "maxItems": 50,
+          "description": "Extracted domain entities"
+        },
+        "workflows": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+            "minLength": 2,
+            "maxLength": 100
+          },
+          "maxItems": 50,
+          "description": "Identified workflows in kebab-case"
+        },
+        "integrations": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "maxItems": 30,
+          "description": "External integrations detected"
+        },
+        "stakeholders": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "maxItems": 20,
+          "description": "Stakeholder roles identified"
+        }
+      }
+    },
+    "recommendations": {
+      "type": "object",
+      "description": "Generated recommendations",
+      "required": ["agents", "tasks"],
+      "properties": {
+        "agents": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/agentRecommendation"
+          },
+          "minItems": 0,
+          "maxItems": 10,
+          "description": "Recommended agents"
+        },
+        "tasks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/taskRecommendation"
+          },
+          "minItems": 0,
+          "maxItems": 50,
+          "description": "Recommended tasks"
+        },
+        "template": {
+          "type": "string",
+          "enum": ["basic", "etl", "agent-only", "custom"],
+          "default": "basic",
+          "description": "Recommended squad template"
+        },
+        "config_mode": {
+          "type": "string",
+          "enum": ["extend", "override", "none"],
+          "default": "extend",
+          "description": "Configuration inheritance mode"
+        }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Blueprint metadata",
+      "required": ["created_at"],
+      "properties": {
+        "created_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "ISO 8601 timestamp of blueprint creation"
+        },
+        "source_docs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Paths to source documentation files"
+        },
+        "user_adjustments": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 0,
+          "description": "Number of user modifications made"
+        },
+        "overall_confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Overall confidence score (0-1)"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "agentRecommendation": {
+      "type": "object",
+      "required": ["id", "role", "confidence"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "minLength": 2,
+          "maxLength": 64,
+          "description": "Agent identifier in kebab-case"
+        },
+        "role": {
+          "type": "string",
+          "minLength": 5,
+          "maxLength": 200,
+          "description": "Agent role description"
+        },
+        "commands": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+            "minLength": 2,
+            "maxLength": 64
+          },
+          "maxItems": 20,
+          "description": "Agent commands in kebab-case"
+        },
+        "confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Recommendation confidence score (0-1)"
+        },
+        "user_added": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether this agent was added by user"
+        },
+        "user_modified": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether this agent was modified by user"
+        }
+      }
+    },
+    "taskRecommendation": {
+      "type": "object",
+      "required": ["name", "agent", "confidence"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "minLength": 2,
+          "maxLength": 64,
+          "description": "Task name in kebab-case (without .md extension)"
+        },
+        "agent": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "minLength": 2,
+          "maxLength": 64,
+          "description": "Owning agent identifier"
+        },
+        "entrada": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "maxItems": 20,
+          "description": "Task input parameters"
+        },
+        "saida": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "maxItems": 20,
+          "description": "Task output parameters"
+        },
+        "confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Recommendation confidence score (0-1)"
+        },
+        "checklist": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200
+          },
+          "maxItems": 20,
+          "description": "Task checklist items"
+        }
+      }
+    }
+  },
+  "examples": [
+    {
+      "squad": {
+        "name": "order-management-squad",
+        "description": "Squad for order management system",
+        "domain": "order-management"
+      },
+      "analysis": {
+        "entities": ["Order", "Customer", "Product", "Payment"],
+        "workflows": ["create-order", "process-payment", "ship-order"],
+        "integrations": ["Stripe API", "Inventory Service"],
+        "stakeholders": ["Customer", "Admin", "Support"]
+      },
+      "recommendations": {
+        "agents": [
+          {
+            "id": "order-manager",
+            "role": "Manages order lifecycle from creation to fulfillment",
+            "commands": ["create-order", "update-order", "cancel-order"],
+            "confidence": 0.92,
+            "user_added": false,
+            "user_modified": false
+          }
+        ],
+        "tasks": [
+          {
+            "name": "create-order",
+            "agent": "order-manager",
+            "entrada": ["customer_id", "items", "payment_method"],
+            "saida": ["order_id", "status"],
+            "confidence": 0.88
+          }
+        ],
+        "template": "basic",
+        "config_mode": "extend"
+      },
+      "metadata": {
+        "created_at": "2025-12-18T00:00:00Z",
+        "source_docs": ["./docs/prd/orders.md"],
+        "user_adjustments": 2,
+        "overall_confidence": 0.87
+      }
+    }
+  ]
+}