From 23fa3910ecc92e629eaeec14faaf249b62249866 Mon Sep 17 00:00:00 2001 From: "Michael J. Jabbour" Date: Mon, 30 Mar 2026 18:56:32 -0400 Subject: [PATCH] compress: deduplicate ecosystem-overview and convert getting-started to skill - Remove module type table from ecosystem-overview.md (duplicated in MODULES.md) - Convert Getting Started Paths section to standalone skill (Option B) - Create skills/ecosystem-getting-started/SKILL.md with For Users, For App Developers, For Module Developers, For Contributors paths and Deep Dives delegation table - Replace removed sections in ecosystem-overview.md with pointers to Foundation Awareness Index and ecosystem-getting-started skill - Register tool-skills module in behaviors/amplifier-expert.yaml Token savings: ~1,063 tokens removed from amplifier-expert context load --- behaviors/amplifier-expert.yaml | 7 ++++ context/ecosystem-overview.md | 49 ++--------------------- skills/ecosystem-getting-started/SKILL.md | 41 +++++++++++++++++++ 3 files changed, 51 insertions(+), 46 deletions(-) create mode 100644 skills/ecosystem-getting-started/SKILL.md diff --git a/behaviors/amplifier-expert.yaml b/behaviors/amplifier-expert.yaml index 81f1a373..c665909f 100644 --- a/behaviors/amplifier-expert.yaml +++ b/behaviors/amplifier-expert.yaml @@ -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 diff --git a/context/ecosystem-overview.md b/context/ecosystem-overview.md index d6e7e138..19015d7e 100644 --- a/context/ecosystem-overview.md +++ b/context/ecosystem-overview.md @@ -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: @@ -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')`. diff --git a/skills/ecosystem-getting-started/SKILL.md b/skills/ecosystem-getting-started/SKILL.md new file mode 100644 index 00000000..1032f316 --- /dev/null +++ b/skills/ecosystem-getting-started/SKILL.md @@ -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. +