create-aios

Bootstrap a Synkra AIOS project with God Mode.

npx create-aios my-project

Quick Start

# Cria um novo projeto AIOS completo
npx create-aios my-project

# Entra no diretório e começa a trabalhar
cd my-project
claude

That's it. Your project is ready with agents, squads, skills, and the full AIOS framework.

Features

• God Mode -- Full agent orchestration with all personas (dev, qa, architect, pm, po, sm, analyst, data-engineer, ux-design-expert, devops)
• Squad System -- Pre-configured squads for team-based development workflows
• Story-Driven Development -- Built-in story lifecycle with create, validate, implement, and QA gates
• Claude Code Integration -- Rules, skills, and permissions configured out of the box
• Spec Pipeline -- Transform requirements into executable specifications
• QA Loop -- Automated review-fix cycles with configurable iteration limits
• Framework Protection -- 4-layer boundary model (L1-L4) to keep framework files safe

Commands

create

Scaffold a new AIOS project from scratch.

npx create-aios my-project
npx create-aios my-project --yes    # Aceitar todos os padrões

update

Update an existing project to the latest template version.

cd my-project
npx create-aios update

doctor

Run diagnostics on an existing AIOS installation.

cd my-project
npx create-aios doctor

add-squad

Add a new squad configuration to the project.

cd my-project
npx create-aios add-squad backend

Options

| Option | Description | |---------|----------------------------------------------| | --yes | Accept all defaults without interactive prompts |

What Gets Installed

my-project/
├── .claude/
│   ├── settings.json          # Claude Code permissions
│   ├── rules/                 # Tool examples, workflow rules
│   ├── skills/                # God Mode skill definitions
│   └── CLAUDE.md              # Project instructions for Claude
├── .aios-core/
│   ├── constitution.md        # Framework principles
│   ├── core/                  # Core framework modules
│   ├── development/
│   │   ├── tasks/             # Executable task definitions
│   │   ├── templates/         # Document and code templates
│   │   ├── checklists/        # Validation checklists
│   │   └── workflows/         # Multi-step workflows
│   └── data/                  # Tool registry, configuration data
├── docs/
│   ├── stories/               # Development stories
│   ├── prd/                   # Product requirement documents
│   └── architecture/          # System architecture docs
├── squads/                    # Squad configurations
├── packages/                  # Project packages
├── tests/                     # Test suites
├── package.json
└── README.md

Requirements

• Node.js 18 or later
• Git installed and configured
• GitHub CLI (gh) recommended for PR workflows

How It Works

1. create-aios downloads the latest God Mode template
2. Scaffolds the project structure with all framework files
3. Installs dependencies and configures Claude Code integration
4. Your project is ready for agent-driven development

Related

• Synkra AIOS -- The AI-Orchestrated System framework
• squads.sh -- Squad management for AIOS projects
• aios-god-mode-template -- The template this CLI uses

License

MIT