Vexel AIOS — Multi-Agent Intelligence Framework

Scaffold AI agent squads that think, build and ship together.

npx create-vexel@latest my-squad
cd my-squad && claude

What is this?

Vexel AIOS is a framework for orchestrating specialized AI agents. Instead of a single AI doing everything, you have a squad — each agent an expert in its domain, collaborating through structured workflows and shared conventions.

Getting Started

# 1. Scaffold your project
npx create-vexel@latest my-project

# 2. Enter the project
cd my-project

# 3. Open Claude Code (recommended)
claude

# 4. Press / to see available commands
# 5. Type @ to activate an agent

How Agents Work

All agents live in .claude/agents/. Each file defines one agent — its persona, expertise and available commands.

Activate any agent:

@agent-name

Run a specific command:

@agent-name *command-name

Slash command shortcuts:

/command-name

To discover what agents are available, look inside .claude/agents/. The filename (without .md) is the mention name. Each agent file describes what it does and what commands it accepts.

How Squads Work

Squads are groups of agents that collaborate on a specialized domain. They live in squads/.

Each squad has:

• An orchestrator agent that coordinates the workflow
• Specialized member agents with domain expertise
• Workflows (.yaml) defining the phases and hand-offs
• Tasks that any agent can execute
• A squad.yaml with the full capability map

To start a squad:

1. Read the squad's README.md for quick start
2. Activate the squad orchestrator with @orchestrator-name
3. The orchestrator handles phase routing and agent delegation

Project Structure

my-project/
├── .claude/
│   ├── agents/          # All agent definitions (auto-discovered)
│   ├── commands/        # Slash command shortcuts
│   ├── rules/           # Framework rules and governance
│   └── CLAUDE.md        # How Claude reads this project
│
├── squads/              # Specialized agent squads
│   └── <squad-name>/
│       ├── squad.yaml   # Orchestrator + capabilities
│       ├── README.md    # Quick start
│       ├── workflows/   # Multi-phase workflows
│       ├── tasks/       # Executable tasks
│       ├── templates/   # Output templates
│       └── agents/      # Squad-specific agent files
│
└── .aios-core/          # Framework engine
    ├── constitution.md  # Non-negotiable principles
    └── development/     # Tasks, checklists, scripts

AIOS Constitution

Principles that govern every agent in the framework:

| # | Principle | Level | |---|-----------|-------| | I | CLI First — CLI > Observability > UI. Never invert. | NON-NEGOTIABLE | | II | Agent Authority — Each agent has exclusive authority. Can't be skipped. | NON-NEGOTIABLE | | III | Story-Driven Development — No code without a validated story. | MUST | | IV | No Invention — Specs derive from documented requirements only. | MUST | | V | Quality First — All gates must pass before push. | MUST | | VI | Absolute Imports — Use @/components/X, never ../../../. | SHOULD |

Full text: .aios-core/constitution.md

Adding New Squads

To add a new squad to your project:

1. Create squads/<squad-name>/ with a squad.yaml and README.md
2. Add agent definitions to .claude/agents/
3. Add slash command shortcuts to .claude/commands/
4. Claude and all IDEs will discover them automatically — no config changes needed

IDE Support

When scaffolding, choose your IDE to get auto-configured rules:

| IDE | Config path | What it does | |-----|-------------|--------------| | Cursor | .cursor/rules/ | Always-on agent context | | Windsurf | .windsurf/rules/ | Cascade rules | | Kiro | .kiro/rules/ | Project rules | | Antigravity | .antigravity/rules/ | Agent context | | VS Code | .vscode/ | Extensions + settings | | Zed | .zed/settings.json | Anthropic model config |

Language

{ "language": "portuguese" }