Skip to content

Commit 29f58ab

Browse files
gouravjshahclaude
andcommitted
docs: Add comprehensive fleet documentation and RCA examples
Add detailed documentation for AgentFleet multi-agent coordination: - docs/concepts/fleets.md: Complete guide to fleets including: - 4 coordination modes (peer, hierarchical, pipeline, swarm) - 4 consensus algorithms (majority, unanimous, weighted, first_wins) - Task distribution strategies - Fleet vs single agent comparison with cost analysis - Real-world examples (code review, incident response, data pipeline) Add RCA (Root Cause Analysis) tutorial and examples: - docs/tutorials/rca-fleet.md: Step-by-step tutorial for building RCA fleets - examples/fleets/application-rca-team.yaml: Application-level RCA with 4 specialists - examples/fleets/database-rca-team.yaml: Database-specific RCA (PostgreSQL/MySQL) Update navigation and documentation index: - docusaurus-site/sidebars.ts: Add Advanced Concepts section and RCA tutorial - docs/DOCUMENTATION_INDEX.md: Update with new docs and mark fleet tutorial complete 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 3b48067 commit 29f58ab

File tree

6 files changed

+1487
-6
lines changed

6 files changed

+1487
-6
lines changed

docs/DOCUMENTATION_INDEX.md

Lines changed: 24 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,14 @@ Complete documentation for the Agentic Ops Framework (AOF).
2323
- Models - Multi-provider support
2424
- Memory - Context persistence
2525

26+
### Advanced Concepts
27+
- **[AgentFleet: Multi-Agent Coordination](concepts/fleets.md)** - Deep dive into fleets
28+
- Why use fleets in DevOps (consensus, parallel execution, specialization)
29+
- 4 coordination modes (peer, hierarchical, pipeline, swarm)
30+
- 4 consensus algorithms (majority, unanimous, weighted, first_wins)
31+
- Fleet vs single agent comparison
32+
- Real-world examples (code review, incident response, data pipeline)
33+
2634
### Tutorials (Step-by-Step)
2735
1. **[Build Your First Agent](tutorials/first-agent.md)** (15 min)
2836
- Agent definition and configuration
@@ -42,6 +50,12 @@ Complete documentation for the Agentic Ops Framework (AOF).
4250
- Conditional remediation
4351
- Post-incident analysis
4452

53+
4. **[Build an RCA Fleet](tutorials/rca-fleet.md)** (25 min)
54+
- Multi-agent root cause analysis
55+
- Specialist agents (error analyzer, dependency checker, config auditor)
56+
- Consensus-based incident diagnosis
57+
- Customization for different tech stacks (K8s, database, AWS)
58+
4559
### Reference Documentation
4660
- **[Agent YAML Spec](reference/agent-spec.md)** - Complete Agent specification
4761
- Metadata fields
@@ -207,14 +221,15 @@ See [Examples README](examples/README.md#contributing-examples) for guidelines.
207221
- [x] Main README
208222
- [x] Getting Started guide
209223
- [x] Core Concepts
210-
- [x] 3 comprehensive tutorials
224+
- [x] AgentFleet multi-agent coordination guide
225+
- [x] 4 comprehensive tutorials (including RCA Fleet)
211226
- [x] Complete Agent YAML reference
212227
- [x] Complete AgentFlow YAML reference
213228
- [x] Complete CLI reference
214-
- [x] 5 production-ready examples
229+
- [x] 5+ production-ready examples
230+
- [x] RCA fleet examples (application, database, Kubernetes)
215231

216232
### 🚧 Coming Soon
217-
- [ ] AgentFleet tutorial
218233
- [ ] Advanced patterns guide
219234
- [ ] Performance tuning guide
220235
- [ ] Security best practices
@@ -223,12 +238,15 @@ See [Examples README](examples/README.md#contributing-examples) for guidelines.
223238

224239
## 🔄 Documentation Updates
225240

226-
Last updated: 2024-01-20
241+
Last updated: 2024-12-17
227242

228243
### Recent Changes
244+
- Added AgentFleet multi-agent coordination guide
245+
- Added RCA Fleet tutorial with consensus patterns
246+
- Added application and database RCA fleet examples
229247
- Added complete reference documentation
230-
- Added 5 production examples
231-
- Added 3 step-by-step tutorials
248+
- Added 5+ production examples
249+
- Added 4 step-by-step tutorials
232250
- Added quickstart guide
233251

234252
---

0 commit comments

Comments
 (0)