Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions behaviors/amplifier-expert.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,13 @@ agents:
include:
- amplifier:amplifier-expert

tools:
- module: tool-skills
source: git+https://github.com/microsoft/amplifier-module-tool-skills@main
config:
skills:
- "@amplifier:skills"

context:
include:
- amplifier:context/ecosystem-overview.md
Expand Down
49 changes: 3 additions & 46 deletions context/ecosystem-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,19 +33,7 @@ The primary library for building applications:
- Shared utilities

### Modules
Swappable capabilities that plug into the kernel (exactly 5 types):

| Type | Purpose | Examples |
|------|---------|----------|
| **Provider** | LLM backends | anthropic, openai, azure, ollama |
| **Tool** | Agent capabilities (LLM-decided) | filesystem, bash, web, search, task |
| **Orchestrator** | **The main engine** driving sessions | loop-basic, loop-streaming, loop-events |
| **Context** | Memory management | context-simple, context-persistent |
| **Hook** | Lifecycle observers (code-decided) | logging, redaction, approval |

**Orchestrator: The Main Engine** - The orchestrator controls the entire execution loop (LLM → tool calls → response). Swapping orchestrators can radically change agent behavior. It's THE control surface, not just "strategy."

**Tool vs Hook** - Tools are LLM-decided (model chooses to call them). Hooks are code-decided (fire on lifecycle events). Both can use models internally, but the triggering mechanism differs.
Swappable capabilities that plug into the kernel (exactly 5 types). For module type vocabulary and contracts, see the Foundation Awareness Index.

### Bundles
Composable configuration packages combining:
Expand Down Expand Up @@ -136,37 +124,6 @@ The kernel provides capabilities; modules decide behavior.
- Hooks observe without blocking
- Tracing IDs enable correlation

## Getting Started Paths

### For Users
1. Start with `amplifier:docs/USER_ONBOARDING.md` (quick start and commands)
2. Choose a bundle from foundation
3. Run `amplifier run` with your chosen configuration

### For App Developers
1. Study `foundation:examples/` for working patterns
2. Read `foundation:docs/BUNDLE_GUIDE.md` for bundle composition
3. Build your app using bundle primitives

### For Module Developers
1. Understand kernel contracts via `core:docs/`
2. Follow module protocols
3. Test modules in isolation before integration

### For Contributors
1. Read `amplifier:docs/REPOSITORY_RULES.md` for governance
2. Understand the dependency hierarchy
3. Contribute to the appropriate repository

## Deep Dives (Delegate to Specialists)

For detailed information, delegate to the appropriate expert agent:

| Topic | Delegate To | Has Access To |
|-------|-------------|---------------|
| Ecosystem modules, repos, governance | `amplifier:amplifier-expert` | MODULES.md, REPOSITORY_RULES.md, USER_ONBOARDING.md |
| Bundle authoring, patterns, examples | `foundation:foundation-expert` | BUNDLE_GUIDE.md, examples/, PATTERNS.md |
| Kernel internals, module protocols | `core:core-expert` | kernel contracts, HOOKS_API.md, specs/ |
| Recipe authoring, validation | `recipes:recipe-author` | RECIPE_SCHEMA.md, example recipes |
## Getting Started

These agents have the heavy documentation @mentioned directly and can provide authoritative answers.
For getting started guides and deep-dive delegation, use `load_skill(skill_name='ecosystem-getting-started')`.
41 changes: 41 additions & 0 deletions skills/ecosystem-getting-started/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
name: ecosystem-getting-started
description: 'Getting started paths for users, app developers, module developers, and contributors, plus deep-dive delegation table'
version: 1.0.0
---

## Getting Started Paths

### For Users
1. Start with `amplifier:docs/USER_ONBOARDING.md` (quick start and commands)
2. Choose a bundle from foundation
3. Run `amplifier run` with your chosen configuration

### For App Developers
1. Study `foundation:examples/` for working patterns
2. Read `foundation:docs/BUNDLE_GUIDE.md` for bundle composition
3. Build your app using bundle primitives

### For Module Developers
1. Understand kernel contracts via `core:docs/`
2. Follow module protocols
3. Test modules in isolation before integration

### For Contributors
1. Read `amplifier:docs/REPOSITORY_RULES.md` for governance
2. Understand the dependency hierarchy
3. Contribute to the appropriate repository

## Deep Dives (Delegate to Specialists)

For detailed information, delegate to the appropriate expert agent:

| Topic | Delegate To | Has Access To |
|-------|-------------|---------------|
| Ecosystem modules, repos, governance | `amplifier:amplifier-expert` | MODULES.md, REPOSITORY_RULES.md, USER_ONBOARDING.md |
| Bundle authoring, patterns, examples | `foundation:foundation-expert` | BUNDLE_GUIDE.md, examples/, PATTERNS.md |
| Kernel internals, module protocols | `core:core-expert` | kernel contracts, HOOKS_API.md, specs/ |
| Recipe authoring, validation | `recipes:recipe-author` | RECIPE_SCHEMA.md, example recipes |

These agents have the heavy documentation @mentioned directly and can provide authoritative answers.