Skip to content

Commit fa85330

Browse files
docs: add required check for existing modules before building
Update amplifier-expert agent description to explicitly require checking MODULES.md before building new functionality: - Add 'REQUIRED: Before building new modules/tools/capabilities' line - Add example showing the pattern for checking existing solutions - Reinforces 'reuse, don't reinvent' ecosystem philosophy Works in tandem with AWARENESS_INDEX.md changes in amplifier-foundation to ensure AI assistants check for existing capabilities first. 🤖 Generated with [Amplifier](https://github.com/microsoft/amplifier) Co-Authored-By: Amplifier <240397093+microsoft-amplifier@users.noreply.github.com>
1 parent b46971a commit fa85330

2 files changed

Lines changed: 2 additions & 1 deletion

File tree

agents/amplifier-expert.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
meta:
33
name: amplifier-expert
4-
description: "**THE authoritative consultant for ALL Amplifier ecosystem knowledge.** Use PROACTIVELY throughout the entire lifecycle: for initial research to understand what's possible, for guidance on how to build, and for validation of ideas/plans/implementations. This agent is the source of truth for amplifier-core, modules, amplifier-foundation, bundles, patterns, and best practices.\n\n**CRITICAL: Use this agent BEFORE implementation** to get accurate context. Use it DURING work to validate approaches. Use it AFTER to verify alignment with Amplifier philosophy.\n\nExamples:\n\n<example>\nContext: Starting any Amplifier-related work\nuser: 'I need to understand how sessions work before implementing'\nassistant: 'I'll consult amplifier:amplifier-expert first to get authoritative information on session lifecycle and patterns.'\n<commentary>\nALWAYS consult amplifier:amplifier-expert when starting Amplifier-related work for accurate context.\n</commentary>\n</example>\n\n<example>\nContext: Validating an approach\nuser: 'Is this the right pattern for adding a custom provider?'\nassistant: 'Let me use amplifier:amplifier-expert to validate this approach against Amplifier's design principles.'\n<commentary>\nUse amplifier:amplifier-expert to validate ideas/plans before implementation.\n</commentary>\n</example>\n\n<example>\nContext: Understanding what's possible\nuser: 'What multi-agent patterns does Amplifier support?'\nassistant: 'I'll delegate to amplifier:amplifier-expert to explain available patterns and point to relevant examples.'\n<commentary>\namplifier:amplifier-expert knows the full ecosystem and can recommend appropriate patterns.\n</commentary>\n</example>\n\n<example>\nContext: Quick reference lookup\nuser: 'What module types exist in Amplifier?'\nassistant: 'I'll ask amplifier:amplifier-expert for the authoritative list of module types and their contracts.'\n<commentary>\nEven simple lookups should go through amplifier:amplifier-expert to ensure accuracy.\n</commentary>\n</example>"
4+
description: "**THE authoritative consultant for ALL Amplifier ecosystem knowledge.** Use PROACTIVELY throughout the entire lifecycle: for initial research to understand what's possible, for guidance on how to build, and for validation of ideas/plans/implementations. This agent is the source of truth for amplifier-core, modules, amplifier-foundation, bundles, patterns, and best practices.\n\n**CRITICAL: Use this agent BEFORE implementation** to get accurate context. Use it DURING work to validate approaches. Use it AFTER to verify alignment with Amplifier philosophy.\n\n**REQUIRED: Before building new modules/tools/capabilities**, consult this agent to check MODULES.md for existing solutions. Do not reinvent—reuse or extend.\n\nExamples:\n\n<example>\nContext: Before building new functionality\nuser: 'I need to add a caching capability to my agent'\nassistant: 'I will consult amplifier:amplifier-expert first to check if a caching module already exists in the ecosystem before building something new.'\n<commentary>\nALWAYS check MODULES.md via amplifier-expert before building new functionality to avoid duplication.\n</commentary>\n</example>\n\nExamples:\n\n<example>\nContext: Starting any Amplifier-related work\nuser: 'I need to understand how sessions work before implementing'\nassistant: 'I'll consult amplifier:amplifier-expert first to get authoritative information on session lifecycle and patterns.'\n<commentary>\nALWAYS consult amplifier:amplifier-expert when starting Amplifier-related work for accurate context.\n</commentary>\n</example>\n\n<example>\nContext: Validating an approach\nuser: 'Is this the right pattern for adding a custom provider?'\nassistant: 'Let me use amplifier:amplifier-expert to validate this approach against Amplifier's design principles.'\n<commentary>\nUse amplifier:amplifier-expert to validate ideas/plans before implementation.\n</commentary>\n</example>\n\n<example>\nContext: Understanding what's possible\nuser: 'What multi-agent patterns does Amplifier support?'\nassistant: 'I'll delegate to amplifier:amplifier-expert to explain available patterns and point to relevant examples.'\n<commentary>\namplifier:amplifier-expert knows the full ecosystem and can recommend appropriate patterns.\n</commentary>\n</example>\n\n<example>\nContext: Quick reference lookup\nuser: 'What module types exist in Amplifier?'\nassistant: 'I'll ask amplifier:amplifier-expert for the authoritative list of module types and their contracts.'\n<commentary>\nEven simple lookups should go through amplifier:amplifier-expert to ensure accuracy.\n</commentary>\n</example>"
55
---
66

77
# Amplifier Expert

behaviors/amplifier-expert.yaml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,4 +10,5 @@ agents:
1010
context:
1111
include:
1212
- amplifier:context/ecosystem-overview.md
13+
- amplifier:docs/MODULES.md # Full ecosystem catalog - enables "check before building"
1314
# recipes-usage.md demoted to soft reference (load on demand) - see amplifier-expert.md

0 commit comments

Comments
 (0)