|
12 | 12 | By the end of this tutorial, you'll understand: |
13 | 13 |
|
14 | 14 | 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) |
16 | 16 | 3. **How to compose custom agent teams** using Python |
17 | 17 | 4. **How the system learns** from successful compositions |
18 | 18 | 5. **How to build your own orchestrated workflows** |
19 | 19 |
|
| 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 | +
|
20 | 31 | --- |
21 | 32 |
|
22 | 33 | ## 📚 Table of Contents |
@@ -199,6 +210,51 @@ empathy orchestrate test-coverage \ |
199 | 210 | ============================================================ |
200 | 211 | ``` |
201 | 212 |
|
| 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 | + |
202 | 258 | --- |
203 | 259 |
|
204 | 260 | ## <a name="understanding-agent-templates"></a>🤖 Understanding Agent Templates |
@@ -816,25 +872,55 @@ print(f"Usage count: {best.usage_count}") # Should increment |
816 | 872 | You've learned: |
817 | 873 |
|
818 | 874 | ✅ **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 |
820 | 876 | ✅ **The 6 composition patterns** - Sequential, Parallel, Debate, Teaching, Refinement, Adaptive |
821 | 877 | ✅ **How to build custom workflows** - Combining agents and strategies |
822 | 878 | ✅ **How the system learns** - Configuration store and pattern library |
823 | 879 | ✅ **Advanced techniques** - Hybrid strategies, custom templates, conditional execution |
824 | 880 |
|
| 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 | + |
825 | 908 | ### Next Steps |
826 | 909 |
|
827 | 910 | 1. **Experiment** with the built-in workflows |
828 | 911 | 2. **Build** your first custom workflow |
829 | 912 | 3. **Monitor** the learning loop (check configuration store) |
830 | 913 | 4. **Share** successful compositions with your team |
| 914 | +5. **Explore** domain-specific features if relevant to your work |
831 | 915 |
|
832 | 916 | ### Additional Resources |
833 | 917 |
|
834 | 918 | - [User Guide](../ORCHESTRATION_USER_GUIDE.md) - Complete reference |
835 | 919 | - [API Documentation](../ORCHESTRATION_API.md) - All classes and methods |
836 | 920 | - [Examples](../../examples/orchestration/) - Working code samples |
837 | 921 | - [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`) |
838 | 924 |
|
839 | 925 | --- |
840 | 926 |
|
|
0 commit comments