aios-core
Version:
Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework
395 lines (393 loc) • 12.4 kB
JSON
{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://synkra.dev/schemas/agent-v3-schema.json",
"title": "AIOS Agent V3 Schema",
"description": "Schema for AIOS 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
}
}
}
}
}
}
}