From ddb839be83ee320ce33493702a697ba5b1a7ed7e Mon Sep 17 00:00:00 2001 From: Paul Duvall Date: Thu, 11 Dec 2025 09:20:43 -0500 Subject: [PATCH] docs: update AI assistant examples to widely-used tools MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Update Progressive Disclosure pattern to reference mainstream AI coding assistants instead of less widely-used tools. Changes: - Replace "Aider" with "Codex" and "Gemini" in AI assistant examples - Remove ".aiderules" references - Remove "OpenCode/Zed" reference - Reorder to prioritize widely-used tools: Cursor, then AGENTS.md - Main list now: "Claude Code, Cursor, Codex, Gemini, etc." Focuses pattern on mainstream AI coding assistants while maintaining universal applicability. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 --- experiments/README.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/experiments/README.md b/experiments/README.md index 46654ac..7f2815d 100644 --- a/experiments/README.md +++ b/experiments/README.md @@ -711,7 +711,7 @@ Deploy to database: $1 (default: $STAGING_DB) ### Progressive Disclosure **Maturity**: Intermediate -**Description**: Load AI assistant rules incrementally based on task context rather than bundling all instructions upfront, preventing context bloat and maintaining instruction-following consistency across any AI coding assistant (Claude Code, Cursor, Aider, etc.). +**Description**: Load AI assistant rules incrementally based on task context rather than bundling all instructions upfront, preventing context bloat and maintaining instruction-following consistency across any AI coding assistant (Claude Code, Cursor, Codex, Gemini, etc.). **Related Patterns**: [Codified Rules](../README.md#codified-rules), [Context Optimization](#context-optimization), [Custom Commands](#custom-commands), [Event Automation](#event-automation) @@ -726,18 +726,18 @@ Deploy to database: $1 (default: $STAGING_DB) - Cognitive overload for the AI - Slower response times from processing unnecessary context -**Example of bloat**: A 500-line configuration file (CLAUDE.md, AGENTS.md, .cursorrules, .aiderules, etc.) with security rules, deployment procedures, architecture patterns, testing standards, code style guides, API conventions, database migration rules, monitoring setup, and team workflows—but only 10% is relevant to any single task. +**Example of bloat**: A 500-line configuration file (CLAUDE.md, AGENTS.md, .cursorrules, etc.) with security rules, deployment procedures, architecture patterns, testing standards, code style guides, API conventions, database migration rules, monitoring setup, and team workflows—but only 10% is relevant to any single task. #### Implementation Strategy **Three-tier rule architecture:** -This pattern works with any AI assistant configuration file. Examples shown use CLAUDE.md, but apply equally to AGENTS.md (OpenCode/Zed), .cursorrules (Cursor), .aiderules (Aider), or other AI coding assistant configuration files. +This pattern works with any AI assistant configuration file. Examples shown use CLAUDE.md, but apply equally to .cursorrules (Cursor), AGENTS.md, or other AI coding assistant configuration files (Codex, Gemini, etc.). ``` .ai/ ├── CLAUDE.md # Main rules file: Universal rules only (<60 lines) -│ # (or AGENTS.md, .cursorrules, .aiderules, etc.) +│ # (or AGENTS.md, .cursorrules, etc.) ├── rules/ # Specialized rules loaded on-demand │ ├── security/ │ │ ├── secrets.md # Load when: editing .env, credentials @@ -764,7 +764,7 @@ This pattern works with any AI assistant configuration file. Examples shown use **Keep it minimal** - only universally applicable rules. -This example uses CLAUDE.md, but the same structure applies to AGENTS.md, .cursorrules, .aiderules, or any AI assistant configuration file: +This example uses CLAUDE.md, but the same structure applies to AGENTS.md, .cursorrules, or any AI assistant configuration file: ```markdown # AI Development Rules @@ -1054,7 +1054,7 @@ cat .ai/context-usage.log | grep -oE "rules/[^/]+/[^ ]+" | sort | uniq -c | sort ```markdown # AI Configuration File - WRONG APPROACH (500+ lines) -# (applies to CLAUDE.md, AGENTS.md, .cursorrules, .aiderules, etc.) +# (applies to CLAUDE.md, AGENTS.md, .cursorrules, etc.) ## Security Rules (100 lines) - Secret management for .env files