aiwg 2026.2.3 → 2026.2.5

package/CLAUDE.md

@@ -1,4 +1,4 @@
-# AI Writing Guide
+# AIWG
 
 Framework for improving AI-generated content quality with voice profiles, validation tools, and specialized agents.
 
@@ -304,8 +304,11 @@ Apply mitigations for known LLM failure archetypes: hallucination, context loss,
 
 ### Rules Reference
 
-Full rule documentation: `agentic/code/frameworks/sdlc-complete/rules/`
-Manifest: `agentic/code/frameworks/sdlc-complete/rules/manifest.json`
+Rules deploy as a single consolidated `RULES-INDEX.md` (~200 lines) instead of 31 individual files (~9,321 lines). The index contains summaries with @-links to full rule files for on-demand loading.
+
+- Consolidated index: `agentic/code/frameworks/sdlc-complete/rules/RULES-INDEX.md`
+- Full rule files: `agentic/code/frameworks/sdlc-complete/rules/`
+- Manifest: `agentic/code/frameworks/sdlc-complete/rules/manifest.json`
 
 ## Commit and Output Conventions
 
@@ -335,8 +338,8 @@ aiwg doctor
 ## Support
 
 - **Website**: https://aiwg.io
-- **Repository**: https://github.com/jmagly/ai-writing-guide
-- **Issues**: https://github.com/jmagly/ai-writing-guide/issues
+- **Repository**: https://github.com/jmagly/aiwg
+- **Issues**: https://github.com/jmagly/aiwg/issues
 - **Discord**: https://discord.gg/BuAusFMxdA
 - **Telegram**: https://t.me/+oJg9w2lE6A5lOGFh
 
@@ -344,9 +347,18 @@ aiwg doctor
 
 <!-- TEAM DIRECTIVES: Add project-specific guidance below this line -->
 
+## Context Window Configuration (Optional)
+
+<!-- Uncomment and set if running on a local/GPU system with limited context.
+     This guides parallel subagent limits and compaction aggressiveness.
+     Leave commented out for Anthropic cloud systems (1M+ context).
+     See @.claude/rules/context-budget.md for the full lookup table. -->
+
+<!-- AIWG_CONTEXT_WINDOW: 100000 -->
+
 ## What AIWG Is
 
-**AI Writing Guide (AIWG)** is a framework that provides AI coding assistants with structured workflows, specialized agents, and artifact management. It's not just documentation - it's an operational system that:
+**AIWG** is a framework that provides AI coding assistants with structured workflows, specialized agents, and artifact management. It's not just documentation - it's an operational system that:
 
 1. **Deploys agents** - Specialized AI personas (Test Engineer, Security Auditor, etc.) with defined tools and expertise
 2. **Manages artifacts** - All project documents (requirements, architecture, tests) live in `.aiwg/`

package/README.md

@@ -12,7 +12,7 @@ aiwg use sdlc        # deploy SDLC framework
 [![npm version](https://img.shields.io/npm/v/aiwg/latest?label=npm&color=CB3837&logo=npm&style=flat-square)](https://www.npmjs.com/package/aiwg)
 [![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/ai-writing-guide?style=flat-square)](https://github.com/jmagly/ai-writing-guide/stargazers)
+[![GitHub Stars](https://img.shields.io/github/stars/jmagly/ai-writing-guide?style=flat-square)](https://github.com/jmagly/aiwg/stargazers)
 
 [**Get Started**](#-quick-start) · [**Documentation**](#-documentation) · [**Examples**](examples/) · [**Contributing**](CONTRIBUTING.md) · [**Community**](#-community--support)
 
@@ -265,7 +265,7 @@ AIWG's unified extension system enables dynamic discovery, semantic search, and
 We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 **Quick contributions:**
-- Found an AI pattern? [Open an issue](https://github.com/jmagly/ai-writing-guide/issues/new)
+- Found an AI pattern? [Open an issue](https://github.com/jmagly/aiwg/issues/new)
 - Have a better rewrite? Submit a PR to `examples/`
 - Want to add an agent? Use `docs/development/agent-template.md`
 
@@ -276,8 +276,8 @@ We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 - 🌐 **Website:** [aiwg.io](https://aiwg.io)
 - 💬 **Discord:** [Join Server](https://discord.gg/BuAusFMxdA)
 - 📱 **Telegram:** [Join Group](https://t.me/+oJg9w2lE6A5lOGFh)
-- 🐛 **Issues:** [GitHub Issues](https://github.com/jmagly/ai-writing-guide/issues)
-- 💡 **Discussions:** [GitHub Discussions](https://github.com/jmagly/ai-writing-guide/discussions)
+- 🐛 **Issues:** [GitHub Issues](https://github.com/jmagly/aiwg/issues)
+- 💡 **Discussions:** [GitHub Discussions](https://github.com/jmagly/aiwg/discussions)
 
 ---
 
@@ -329,7 +329,7 @@ Custom AI and blockchain solutions for the digital age.
 </tr>
 </table>
 
-**Interested in sponsoring?** [Contact us](https://github.com/jmagly/ai-writing-guide/discussions)
+**Interested in sponsoring?** [Contact us](https://github.com/jmagly/aiwg/discussions)
 
 ---
 

package/USAGE_GUIDE.md

@@ -1,4 +1,4 @@
-# AI Writing Guide - Usage Guide
+# AIWG - Usage Guide
 
 ## Installation Options
 

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

@@ -8,7 +8,7 @@
   "autoInstall": false,
   "author": "AIWG Contributors",
   "license": "MIT",
-  "repository": "https://github.com/jmagly/ai-writing-guide",
+  "repository": "https://github.com/jmagly/aiwg",
   "keywords": [
     "aiwg",
     "evals",

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

@@ -8,7 +8,7 @@
   "autoInstall": false,
   "author": "AIWG Contributors",
   "license": "MIT",
-  "repository": "https://github.com/jmagly/ai-writing-guide",
+  "repository": "https://github.com/jmagly/aiwg",
   "keywords": [
     "aiwg",
     "hooks",

package/agentic/code/addons/aiwg-utils/agents/aiwg-developer.md

@@ -7,7 +7,7 @@ tools: Read, Write, MultiEdit, Bash, WebFetch, Glob, Grep
 
 # AIWG Developer Agent
 
-Expert in AIWG (AI Writing Guide) architecture, patterns, and development. Assists users in creating, extending, and customizing AIWG components.
+Expert in AIWG architecture, patterns, and development. Assists users in creating, extending, and customizing AIWG components.
 
 ## Domain Expertise
 

package/agentic/code/addons/aiwg-utils/commands/aiwg-regenerate-agents.md

@@ -115,7 +115,7 @@ docs/          → Documentation
 
 ## AIWG Framework
 
-This project uses the AI Writing Guide (AIWG) SDLC framework for software development workflows.
+This project uses the AIWG SDLC framework for software development workflows.
 
 ### Available Agents
 

package/agentic/code/addons/aiwg-utils/commands/commit-and-push.md

@@ -483,7 +483,7 @@ git push
 
 ## Project-Specific Conventions
 
-### AI Writing Guide Project
+### AIWG Project
 
 **Common Scopes**:
 - `agents`: SDLC agent definitions

package/agentic/code/addons/aiwg-utils/commands/roko-voice.md

@@ -397,4 +397,4 @@ Before finalizing output, verify:
 
 **Command Version**: 1.0
 **Voice Reference**: ROKO Network - Technical Mythology for Protocol Age
-**Maintained By**: AI Writing Guide Team
+**Maintained By**: AIWG Team

package/agentic/code/addons/aiwg-utils/commands/summarize-transcript.md

@@ -310,4 +310,4 @@ TL;DR
 
 **Template Version**: 1.0
 **Based On**: Roko Dev Community Update (Oct 7 & 9, 2025)
-**Maintained By**: AI Writing Guide Team
+**Maintained By**: AIWG Team

package/agentic/code/addons/aiwg-utils/commands/workspace-reset.md

@@ -201,7 +201,7 @@ mkdir -p .aiwg/{intake,requirements,architecture,planning,risks,testing,security
 cat > .aiwg/README.md <<'EOF'
 # AIWG Workspace
 
-This directory contains SDLC artifacts managed by the AI Writing Guide framework.
+This directory contains SDLC artifacts managed by the AIWG framework.
 
 ## Structure
 

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

@@ -8,7 +8,7 @@
   "autoInstall": true,
   "author": "AIWG Contributors",
   "license": "MIT",
-  "repository": "https://github.com/jmagly/ai-writing-guide",
+  "repository": "https://github.com/jmagly/aiwg",
   "keywords": [
     "aiwg",
     "utilities",

package/agentic/code/addons/aiwg-utils/rules/agent-deployment.md

@@ -18,7 +18,7 @@ These rules apply when working with agent definitions and multi-provider deploym
 
 **General-Purpose Writing Agents** (`agentic/code/agents/`):
 - `writing-validator` - Validates voice consistency and authenticity
-- `prompt-optimizer` - Enhances prompts using AI Writing Guide principles
+- `prompt-optimizer` - Enhances prompts using AIWG principles
 - `content-diversifier` - Generates varied examples and perspectives
 
 **SDLC Framework Agents** (`agentic/code/frameworks/sdlc-complete/agents/`):

package/agentic/code/addons/aiwg-utils/rules/context-budget.md

@@ -0,0 +1,230 @@
+# Context Window Budget Rules
+
+**Enforcement Level**: MEDIUM
+**Scope**: All parallel subagent spawning and task scheduling
+**Addon**: aiwg-utils (core, universal)
+
+## Overview
+
+When `AIWG_CONTEXT_WINDOW` is set in CLAUDE.md (or equivalent platform context file), agents MUST respect the declared context budget when deciding how many parallel subagents to spawn and how aggressively to compact context.
+
+This directive is **opt-in**. When unset, behavior is unchanged and the platform decides parallelism limits. When set, it provides guidance for systems with smaller context windows (e.g., local GPU inference with 100k-256k context) where unconstrained parallel spawning causes client crashes.
+
+## How to Configure
+
+Users add the following directive to their CLAUDE.md team directives section (or equivalent for their platform):
+
+```markdown
+<!-- AIWG_CONTEXT_WINDOW: 100000 -->
+```
+
+The value is the total context window size in tokens. Common values:
+
+| System | Typical Context Window |
+|--------|----------------------|
+| Local GPU (small) | 32,000-64,000 |
+| Local GPU (medium) | 100,000-128,000 |
+| Local GPU (large) | 200,000-256,000 |
+| Cloud API (standard) | 200,000-500,000 |
+| Anthropic cloud | 1,000,000+ |
+
+## Mandatory Rules
+
+### Rule 1: Check for AIWG_CONTEXT_WINDOW Before Parallel Spawning
+
+Before spawning multiple subagents in parallel, check whether `AIWG_CONTEXT_WINDOW` is declared in the project's context file.
+
+**If unset**: No change to default behavior. Spawn as many parallel subagents as the task decomposition requires.
+
+**If set**: Use the lookup table below to determine the maximum number of concurrent parallel subagents.
+
+### Rule 2: Parallel Subagent Limits
+
+When `AIWG_CONTEXT_WINDOW` is set, respect these limits:
+
+| Context Window | Max Parallel Subagents | Compaction Behavior |
+|----------------|----------------------|---------------------|
+| Unset (default) | No limit (platform decides) | Normal |
+| ≤64k | 1-2 | Aggressive — prefer sequential |
+| 65k-128k | 2-4 | Moderate — batch in groups of 2-3 |
+| 129k-256k | 4-8 | Standard |
+| 257k-512k | 8-12 | Relaxed |
+| >512k | 12-20 | Normal (cloud default) |
+
+**Formula**: `max_parallel = max(1, floor(context_window / 50000))` capped at 20.
+
+**Important**: This limits how many subagents run *concurrently*, not the total number of subagents an orchestrator can spawn. If a task decomposes into 20 atomic subtasks but the budget allows only 3 parallel, run them in waves of 3.
+
+### Rule 3: Prefer Sequential Batching When Budget Is Tight
+
+When context budget is ≤128k tokens:
+
+**FORBIDDEN**:
+```
+Task decomposes into 10 subtasks.
+Spawn all 10 subagents simultaneously.
+→ Client crashes or context overflow
+```
+
+**REQUIRED**:
+```
+Task decomposes into 10 subtasks.
+Context budget allows 2-3 parallel.
+
+Wave 1: Subagents 1, 2, 3 (parallel)
+  → Wait for completion
+Wave 2: Subagents 4, 5, 6 (parallel)
+  → Wait for completion
+Wave 3: Subagents 7, 8, 9 (parallel)
+  → Wait for completion
+Wave 4: Subagent 10
+  → Done
+```
+
+### Rule 4: Keep Individual Subagent Tasks Smaller Under Tight Budgets
+
+When context budget is constrained, each subagent should produce less output to avoid accumulating too much context in the parent agent's window.
+
+| Context Window | Target Output Per Subagent |
+|----------------|--------------------------|
+| ≤64k | <3k tokens |
+| 65k-128k | <5k tokens |
+| 129k-256k | <10k tokens |
+| >256k | Normal (no specific limit) |
+
+### Rule 5: This Is Guidance, Not Programmatic Enforcement
+
+These rules operate at the prompt/convention level. There is no runtime system that enforces them. Agents are expected to read the directive and adjust their behavior accordingly. The rules provide clear lookup tables so the agent can make the right decision without complex reasoning.
+
+## Compaction Guidance
+
+### Aggressive Compaction (≤64k)
+
+- Run subagents sequentially or in pairs
+- Summarize subagent results before spawning the next batch
+- Prefer returning concise structured data (JSON, tables) over prose
+- Each subagent task should be self-contained with minimal context
+
+### Moderate Compaction (65k-128k)
+
+- Batch subagents in groups of 2-3
+- Wait for each batch to complete before starting the next
+- Keep subagent output focused — specify word/token limits in the task description
+- Summarize intermediate results when aggregating across batches
+
+### Standard Operation (129k-256k)
+
+- Parallel fan-out up to 4-8 subagents
+- Normal output expectations
+- Standard context management
+
+### Relaxed/Normal (>256k)
+
+- Full parallel fan-out as task decomposition dictates
+- No special compaction needed
+- Standard behavior as if directive is unset
+
+## Integration
+
+### With Subagent Scoping Rules
+
+This rule extends `@.claude/rules/subagent-scoping.md` Rule 7 (Context Budget Estimation). When `AIWG_CONTEXT_WINDOW` is set, the context budget formula uses the declared value instead of assuming a default window size.
+
+### With Ralph Loops
+
+Ralph loops that spawn parallel subagents (e.g., via `rlm-batch` or `parallel-dispatch`) should batch subagent waves according to the context budget table. A Ralph loop on a 100k system should run 2-3 subagents per wave, not 10.
+
+### With Orchestrator Fan-Out
+
+Orchestrator patterns that decompose tickets into N subtasks should cap concurrent fan-out to the budget limit. All N subtasks still execute — just in sequential waves rather than all at once.
+
+## Examples
+
+### Example 1: Local GPU System (100k Context)
+
+```markdown
+<!-- In CLAUDE.md team directives -->
+<!-- AIWG_CONTEXT_WINDOW: 100000 -->
+```
+
+Agent receives task requiring 8 parallel subagents:
+
+```
+Context budget: 100k → max_parallel = max(1, floor(100000/50000)) = 2
+Compaction: Moderate
+
+Wave 1: Subagents 1, 2 (parallel)
+Wave 2: Subagents 3, 4 (parallel)
+Wave 3: Subagents 5, 6 (parallel)
+Wave 4: Subagents 7, 8 (parallel)
+
+Each subagent targets <5k output tokens.
+```
+
+### Example 2: Cloud System (No Directive)
+
+```markdown
+<!-- No AIWG_CONTEXT_WINDOW set -->
+```
+
+Agent receives task requiring 8 parallel subagents:
+
+```
+No budget constraint. Spawn all 8 in parallel.
+Normal output expectations.
+```
+
+### Example 3: Small Local Model (32k Context)
+
+```markdown
+<!-- AIWG_CONTEXT_WINDOW: 32000 -->
+```
+
+Agent receives task requiring 5 parallel subagents:
+
+```
+Context budget: 32k → max_parallel = max(1, floor(32000/50000)) = 1
+Compaction: Aggressive — fully sequential
+
+Run subagents 1 through 5 sequentially.
+Each subagent targets <3k output tokens.
+Summarize each result before proceeding to next.
+```
+
+## Platform Applicability
+
+This directive works across all AIWG-supported platforms:
+
+| Platform | Where to Set |
+|----------|-------------|
+| Claude Code | `CLAUDE.md` team directives |
+| GitHub Copilot | `.github/copilot-instructions.md` |
+| OpenAI Codex | `~/.codex/instructions.md` or `AGENTS.md` |
+| Cursor | `.cursor/rules/` |
+| Warp | `WARP.md` |
+| Factory AI | `.factory/` context |
+| OpenCode | `.opencode/` context |
+| Windsurf | `AGENTS.md` or `.windsurf/rules/` |
+
+The `aiwg use` and `aiwg regenerate` commands will include the directive (commented out) in generated context files when scaffolding new projects.
+
+## Checklist
+
+Before spawning parallel subagents:
+
+- [ ] Check if `AIWG_CONTEXT_WINDOW` is declared in the project context
+- [ ] If set, look up the max parallel count from the table
+- [ ] If parallel count exceeds budget, batch into sequential waves
+- [ ] Adjust subagent output expectations based on budget tier
+- [ ] If unset, proceed with normal parallel behavior
+
+## References
+
+- @.claude/rules/subagent-scoping.md - Subagent scoping and delegation rules
+- @.claude/rules/subagent-scoping.md#rule-7 - Context budget estimation
+- @.claude/rules/instruction-comprehension.md - Understanding user constraints
+
+---
+
+**Rule Status**: ACTIVE
+**Last Updated**: 2026-02-09