Documentation

AI‑IOS Documentation

This page explains the AI‑IOS framework at a deeper level — the roles, stages, state machine, execution modes, and Commander controls that make the system deterministic and repeatable across any AI model.

If the How It Works page is the overview, this page is the “Commander Manual.”

Modes

User Mode vs Commander Mode

User Mode

Designed for colleagues, analysts, and non‑technical users. They only:

  • Answer the 5 questions in the Wizard
  • Copy the Context Header
  • Paste it with the Cartridge into their AI
  • Watch the cycle run

Commander Mode

Designed for architects, strategists, and leaders. Commanders:

  • Understand the 8‑stage cycle
  • Know when to restart from Stage 1 or Stage 3
  • Interpret risk, objections, and contradictions
  • Guide the AI through complex or political environments
Roles

The Four Roles

AI‑IOS uses role‑emulation so any model can behave like the right “persona” for each stage.

Scout (Gemini‑like)

  • Divergent thinking
  • Risk detection
  • Hostile QA
  • Pattern mapping

Architect (Claude‑like)

  • Structure and logic
  • System design
  • Dependency mapping
  • Refinement

Operator (Copilot‑like)

  • Enterprise alignment
  • Actionable formatting
  • Clarity and execution
  • Deliverable creation

Commander Assistant

  • Validation questions
  • Decision support
  • No overriding Commander intent
Stages

The 8‑Stage AI‑IOS Cycle

Stage 0 — Commander Check

Challenge assumptions, clarify intent, expose bias.

Stage 1 — SEE

Map variables, stakeholders, constraints, risks, objections.

Stage 2 — FEEL

Architect the solution: structure, logic, dependencies.

Stage 3 — TOUCH

Align with enterprise reality: tools, stack, politics.

Stage 4 — BREAK

Hostile QA: attack assumptions, find contradictions.

Stage 5 — REBUILD

Fix contradictions, strengthen logic, refine architecture.

Stage 6 — DELIVER

Executive‑ready output: narrative, deck, brief.

Stage 7 — Commander Validation

Approve, restart Stage 1, or restart Stage 3.

Modes

Execution Modes

Full Mode (default)

Runs all 8 stages in sequence. Best for complex or political problems.

Fast‑Track Mode

Jumps directly to execution and delivery (Stages 3 → 6 → 7).

Micro‑Cycle Mode

For rapid iteration: SEE → FEEL → TOUCH.

State Machine

Deterministic State Machine

AI‑IOS is not a “prompt.” It’s a deterministic state machine that the AI loads as its operating rules. This ensures:

  • No drift
  • No skipping steps
  • No hallucinated transitions
  • Self‑correction if the user pastes out of order
S0 → S1 → S2 → S3 → S4 → S5 → S6 → S7 S7 → (restart S1) or (restart S3) or END

The AI detects which stage the pasted content belongs to and adjusts automatically.

Cartridge

The Cartridge Concept

The AI‑IOS Cartridge is a self‑contained Engine Manual + wrapper prompt that you paste into your AI tool. It includes:

  • Roles
  • Stages
  • State machine
  • Error handling
  • Governance rules
  • Commander controls

Any model that can follow instructions can run the cartridge. This gives you a consistent, repeatable reasoning system across:

  • Microsoft Copilot
  • Google Gemini
  • Anthropic Claude
  • xAI Grok
  • And future models
Commander Control

Restart Logic

At Stage 7, the Commander decides whether to:

  • Approve — the cycle ends
  • Restart from Stage 1 — new problem framing
  • Restart from Stage 3 — same architecture, new execution

This gives you a controlled, iterative loop without losing context or structure.

Multi‑Model

Comparing Models

Because the cartridge defines the structure, you can run the same problem through multiple models and compare:

  • How Gemini maps risks
  • How Claude structures logic
  • How Copilot aligns to enterprise tools
  • How Grok handles objections

Same inputs. Same structure. Different intelligence profiles.