diff --git a/README.md b/README.md index 4f31c95..11279eb 100644 --- a/README.md +++ b/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 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