Skip to content

Commit 6a072cb

Browse files
GeneAIclaude
authored andcommitted
docs: Update meta-orchestration tutorial for domain-agnostic positioning
- Add note that framework is domain-agnostic (works with any agents) - Include Health Check workflow as Example 3 - Add Domain-Specific Extensions section - Reference healthcare and code analysis features - Clarify tutorial uses software dev examples for primary audience - Fix markdown linting issues Implements Option A: Keep healthcare/software features, better organize and position meta-orchestration as universal capability. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
1 parent d80ffea commit 6a072cb

File tree

1 file changed

+88
-2
lines changed

1 file changed

+88
-2
lines changed

docs/tutorials/META_ORCHESTRATION_TUTORIAL.md

Lines changed: 88 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,11 +12,22 @@
1212
By the end of this tutorial, you'll understand:
1313

1414
1. **What meta-orchestration is** and why it's a paradigm shift
15-
2. **How to use the two built-in workflows** (Release Prep, Test Coverage Boost)
15+
2. **How to use the three built-in workflows** (Release Prep, Test Coverage Boost, Health Check)
1616
3. **How to compose custom agent teams** using Python
1717
4. **How the system learns** from successful compositions
1818
5. **How to build your own orchestrated workflows**
1919

20+
> **📘 About This Tutorial**
21+
>
22+
> This tutorial uses **software development agents** as examples (security auditing, test coverage, code quality), since the framework is primarily used by developers. However, **meta-orchestration is domain-agnostic** and works with any type of agent.
23+
>
24+
> The Empathy Framework also includes:
25+
>
26+
> - **Healthcare-specific agents**: HIPAA compliance, patient data validation, clinical workflows
27+
> - **Code analysis tools**: Static analysis, SARIF reports, architectural insights
28+
>
29+
> The meta-orchestration system can compose teams from *any* domain. The principles you learn here apply universally.
30+
2031
---
2132

2233
## 📚 Table of Contents
@@ -199,6 +210,51 @@ empathy orchestrate test-coverage \
199210
============================================================
200211
```
201212

213+
### Example 3: Health Check (2 minutes)
214+
215+
The **Health Check** workflow provides adaptive health assessment with 3 modes:
216+
217+
```bash
218+
# Quick daily check (3 agents in parallel)
219+
empathy orchestrate health-check --mode daily
220+
221+
# Comprehensive weekly (5 agents)
222+
empathy orchestrate health-check --mode weekly
223+
224+
# Pre-release deep dive (6 agents)
225+
empathy orchestrate health-check --mode release
226+
227+
# JSON output for dashboards
228+
empathy orchestrate health-check --mode daily --json
229+
```
230+
231+
**What happens:**
232+
233+
- **Daily**: Security, Coverage, Quality (fast parallel check)
234+
- **Weekly**: Adds Performance, Documentation (comprehensive)
235+
- **Release**: Adds Architecture analysis (deep refinement)
236+
237+
**Sample output:**
238+
239+
```text
240+
============================================================
241+
🏥 HEALTH CHECK REPORT
242+
============================================================
243+
244+
Health Score: 85/100 (Grade: B)
245+
Trend: Improving (+5 from last week)
246+
Duration: 1.2s
247+
248+
⚠️ Issues Found (1):
249+
• Documentation below 100% (92%)
250+
251+
💡 Recommendations:
252+
1. 📚 Complete API documentation for 3 modules
253+
2. ✅ Maintain current test coverage (excellent!)
254+
255+
============================================================
256+
```
257+
202258
---
203259

204260
## <a name="understanding-agent-templates"></a>🤖 Understanding Agent Templates
@@ -816,25 +872,55 @@ print(f"Usage count: {best.usage_count}") # Should increment
816872
You've learned:
817873

818874
**What meta-orchestration is** - AI agents that compose themselves
819-
**How to use built-in workflows** - Release Prep, Test Coverage Boost
875+
**How to use built-in workflows** - Release Prep, Test Coverage Boost, Health Check
820876
**The 6 composition patterns** - Sequential, Parallel, Debate, Teaching, Refinement, Adaptive
821877
**How to build custom workflows** - Combining agents and strategies
822878
**How the system learns** - Configuration store and pattern library
823879
**Advanced techniques** - Hybrid strategies, custom templates, conditional execution
824880

881+
### Domain-Specific Extensions
882+
883+
While this tutorial focused on software development workflows, the Empathy Framework includes additional domain-specific capabilities:
884+
885+
**Healthcare & Compliance:**
886+
887+
- HIPAA compliance validation agents
888+
- Patient data privacy checkers
889+
- Clinical workflow orchestration
890+
- Regulatory audit trail generation
891+
892+
**Code Analysis & Quality:**
893+
894+
- Static analysis with SARIF output
895+
- Architectural dependency mapping
896+
- Security vulnerability scanning
897+
- Technical debt quantification
898+
899+
**Custom Domains:**
900+
901+
The meta-orchestration system is designed to work with agents from *any* domain. You can:
902+
903+
1. Create custom agent templates for your industry
904+
2. Use the same composition patterns (Sequential, Parallel, etc.)
905+
3. Benefit from the learning loop across all domains
906+
4. Mix and match agents from different domains in one workflow
907+
825908
### Next Steps
826909

827910
1. **Experiment** with the built-in workflows
828911
2. **Build** your first custom workflow
829912
3. **Monitor** the learning loop (check configuration store)
830913
4. **Share** successful compositions with your team
914+
5. **Explore** domain-specific features if relevant to your work
831915

832916
### Additional Resources
833917

834918
- [User Guide](../ORCHESTRATION_USER_GUIDE.md) - Complete reference
835919
- [API Documentation](../ORCHESTRATION_API.md) - All classes and methods
836920
- [Examples](../../examples/orchestration/) - Working code samples
837921
- [Architecture](../META_ORCHESTRATION_ARCHITECTURE.md) - Deep dive into design
922+
- Healthcare Wizards - HIPAA compliance and clinical workflows (see `empathy wizard --help`)
923+
- Code Analysis Tools - Static analysis and SARIF reports (see `empathy inspect --help`)
838924

839925
---
840926

0 commit comments

Comments
 (0)