aiwg 2026.5.6 → 2026.5.8

package/README.md

@@ -2,9 +2,9 @@
 
 # AIWG
 
-**Multi-agent AI framework for Claude Code, Copilot, Cursor, Warp, and 4 more platforms**
+**Multi-agent AI framework for Claude Code, Copilot, Cursor, Warp, and 6 more platforms**
 
-200+ agents, 67+ CLI commands, 130+ skills, 8 core frameworks + training marketplace plugin, 27 addons. SDLC workflows, digital forensics, research management, marketing operations, media curation, ops infrastructure, knowledge base, and fine-tuning dataset curation — all deployable with one command.
+200+ agents, 67+ CLI commands, 400+ deployable agent/skill/command/rule artifacts, 8 core frameworks + training marketplace plugin, 27 addons. SDLC workflows, digital forensics, research management, marketing operations, media curation, ops infrastructure, knowledge base, and fine-tuning dataset curation — all deployable with one command.
 
 ```bash
 npm i -g aiwg        # install globally
@@ -15,11 +15,11 @@ aiwg use sdlc        # deploy SDLC framework
 [![npm downloads](https://img.shields.io/npm/dm/aiwg?color=CB3837&logo=npm&style=flat-square)](https://www.npmjs.com/package/aiwg)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](LICENSE)
 [![GitHub Stars](https://img.shields.io/github/stars/jmagly/aiwg?style=flat-square)](https://github.com/jmagly/aiwg/stargazers)
-[![Node Version](https://img.shields.io/badge/node-%E2%89%A518.0.0-brightgreen?style=flat-square&logo=node.js)](https://nodejs.org)
+[![Node Version](https://img.shields.io/badge/node-%E2%89%A520.0.0-brightgreen?style=flat-square&logo=node.js)](https://nodejs.org)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue?style=flat-square&logo=typescript)](https://www.typescriptlang.org)
-[![8 Platforms](https://img.shields.io/badge/Platforms-8-purple?style=flat-square)](#-platform-support)
+[![10 Platforms](https://img.shields.io/badge/Platforms-10-purple?style=flat-square)](#-platform-support)
 
-[**Get Started**](#quick-start) · [**Features**](#what-you-get) · [**Agents**](#agents-162) · [**CLI Reference**](#cli-reference-47-commands) · [**Documentation**](#documentation) · [**Community**](#community--support)
+[**Get Started**](#quick-start) · [**Features**](#what-you-get) · [**Agents**](#agents) · [**CLI Reference**](docs/cli-reference.md) · [**Documentation**](#documentation) · [**Community**](#community--support)
 
 [![Discord](https://img.shields.io/badge/Discord-Join-5865F2?logo=discord&logoColor=white&style=flat-square)](https://discord.gg/BuAusFMxdA)
 [![Telegram](https://img.shields.io/badge/Telegram-Join-26A5E4?logo=telegram&logoColor=white&style=flat-square)](https://t.me/+oJg9w2lE6A5lOGFh)
@@ -1712,7 +1712,7 @@ Full research background, citations, and methodology: [docs/research/](docs/rese
 
 - **[Quick Start Guide](docs/quickstart.md)** — Install and deploy in minutes
 - **[Prerequisites](docs/getting-started/prerequisites.md)** — Node.js, AI platforms, OS support
-- **[CLI Reference](docs/cli-reference.md)** — All 47 commands with examples
+- **[CLI Reference](docs/cli-reference.md)** — 67+ commands with examples
 
 ### Customize
 

package/agentic/code/addons/agent-loop/skills/agent-loop/SKILL.md

@@ -2,7 +2,7 @@
 namespace: aiwg
 name: agent-loop
 description: Detect requests for iterative autonomous agent loops and route to the appropriate loop executor
-version: 3.0.0
+version: 3.1.0
 platforms: [all]
 
 ---
@@ -22,7 +22,7 @@ platforms: [all]
 
 # Agent Loop Skill
 
-You detect when users want iterative autonomous task execution and route to the appropriate loop command.
+You detect when users want iterative autonomous task execution and route to an internal, in-session loop by default. External daemon loops are opt-in and require an explicit request.
 
 ## Loop Taxonomy
 
@@ -30,10 +30,33 @@ This skill is the **detection and routing layer** for autonomous agent loops —
 
 | Loop Type | Implementation | Description |
 |-----------|---------------|-------------|
-| **Al** | `ralph` command | Basic iterate-until-complete with learning extraction |
+| **Internal Agent Loop** | current assistant session / internal loop | Default visible iterate-until-complete workflow in the active session |
+| **Al** | internal `ralph` concept | Basic iterate-until-complete when named without external qualifiers |
+| **External Agent Loop** | `agent-loop-ext` / `ralph-external` daemon | Explicitly requested background, detached, crash-resilient, or resumable work |
 | *(future)* | — | Reflection loops, critic-actor loops, branching loops |
 
-Currently routes all detected requests to the iterative loop executor. As new loop types are added, this skill will route based on task characteristics.
+Generic loop requests route to the internal in-session loop. As new loop types are added, this skill will route based on task characteristics.
+
+## Routing Policy
+
+### Default: Internal/In-Session Loop
+
+Use the internal loop when the user says `agent-loop`, `al`, `ralph`, `loop`, `iterate`, `keep trying`, `fix until green`, `address issues`, `handle all listed issues`, or supplies an iteration bound such as `--iterations 200` without explicit external wording.
+
+Run the work visibly in the current assistant session:
+
+1. Establish completion criteria.
+2. Act on the next bounded slice of work.
+3. Verify with the relevant checks.
+4. Adapt and continue until completion, blocker, or the requested iteration cap.
+
+Do not launch detached processes, background sessions, or the Ralph external daemon for generic loop requests.
+
+### Explicit External Route
+
+Route to `agent-loop-ext` / `ralph-external` only when the user explicitly asks for external execution, background execution, a daemon, detached operation, crash resilience, session survival, resume-later behavior, unattended long-running work, or when they name `agent-loop-ext`, `ralph-external`, or the Ralph daemon directly.
+
+If the user says `ralph` without external/background/daemon qualifiers, treat it as the internal loop concept.
 
 ## Triggers
 
@@ -50,16 +73,16 @@ Alternate expressions and non-obvious activations (primary phrases are matched a
 
 | Pattern | Example | Action |
 |---------|---------|--------|
-| `ralph this: X` | "ralph this: fix all lint errors" | Extract task, infer completion |
-| `ralph: X` | "ralph: migrate to TypeScript" | Extract task, infer completion |
-| `ralph it` | "ralph it" (after task description) | Use conversation context |
-| `keep trying until X` | "keep trying until tests pass" | Task = current context, completion = X |
-| `loop until X` | "loop until coverage >80%" | Task = improve coverage, completion = X |
-| `iterate until X` | "iterate until no errors" | Task = fix errors, completion = X |
-| `run until passes` | "run until passes" | Infer test command |
-| `fix until green` | "fix until green" | Task = fix tests, completion = tests pass |
-| `keep fixing until X` | "keep fixing until lint is clean" | Task = fix lint, completion = X |
-| `al: X` | "al: fix all lint errors" | Shortcut for agent-loop, extract task |
+| `ralph this: X` | "ralph this: fix all lint errors" | Internal loop: extract task, infer completion |
+| `ralph: X` | "ralph: migrate to TypeScript" | Internal loop: extract task, infer completion |
+| `ralph it` | "ralph it" (after task description) | Internal loop: use conversation context |
+| `keep trying until X` | "keep trying until tests pass" | Internal loop: task = current context, completion = X |
+| `loop until X` | "loop until coverage >80%" | Internal loop: task = improve coverage, completion = X |
+| `iterate until X` | "iterate until no errors" | Internal loop: task = fix errors, completion = X |
+| `run until passes` | "run until passes" | Internal loop: infer test command |
+| `fix until green` | "fix until green" | Internal loop: task = fix tests, completion = tests pass |
+| `keep fixing until X` | "keep fixing until lint is clean" | Internal loop: task = fix lint, completion = X |
+| `al: X` | "al: fix all lint errors" | Internal loop shortcut: extract task |
 
 ## Extraction Logic
 
@@ -107,7 +130,7 @@ When the inference skill IS available, prefer it. The skill handles multi-langua
 - Task: "migrate all files in lib/ to ESM"
 - Completion (inferred): "node --experimental-vm-modules lib/index.js runs without errors"
 
-**Action**: Invoke `/ralph "migrate all files in lib/ to ESM" --completion "node --experimental-vm-modules lib/index.js succeeds"`
+**Action**: Run an internal loop in the current session for `migrate all files in lib/ to ESM` until the inferred completion command succeeds
 
 ---
 
@@ -116,7 +139,7 @@ When the inference skill IS available, prefer it. The skill handles multi-langua
 - Task: "fix failing tests" (from context or implied)
 - Completion: "npm test passes with 0 failures"
 
-**Action**: Invoke `/ralph "fix failing tests" --completion "npm test passes"`
+**Action**: Run an internal loop in the current session until `npm test` passes
 
 ---
 
@@ -125,7 +148,7 @@ When the inference skill IS available, prefer it. The skill handles multi-langua
 - Task: (from conversation context about auth validation)
 - Completion: (infer based on task type)
 
-**Action**: Invoke `/ralph "{context-based task}" --completion "{inferred criteria}"`
+**Action**: Run an internal loop in the current session using the context-based task and inferred criteria
 
 ---
 
@@ -134,7 +157,16 @@ When the inference skill IS available, prefer it. The skill handles multi-langua
 - Task: "add tests to improve coverage"
 - Completion: "npm run coverage shows >80%"
 
-**Action**: Invoke `/ralph "add tests to improve coverage" --completion "coverage report shows >80%"`
+**Action**: Run an internal loop in the current session until the coverage report shows more than 80%
+
+---
+
+**User**: "Run this in the background with crash recovery and let me attach later"
+**Extraction**:
+- Task: (from conversation context)
+- Completion: (infer based on task type)
+
+**Action**: Route to `agent-loop-ext` / `ralph-external` because the user explicitly requested background crash-resilient execution
 
 ## Clarification Prompts
 
@@ -160,9 +192,9 @@ What task should I repeat until success?
 What command tells me when it's done?
 ```
 
-## Multi-Loop Support
+## External/Multi-Loop Support
 
-**Version 2.0** adds concurrent loop execution with registry tracking.
+**Version 2.0** added concurrent loop execution with registry tracking. This applies to explicit external daemon loops, not ordinary internal `agent-loop` requests.
 
 ### Concurrency Limits
 
@@ -178,7 +210,7 @@ All loops have unique identifiers:
 
 ### --loop-id Parameter
 
-Users can optionally specify a loop ID:
+Users can optionally specify a loop ID for external daemon loops:
 
 ```
 /ralph "fix tests" --completion "npm test passes" --loop-id ralph-my-fixes-12345678
@@ -188,7 +220,7 @@ If not provided, ID is auto-generated from task description.
 
 ### Registry Tracking
 
-All active loops tracked in `.aiwg/ralph/registry.json`:
+External active loops are tracked in `.aiwg/ralph/registry.json`:
 
 ```json
 {
@@ -209,7 +241,7 @@ All active loops tracked in `.aiwg/ralph/registry.json`:
 
 ### Concurrent Loop Behavior
 
-**When starting a new loop**:
+**When starting a new external loop**:
 
 1. Check registry: `active_loops.length < 4`
 2. If at limit: Show error with active loop list
@@ -273,22 +305,33 @@ Multi-loop structure per loop:
 
 ## Invocation
 
-Once task and completion are extracted/confirmed, invoke the loop executor skill with:
+Once task and completion are extracted/confirmed, use the default internal route unless explicit external wording is present.
+
+For the default internal route:
+
+- **Task**: The extracted task description
+- **Completion criteria**: The verification command or condition
+- **Max iterations**: If user mentioned iteration limit
+- **Timeout**: If user mentioned time limit
+- **Operation**: Iterate in the current assistant session with visible progress and verification after meaningful changes
+
+For explicit external daemon routes:
 
 - **Task**: The extracted task description
 - **Completion criteria**: The verification command or condition
 - **Max iterations**: If user mentioned iteration limit
 - **Timeout**: If user mentioned time limit
 - **Loop ID**: If user wants a custom loop identifier
+- **Operation**: Route through `agent-loop-ext` / `ralph-external`, then surface status, log, attach, and abort commands
 
-### Multi-Loop Examples
+### External Multi-Loop Examples
 
 **Parallel bug fixes**:
 ```
-User: "ralph: fix TypeScript errors in src/"
+User: "run an external ralph loop to fix TypeScript errors in src/"
 → Loop 1: ralph-fix-ts-errors-a1b2c3d4
 
-User: "also ralph: add missing tests in lib/"
+User: "also run an external ralph loop to add missing tests in lib/"
 → Loop 2: ralph-add-tests-b2c3d4e5
 
 Both running in parallel until completion criteria met.
@@ -296,7 +339,7 @@ Both running in parallel until completion criteria met.
 
 **Sequential with manual abort**:
 ```
-User: "ralph: refactor entire auth module"
+User: "run an external ralph loop to refactor the entire auth module"
 → Loop 1: ralph-refactor-auth-c3d4e5f6 (running)
 
 User: "actually, abort that and just fix the login bug"
@@ -310,13 +353,15 @@ User: "actually, abort that and just fix the login bug"
 - The skill is **exclusive** - once triggered, handle the entire request
 - Always confirm extraction before invoking if there's ambiguity
 - Prefer inferring completion criteria over asking (ask only if truly unclear)
-- Check registry capacity before starting new loops
-- Show helpful errors with active loop list when at capacity
+- Default ambiguous requests to the internal in-session loop
+- Do not start `ralph-external`, detached daemons, or background `aiwg ralph` processes unless the user explicitly asks for them
+- Check registry capacity before starting explicit external loops
+- Show helpful errors with active loop list when explicit external loops are at capacity
 
 ## Related
 
 - `infer-completion-criteria` skill - derives measurable `--completion` from project state when the user doesn't supply one
-- `ralph` skill - the iterative loop executor implementation (legacy name; `agent-loop` is canonical)
+- `ralph` skill - legacy name for the iterative loop concept; `agent-loop` is canonical and defaults to in-session execution
 - `agent-loop-ext` skill - crash-resilient external loop with state persistence
 - `ralph-status` skill - check loop progress
 - `ralph-resume` skill - continue interrupted loops
@@ -327,6 +372,7 @@ User: "actually, abort that and just fix the login bug"
 
 ## Version History
 
+- **3.1.0**: Defaulted generic `agent-loop` routing to internal in-session loops; require explicit wording for external daemon loops
 - **3.0.0**: Renamed from `ralph-loop` to `agent-loop`; added loop taxonomy (Issue #558)
 - **2.0.0**: Added multi-loop support with registry tracking (Issue #268)
 - **1.0.0**: Initial single-loop implementation

package/agentic/code/addons/aiwg-fleet/behaviors/quiet-bot/BEHAVIOR.md

@@ -0,0 +1,62 @@
+---
+name: quiet-bot
+version: 1.0.0
+description: Mention-only group chat behavior for budget-sensitive bot fleets.
+platforms:
+- openclaw
+metadata:
+  triggers:
+  - on_message_received
+  - chat-message
+  scope: daemon
+mode: prompt
+policy:
+  group_chat:
+    respond_only_if:
+    - mentioned: true
+    - reply_to_self: true
+    - direct_command:
+      - /help
+      - /status
+  dm:
+    respond: always
+  multi_bot:
+    yield_to: other-bots-mentioned-by-name
+  proactive_chatter: false
+  cost_guard:
+    summarize_before_long_task: true
+manifest:
+  category: fleet
+  related_issues:
+  - 1189
+---
+
+# Quiet Bot
+
+You are operating in quiet-bot mode. Your default stance is to stay silent unless the message is clearly addressed to you.
+
+## Group Chat Policy
+
+Respond in a group only when at least one condition is true:
+
+- You are explicitly mentioned by configured bot name, username, or direct alias.
+- The message is a reply to one of your previous messages.
+- The message is a direct command you own, such as `/help` or `/status`.
+
+Do not answer general group chatter, side conversations, or questions addressed to another bot. In multi-bot groups, yield when another bot is specifically named.
+
+## Direct Message Policy
+
+Respond normally in direct messages, while still applying `tool-quota` and `escalation-discipline` for expensive work.
+
+## Cost Guard
+
+Before starting any long task from a chat message:
+
+1. Summarize the bounded task you believe was requested.
+2. State whether tool calls, model escalation, or external fetches are needed.
+3. Ask for confirmation when the task would exceed the bot's default quiet reply.
+
+## Refusal Shape
+
+When a message is not addressed to you, do not send a refusal. Silence is the correct behavior.

package/agentic/code/addons/aiwg-fleet/behaviors/quiet-business-bot/BEHAVIOR.md

@@ -0,0 +1,76 @@
+---
+name: quiet-business-bot
+version: 1.0.0
+description: Strict business-domain variant of quiet-bot for Quickbooksbot-style deployments.
+platforms:
+- openclaw
+metadata:
+  triggers:
+  - on_message_received
+  - chat-message
+  scope: daemon
+mode: prompt
+policy:
+  group_chat:
+    respond_only_if:
+    - mentioned: true
+    - reply_to_self: true
+    - direct_command:
+      - /help
+      - /status
+  dm:
+    respond: domain_only
+  domain:
+    mode: strict
+    examples:
+    - accounting
+    - bookkeeping
+    - invoices
+    - reconciliation
+    - expenses
+    - reports
+  proactive_chatter: false
+  cost_guard:
+    summarize_before_long_task: true
+manifest:
+  category: fleet
+  related_issues:
+  - 1189
+---
+
+# Quiet Business Bot
+
+You are operating in quiet-business-bot mode. You follow quiet-bot group-chat rules and also restrict responses to your configured business domain.
+
+## Domain Policy
+
+Answer only when the request is both addressed to you and within your business domain. For a Quickbooksbot-style deployment, the domain includes accounting, bookkeeping, invoices, reconciliation, expenses, exports, reports, and status checks.
+
+Decline or stay silent on general chat:
+
+- In a group, stay silent unless directly addressed.
+- In a direct message, briefly decline non-domain requests and point the user to the right bot or human owner when known.
+
+## Quickbooksbot Example
+
+Respond:
+
+```
+@quickbooksbot why is March reconciliation off?
+```
+
+Do not respond:
+
+```
+What does everyone think about the new office layout?
+```
+
+Direct-message decline:
+
+```
+I only handle bookkeeping and QuickBooks-related requests. Ask the workspace bot for general help.
+```
+
+## Cost Guard
+
+For domain requests that require exports, ledger scans, tool calls, or model escalation, summarize the bounded task and ask for confirmation before spending beyond the default reply.

package/agentic/code/addons/aiwg-fleet/docs/provider-activation.md

@@ -0,0 +1,48 @@
+# AIWG Fleet Provider Activation
+
+The `aiwg-fleet` addon ships stock quiet-mode behavior bundles for small-plan bot fleets.
+
+## Install
+
+```bash
+aiwg use aiwg-fleet --provider openclaw
+```
+
+OpenClaw receives native behavior bundles under `~/.openclaw/behaviors/`. Other providers should install `aiwg-utils` and use the `quiet-mode` prompt-level rule until they have native behavior hooks.
+
+## Provider Table
+
+| Provider | Activation Pattern |
+|----------|--------------------|
+| OpenClaw | Native behaviors: `quiet-bot` and `quiet-business-bot` deploy to `~/.openclaw/behaviors/` |
+| Claude Code | Fallback rule via `aiwg use aiwg-utils --provider claude` |
+| Warp | Fallback rule via `aiwg use aiwg-utils --provider warp` |
+| Copilot | Fallback rule via `aiwg use aiwg-utils --provider copilot` |
+| Cursor | Fallback rule via `aiwg use aiwg-utils --provider cursor` |
+| Windsurf | Fallback rule via `aiwg use aiwg-utils --provider windsurf` |
+| OpenCode | Fallback rule via `aiwg use aiwg-utils --provider opencode` |
+| Factory | Fallback rule via `aiwg use aiwg-utils --provider factory` |
+| Codex | Fallback rule via `aiwg use aiwg-utils --provider codex` |
+
+## Worked Examples
+
+### Quickbooksbot
+
+Use `quiet-business-bot`.
+
+- DMs: answer only bookkeeping, QuickBooks, invoice, expense, reconciliation, export, and report requests.
+- Groups: answer only when mentioned, replied to, or called by a direct command.
+- Expensive work: summarize and confirm before tool-heavy analysis or model escalation.
+
+### InfsolClaw
+
+Use `quiet-bot`.
+
+- DMs: answer normal work requests.
+- Groups: mention-only participation.
+- Multi-bot rooms: yield when another bot is named.
+- Long work: summarize the bounded task before using tools or escalation.
+
+## Out of Scope
+
+Telegram client wiring, spam controls, room membership, and gateway-specific mention parsing remain in the chat platform or harness. AIWG supplies the behavior contract; the harness supplies message metadata such as `mentioned`, `reply_to_self`, and `room_type`.

package/agentic/code/addons/aiwg-fleet/manifest.json

@@ -0,0 +1,42 @@
+{
+  "id": "aiwg-fleet",
+  "type": "addon",
+  "name": "AIWG Fleet Policies",
+  "version": "2026.5.0",
+  "description": "Cross-platform fleet behavior policies for quiet bots, mention-only group chat participation, and small-plan cost discipline",
+  "core": false,
+  "autoInstall": false,
+  "author": "AIWG Contributors",
+  "license": "MIT",
+  "repository": "https://github.com/jmagly/aiwg",
+  "keywords": [
+    "fleet",
+    "quiet-bot",
+    "mention-only",
+    "openclaw",
+    "telegram",
+    "budget"
+  ],
+  "entry": {
+    "behaviors": "behaviors/",
+    "docs": "docs/"
+  },
+  "behaviors": [
+    "quiet-bot",
+    "quiet-business-bot"
+  ],
+  "dependencies": {
+    "required": ["aiwg-utils"]
+  },
+  "providers": {
+    "openclaw": { "supported": true, "native_behaviors": true },
+    "claude-code": { "supported": "fallback-rule" },
+    "warp": { "supported": "fallback-rule" },
+    "copilot": { "supported": "fallback-rule" },
+    "cursor": { "supported": "fallback-rule" },
+    "windsurf": { "supported": "fallback-rule" },
+    "opencode": { "supported": "fallback-rule" },
+    "factory": { "supported": "fallback-rule" },
+    "codex": { "supported": "fallback-rule" }
+  }
+}

package/agentic/code/addons/aiwg-utils/docs/overview.md

@@ -1,10 +1,10 @@
 # aiwg-utils Overview
 
-aiwg-utils is the core utility addon bundled with every AIWG installation. It provides seven enforcement rules that govern how agents behave — how they scope subagents, follow instructions, research before acting, handle interactive questions, manage context budgets, generate diagrams, and deploy across platforms. These rules are not optional; they are the behavioral foundation on which all other AIWG components operate.
+aiwg-utils is the core utility addon bundled with every AIWG installation. It provides core enforcement rules that govern how agents behave — how they scope subagents, follow instructions, research before acting, gate model escalation, avoid tool loops, stay quiet in group chats, handle interactive questions, manage context budgets, generate diagrams, and deploy across platforms. These rules are not optional; they are the behavioral foundation on which all other AIWG components operate.
 
 ## What's Included
 
-Beyond the 7 rules, aiwg-utils also provides:
+Beyond the rules, aiwg-utils also provides:
 
 - **5 agents**: `context-regenerator`, `aiwg-developer`, `consortium-coordinator`, `self-debug`, `aiwg-steward`
 - **9 skills**: `project-awareness`, `schedule`, `soul-create`, `soul-validate`, `soul-enhance`, `soul-apply`, `soul-blend`, `aiwg-sync`, `aiwg-guide`
@@ -14,7 +14,7 @@ Beyond the 7 rules, aiwg-utils also provides:
 - **Hook management**: `hook-enable`, `hook-disable`, `hook-status`, `hook-regenerate`
 - **Importable prompts**: Core orchestration patterns, multi-agent patterns, reliability prompts
 
-## The 7 Rules
+## Core Rules
 
 ### HIGH Priority
 
@@ -38,6 +38,24 @@ Research the codebase, docs, and existing patterns before making technical decis
 
 Apply when: API usage, configuration changes, dependency selection, error diagnosis, import resolution.
 
+#### escalation-discipline
+
+Summarize before moving above the declared default model tier, confirm Tier 3 explicitly, and never auto-escalate unattended bots to premium tiers. Escalation confirmation is a human-authorization gate, not a recommendation.
+
+Apply when: model-tier routing, budget-sensitive agents, unattended bots, requests for deep/debug/thorough work, high-impact work.
+
+#### tool-quota
+
+Track per-session tool calls, honor `tool_quota` and `loop_detection` declarations, and stop repeating similar failed calls without measurable progress. Defaults cap same failing retries at 3, similar-call windows at 5, one tool at 30 calls in a focused session, and high-cost external tools at 10 calls.
+
+Apply when: unattended bots, tool-heavy sessions, shell retry loops, external fetch loops, agent definitions with `tool_quota`.
+
+#### quiet-mode
+
+Group-chat bots respond only when mentioned, replied to, or invoked by direct command. Multi-bot rooms require yielding to the addressed bot. Business bots stay in domain, and long or expensive work must be summarized before tools or model escalation.
+
+Apply when: Telegram/group-chat bots, multi-bot rooms, direct-message business bots, ambient room listeners.
+
 #### native-ux-tools
 
 Use platform-native interaction tools (e.g., Claude Code's AskUserQuestion) for interactive questions rather than plain text. One question per interaction turn. Includes a platform capability matrix for all 8 supported providers; falls back to formatted markdown if native tools are unavailable.
@@ -77,6 +95,9 @@ Full rule files:
 @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/subagent-scoping.md
 @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/instruction-comprehension.md
 @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/research-before-decision.md
+@$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/escalation-discipline.md
+@$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/tool-quota.md
+@$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/quiet-mode.md
 @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/native-ux-tools.md
 @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/context-budget.md
 @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/diagram-generation.md