Add contains-studio/agents attribution and PROACTIVELY auto-triggering documentation

README.md

@@ -359,10 +359,13 @@ claude
 
 ### Auto-Triggering Agents
 
-Enable automatic test writing when code changes:
+This suite supports **two auto-triggering mechanisms**:
+
+#### Method 1: Hooks-Based (Our Implementation)
+
+Configure hooks.json for automatic agent invocation:
 
 ```bash
-# Configure hooks
 cat > ~/.claude/hooks.json << 'EOF'
 {
   "userPromptSubmitHook": "test-writer-fixer@agent",
@@ -371,6 +374,33 @@ cat > ~/.claude/hooks.json << 'EOF'
 EOF
 ```
 
+#### Method 2: PROACTIVELY Keyword (Contains Studio Pattern)
+
+Agents with `PROACTIVELY` in their description automatically trigger based on context:
+
+```yaml
+---
+name: studio-coach
+description: PROACTIVELY use this agent when complex multi-agent tasks begin...
+---
+```
+
+**The 4 Proactive Agents:**
+1. **studio-coach** - Triggers on complex multi-agent tasks
+2. **test-writer-fixer** - Triggers after code modifications
+3. **whimsy-injector** - Triggers after UI/UX changes
+4. **experiment-tracker** - Triggers when feature flags are added
+
+This method requires no hooks.json - Claude Code's built-in agent selection system detects the PROACTIVELY keyword and automatically invokes agents when matching conditions occur.
+
+**Key Differences:**
+| Feature | Hooks-Based | PROACTIVELY Keyword |
+|---------|-------------|---------------------|
+| Configuration | hooks.json file | Built into agent description |
+| Trigger Scope | Global events | Context-aware conditions |
+| Flexibility | Manual setup | Self-documenting |
+| Detection | File/tool operations | Semantic context |
+
 ### Custom Model Selection
 
 Use specific models for different tasks:
@@ -402,6 +432,11 @@ This customization suite is built upon excellent open-source projects and commun
 
 ### Core Inspiration
 
+- **[contains-studio/agents](https://github.com/contains-studio/agents)** by [contains-studio](https://github.com/contains-studio)
+  - 37 specialized agents with PROACTIVELY auto-triggering system
+  - Inspired rich example format with <commentary> tags and 500+ word system prompts
+  - Source of studio-coach coordination patterns and department-based organization
+
 - **[claude-codex-settings](https://github.com/fcakyon/claude-codex-settings)** by [fcakyon](https://github.com/fcakyon)
   - Comprehensive Claude Code settings and MCP configurations
   - Foundation for MCP tool integration patterns