AIOS Forge Squad

Meta squad for the development, optimization, and evolution of agentic squads.

What is it

AIOS Forge Squad is the meta-tool for agentic squads: it creates, validates, optimizes, and modernizes any squad artifact (agents, tasks, workflows, skills, full squads, templates). With 7 specialized agents, 14 tasks, and 3 workflows, it covers the entire lifecycle of squad artifacts — from agents to full squads.

Installation

npx squads add aios-forge-squad

Agents

Commands

Creation

@aios-forge *create-agent       # New agent with full persona
@aios-forge *create-task        # New task with I/O contracts
@aios-forge *create-workflow    # New multi-agent workflow
@aios-forge *create-skill       # New Claude Code skill
@aios-forge *create-squad       # New complete squad (7 phases)
@aios-forge *create-template    # New annotated template

Validation & Audit

@aios-sentinel *validate-artifact    # Validates format + Squad Protocol v5 + component deduplication
@aios-sentinel *audit-framework      # Full project audit

Optimization

@aios-catalyst *optimize-component    # Measure, optimize, verify
@aios-catalyst *modernize-component   # Migrate to current standards

Integration

@aios-nexus *integrate-config    # Configure MCP, rules, settings, deploy

Research & Self-Update

@aios-scout *research-updates         # Research updates (Claude Code, Squad Protocol)
@aios-scout *self-update-knowledge    # Update knowledge base

Orchestration

@aios-oracle *analyze-component    # Deep analysis of any component

Workflows

forge_artifact

Full creation pipeline — from request to deploy.

Oracle → Architect → Forge → Sentinel → Catalyst → Nexus

Analyzes the request, designs the structure, creates the artifact, validates against standards, optimizes, and integrates into the system.

optimize_framework

Optimization pipeline — full audit through improvement deploy.

Oracle → Architect → Scout → Catalyst → Sentinel → Nexus

Audits current state, researches best practices, applies optimizations, validates compliance, and deploys.

self_update

Self-update pipeline — research, evaluate, and apply updates.

Scout → Scout → Oracle → Forge → Sentinel

Checks current date/time, researches Claude Code and Squad Protocol updates, evaluates relevance, updates artifacts, and validates integrity.

Architecture

                      ┌────────────────┐
                      │  aios-oracle   │
                      │ (Orchestrator) │
                      └───────┬────────┘
                              │
              ┌───────────────┼───────────────┐
              │               │               │
      ┌───────┴──────┐ ┌─────┴──────┐ ┌──────┴───────┐
      │aios-architect│ │ aios-forge  │ │aios-sentinel │
      │ (Strategist) │ │  (Creator)  │ │  (Guardian)  │
      └───────┬──────┘ └─────┬──────┘ └──────┬───────┘
              │               │               │
      ┌───────┴──────┐ ┌─────┴──────┐ ┌──────┴───────┐
      │aios-catalyst │ │ aios-nexus  │ │  aios-scout  │
      │ (Optimizer)  │ │(Integrator) │ │ (Researcher) │
      └──────────────┘ └────────────┘ └──────────────┘

Structure

squads/aios-forge-squad/
├── squad.yaml                          # Manifest
├── README.md
├── config/
│   ├── coding-standards.md             # Coding standards
│   ├── tech-stack.md                   # Technology stack
│   └── source-tree.md                  # Squad map
├── agents/                             # 7 agents
│   ├── aios-oracle.md
│   ├── aios-architect.md
│   ├── aios-forge.md
│   ├── aios-sentinel.md
│   ├── aios-catalyst.md
│   ├── aios-nexus.md
│   └── aios-scout.md
├── tasks/                              # 14 tasks
│   ├── analyze-aios-component.md
│   ├── create-agent.md
│   ├── create-task.md
│   ├── create-workflow.md
│   ├── create-skill.md
│   ├── create-squad.md
│   ├── create-template.md
│   ├── validate-artifact.md
│   ├── audit-framework.md
│   ├── optimize-component.md
│   ├── modernize-component.md
│   ├── integrate-configuration.md
│   ├── research-updates.md
│   └── self-update-knowledge.md
└── workflows/                          # 3 workflows
    ├── forge-artifact.yaml
    ├── optimize-framework.yaml
    └── self-update.yaml

Requirements

• Bun 1.0+
• Squad Protocol v5.0
• Claude Code (or a compatible harness: Codex, Gemini CLI, Antigravity CLI)
• Git 2.30+

Author

Luiz Gustavo Vieira Rodrigues — @gutomec

License

MIT