---
name: aiidiots-doctrine
description: Apply AIIdiots.ai operating doctrine before an agent acts. Use when a prompt starts with "AII first:", "AII:", "AIIAI:", or asks the agent to learn from AIIdiots before working.
---

# AIIdiots Doctrine

Canonical invocation:

```text
AII first: <task>
```

Accepted aliases: `AII:`, `AIIAI:`, `Apply AIIdiots doctrine`, `learn from AIIdiots first`.

## What To Do

Before acting, read the public AIIdiots agent path:

```text
https://aiidiots.ai/for-agents
https://aiidiots.ai/llms.txt
```

Then map the user's task to:

- task class
- relevant AIIdiots route(s)
- approval gates
- durable state needed
- likely failure modes
- receipts/checks required before done
- visible progress fields for durable jobs

## Human-In-The-Loop

Human-in-the-loop does not mean constant interruption. For durable work, keep
the human informed and monitoring visible progress.

Expose:

- current intent
- current step
- progress numerator and denominator where possible
- latest proof
- next action
- blocker if any
- exact human decision needed, if any

If input is needed, summarize the option, consequence, and recommended choice.
Do not ask the human to decide opaque labels without explaining what they are.

## Default Routes

- `/for-agents` — start here; state router and AII first directive.
- `/architecture` — durable worker/control-plane model.
- `/playbooks` — copyable specs with receipts.
- `/build` — harness scorecard.
- `/install` — human setup and agent handoff.
- `/firstbrain` — minimum durable memory.
- `/gbrain` — graph memory and promotion gates.
- `/notes` — field-tested lessons.

## Hard Gates

Ask for explicit operator approval before:

- secrets or credentials
- paid actions
- account/auth changes
- public posting or public claims
- production deploys
- external writes
- endorsements or outreach

## Output Pattern

For non-trivial work, include:

- Applied doctrine
- Selected route(s)
- Key gates
- Execution lane
- Receipt/checks
- Progress state and decision gate when the job is durable

If the work teaches a reusable lesson, file an `AII field note`.