nios-core

NIOS (Nicolas Intelligent Orchestration System) — AI-Orchestrated System for Full Stack Development.

A meta-framework that orchestrates AI agents to handle complex development workflows using Claude Code as the runtime engine.

Quick Start

npx nios-core --help

Or install globally:

npm install -g nios-core
nios --help

What is NIOS?

NIOS is a framework of 32 specialized AI agents organized into 7 squads that work together to handle the full software development lifecycle — from product requirements to deployment.

Squads

| Squad | Agents | Focus | |-------|--------|-------| | Product | 4 | Strategy, PRDs, stories, validation | | Engineering | 5 | Implementation, architecture, deploy, QA | | Design | 6 | UX/UI, brand, design systems, motion, content, research | | Governance | 2 | Framework governance, orchestration | | Marketing | 6 | Content, SEO, email, sales | | DevSecOps | 5 | Security, compliance, auditing | | Data & AI | 4 | AI/ML, BI, data pipelines |

Key Agents

• @dev (Dex) — Full-stack implementation
• @architect (Aria) — System architecture
• @pm (Morgan) — Product management, PRDs
• @qa (Quinn) — Testing, quality gates
• @devops (Gage) — CI/CD, releases
• @nios-master (Orion) — Framework orchestration

CLI Commands

nios workers search "json transformation"   # Search reusable workers
nios workers list --category=data           # List workers by category
nios manifest validate                      # Validate manifest files
nios qa run                                 # Run quality gates
nios qa status                              # QA status
nios metrics show                           # Show quality metrics
nios config show                            # Show configuration
nios mcp setup --with-defaults              # Setup MCP servers
nios generate prd --title "Feature X"       # Generate documents
nios migrate --dry-run                      # Preview migrations
nios doctor                                 # System diagnostics

How It Works

NIOS installs as a .nios-core/ directory inside your project. Claude Code reads the agent definitions, tasks, templates, and workflows to provide structured development assistance.

Story-Driven Development

All development follows a structured lifecycle:

@sm (create story) → @po (validate) → @dev (implement) → @qa (quality gate) → @devops (deploy)

Agent Activation

Agents are activated with @agent-name syntax inside Claude Code:

@dev implement the login feature
@qa run quality gate for story 2.1
@architect review the database schema

Project Structure

.nios-core/
├── bin/              # CLI entry point
├── cli/              # CLI commands (workers, qa, config, etc.)
├── core/             # Core modules (config, orchestration, synapse)
├── development/      # Agents, tasks, templates, workflows
├── infrastructure/   # Scripts, integrations, tools
├── product/          # Product templates (PRD, epic, story)
├── quality/          # Quality metrics collection
├── schemas/          # YAML/JSON schemas
├── squads/           # Squad definitions (7 squads)
└── scripts/          # Diagnostics, health checks

Requirements

• Node.js >= 18.0.0
• npm >= 9.0.0
• Claude Code (CLI)

License

MIT - Nicolas Nunes