@vibe-agent-toolkit/vat-example-cat-agents 0.1.13 → 0.1.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -52,8 +52,8 @@ Trigger this skill when:
52
52
  Use when user has a straightforward request that maps to one agent.
53
53
 
54
54
  **Example workflows:**
55
- - "What cat breed should I get?" → [breed-advisor](breed-advisor.md)
56
- - "Analyze this cat photo" → [photo-analyzer](photo-analyzer.md)
55
+ - "What cat breed should I get?" → [breed-advisor](resources/breed-advisor.md)
56
+ - "Analyze this cat photo" → [photo-analyzer](resources/photo-analyzer.md)
57
57
  - "Is this a valid haiku?" → haiku-validator (pure function)
58
58
 
59
59
  ### Pattern 2: Sequential Pipeline (Multi-Agent)
@@ -62,11 +62,11 @@ Use when output of one agent feeds into another.
62
62
 
63
63
  **Example workflows:**
64
64
  1. Photo → Characteristics → Name
65
- - [photo-analyzer](photo-analyzer.md) → [name-generator](name-generator.md)
65
+ - [photo-analyzer](resources/photo-analyzer.md) → [name-generator](resources/name-generator.md)
66
66
  2. Photo → Characteristics → Haiku
67
- - [photo-analyzer](photo-analyzer.md) → [haiku-generator](haiku-generator.md)
67
+ - [photo-analyzer](resources/photo-analyzer.md) → [haiku-generator](resources/haiku-generator.md)
68
68
  3. Description → Characteristics → Name → Validation
69
- - [description-parser](description-parser.md) → [name-generator](name-generator.md) → name-validator
69
+ - [description-parser](resources/description-parser.md) → [name-generator](resources/name-generator.md) → name-validator
70
70
 
71
71
  ### Pattern 3: Generate-Validate Loop (Iterative)
72
72
 
@@ -75,10 +75,10 @@ Use when generator produces content that needs validation with retry logic.
75
75
  **Example workflows:**
76
76
  1. Name generation with validation
77
77
  - Generate → Validate → If invalid, retry with feedback
78
- - Uses: [name-generator](name-generator.md) + name-validator
78
+ - Uses: [name-generator](resources/name-generator.md) + name-validator
79
79
  2. Haiku generation with validation
80
80
  - Generate → Validate → If invalid, retry
81
- - Uses: [haiku-generator](haiku-generator.md) + haiku-validator
81
+ - Uses: [haiku-generator](resources/haiku-generator.md) + haiku-validator
82
82
 
83
83
  **Orchestration tip:** Generator agents have NO knowledge of validation rules. This is intentional - forces iteration and tests feedback loops.
84
84
 
@@ -88,7 +88,7 @@ Use when decision requires human judgment.
88
88
 
89
89
  **Example workflows:**
90
90
  1. Breed application approval
91
- - Gather info → Generate application → [human-approval](human-approval.md) → Process result
91
+ - Gather info → Generate application → [human-approval](resources/human-approval.md) → Process result
92
92
  2. Name approval before finalization
93
93
  - Generate names → Present options → Human selects → Finalize
94
94
 
@@ -98,10 +98,10 @@ Use when decision requires human judgment.
98
98
 
99
99
  **When:** User wants help finding the right cat breed.
100
100
 
101
- **Agent:** [breed-advisor](breed-advisor.md)
101
+ **Agent:** [breed-advisor](resources/breed-advisor.md)
102
102
 
103
103
  **Orchestration strategy:**
104
- 1. **Phase 1 - Gathering** (see [Conversation Strategy](breed-advisor.md#conversation-strategy))
104
+ 1. **Phase 1 - Gathering** (see [Conversation Strategy](resources/breed-advisor.md#conversation-strategy))
105
105
  - Collect ≥4 factors including music preference
106
106
  - ONE question at a time (don't bombard)
107
107
  - Extract factors after each turn
@@ -117,15 +117,15 @@ Use when decision requires human judgment.
117
117
  - Conclude gracefully
118
118
  - Provide next steps or exit instruction
119
119
 
120
- **Critical factor:** Music preference is the PRIMARY compatibility factor. Ask early, use as conversation anchor. See [Music Preference Insight](breed-advisor.md#music-preference-insight) for mappings.
120
+ **Critical factor:** Music preference is the PRIMARY compatibility factor. Ask early, use as conversation anchor. See [Music Preference Insight](resources/breed-advisor.md#music-preference-insight) for mappings.
121
121
 
122
- **Reference implementation:** See [cat-breed-selection.md](cat-breed-selection.md) for detailed breed selection orchestration.
122
+ **Reference implementation:** See [cat-breed-selection.md](resources/cat-breed-selection.md) for detailed breed selection orchestration.
123
123
 
124
124
  ### Workflow B: Photo Analysis Pipeline
125
125
 
126
126
  **When:** User provides a cat photo and wants analysis, name, or haiku.
127
127
 
128
- **Agents:** [photo-analyzer](photo-analyzer.md) → [name-generator](name-generator.md) OR [haiku-generator](haiku-generator.md)
128
+ **Agents:** [photo-analyzer](resources/photo-analyzer.md) → [name-generator](resources/name-generator.md) OR [haiku-generator](resources/haiku-generator.md)
129
129
 
130
130
  **Orchestration strategy:**
131
131
 
@@ -154,7 +154,7 @@ Optional Step 3: Validate
154
154
 
155
155
  **When:** User describes a cat in text (no photo).
156
156
 
157
- **Agents:** [description-parser](description-parser.md) → [name-generator](name-generator.md) OR [haiku-generator](haiku-generator.md)
157
+ **Agents:** [description-parser](resources/description-parser.md) → [name-generator](resources/name-generator.md) OR [haiku-generator](resources/haiku-generator.md)
158
158
 
159
159
  **Orchestration strategy:**
160
160
 
@@ -210,14 +210,14 @@ throw new Error('Could not generate valid content after 3 attempts');
210
210
  - ~60-70% initial rejection rate forces iteration
211
211
 
212
212
  **Agents using this pattern:**
213
- - [name-generator](name-generator.md) + name-validator
214
- - [haiku-generator](haiku-generator.md) + haiku-validator
213
+ - [name-generator](resources/name-generator.md) + name-validator
214
+ - [haiku-generator](resources/haiku-generator.md) + haiku-validator
215
215
 
216
216
  ### Workflow E: HITL Approval Gate
217
217
 
218
218
  **When:** Decision requires human judgment (compliance, taste, ethics).
219
219
 
220
- **Agent:** [human-approval](human-approval.md)
220
+ **Agent:** [human-approval](resources/human-approval.md)
221
221
 
222
222
  **Orchestration strategy:**
223
223
 
@@ -504,30 +504,30 @@ Good: "What's your favorite type of music?" → [response] → "Great! Tell me a
504
504
  - haiku-validator (no agent resource - pure TypeScript logic)
505
505
 
506
506
  ### One-Shot LLM Analyzers
507
- - [Photo Analyzer](photo-analyzer.md) - Vision analysis
508
- - [Description Parser](description-parser.md) - Text parsing
509
- - [Name Generator](name-generator.md) - Creative naming
510
- - [Haiku Generator](haiku-generator.md) - Haiku composition
507
+ - [Photo Analyzer](resources/photo-analyzer.md) - Vision analysis
508
+ - [Description Parser](resources/description-parser.md) - Text parsing
509
+ - [Name Generator](resources/name-generator.md) - Creative naming
510
+ - [Haiku Generator](resources/haiku-generator.md) - Haiku composition
511
511
 
512
512
  ### Conversational Assistant
513
- - [Breed Advisor](breed-advisor.md) - Multi-turn breed selection
514
- - [Welcome Message](breed-advisor.md#welcome-message)
515
- - [Music Preference Insight](breed-advisor.md#music-preference-insight)
516
- - [Factor Definitions](breed-advisor.md#factor-definitions)
517
- - [Conversation Strategy](breed-advisor.md#conversation-strategy)
518
- - [Factor Extraction Prompt](breed-advisor.md#factor-extraction-prompt)
519
- - [Transition Message](breed-advisor.md#transition-message)
520
- - [Recommendation Presentation](breed-advisor.md#recommendation-presentation-prompt)
521
- - [Selection Extraction](breed-advisor.md#selection-extraction-prompt)
522
- - [Conclusion Prompt](breed-advisor.md#conclusion-prompt)
513
+ - [Breed Advisor](resources/breed-advisor.md) - Multi-turn breed selection
514
+ - [Welcome Message](resources/breed-advisor.md#welcome-message)
515
+ - [Music Preference Insight](resources/breed-advisor.md#music-preference-insight)
516
+ - [Factor Definitions](resources/breed-advisor.md#factor-definitions)
517
+ - [Conversation Strategy](resources/breed-advisor.md#conversation-strategy)
518
+ - [Factor Extraction Prompt](resources/breed-advisor.md#factor-extraction-prompt)
519
+ - [Transition Message](resources/breed-advisor.md#transition-message)
520
+ - [Recommendation Presentation](resources/breed-advisor.md#recommendation-presentation-prompt)
521
+ - [Selection Extraction](resources/breed-advisor.md#selection-extraction-prompt)
522
+ - [Conclusion Prompt](resources/breed-advisor.md#conclusion-prompt)
523
523
 
524
524
  ### External Event Integrator
525
- - [Human Approval](human-approval.md) - HITL approval gate
525
+ - [Human Approval](resources/human-approval.md) - HITL approval gate
526
526
 
527
527
  ### Related Documentation
528
- - [Cat Breed Selection Skill](cat-breed-selection.md) - Detailed breed advisor orchestration
528
+ - [Cat Breed Selection Skill](resources/cat-breed-selection.md) - Detailed breed advisor orchestration
529
529
  - Package README - Human-facing documentation
530
- - Package Structure - Technical organization
530
+ - [Package Structure](resources/structure.md) - Technical organization
531
531
 
532
532
  ## Success Criteria
533
533