amplifier-foundation/bundle.dot at main · microsoft/amplifier-foundation · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
// Amplifier "foundation" bundle repository: the shared starter kit that gives an
// AI assistant its core team of expert helpers, safe working habits, and the ability
// to plug into other toolkits. Everything here can be mixed, matched, and reused by
// other projects that build on top of foundation.
digraph foundation {
    rankdir=LR
    fontname="Helvetica"
    fontsize=12
    label="Foundation Bundle (v2.1.2)\nThe shared starter kit of AI helpers, safe habits, and toolkit connections"
    labelloc=t
    labeljust=c
    nodesep=0.6
    ranksep=0.7
    bgcolor="white"
    source_hash="0488d60b3fde4cc9582c390a7a87732b640330f16034032364f223f0f7529aa0"

    node [fontname="Helvetica", fontsize=11, style="filled,rounded"]
    edge [fontname="Helvetica", fontsize=9]

    root_foundation [label="Foundation — the main kit\nBundles the default helpers & habits\nv2.1.2\n4 tools · 11 agents\n~11175 tok aggregate", shape=box, fillcolor="#80cbc4", style="filled,rounded,bold", penwidth=2]

    subgraph cluster_behaviors {
        label="Behaviors — reusable habits & capabilities"
        style="filled"
        fillcolor="#f9f9f9"
        color="#999999"

        beh_behavior_agents [label="Agent Delegation & Context\nHand work to specialist helpers\n2 tools · 2 ctx\n~5590 tok", shape=box, fillcolor="#e0f2f1", style="filled,rounded"]
        beh_behavior_amplifier_dev [label="Amplifier Dev Helper\nTools for building Amplifier itself\n~507 tok", shape=box, fillcolor="#e0f2f1", style="filled,rounded"]
        beh_behavior_bundle_design [label="Bundle Design Helper\nGuidance for building bundles\n1 ctx\n~1258 tok", shape=box, fillcolor="#e0f2f1", style="filled,rounded"]
        beh_foundation_expert_behavior [label="Foundation Expert Helper\nKnows the foundation kit inside out\n1 ctx\n~1113 tok", shape=box, fillcolor="#e0f2f1", style="filled,rounded"]
        beh_behavior_logging [label="Activity Logging\nRecords what happens\n1 tools\n~85 tok", shape=box, fillcolor="#e0f2f1", style="filled,rounded"]
        beh_behavior_progress_monitor [label="Progress Monitor\nWatches long-running work\n1 tools\n~190 tok", shape=box, fillcolor="#e0f2f1", style="filled,rounded"]
        beh_behavior_redaction [label="Sensitive-Data Redaction\nHides secrets from output\n1 tools\n~82 tok", shape=box, fillcolor="#e0f2f1", style="filled,rounded"]
        beh_behavior_sessions [label="Session Management\nNames & tracks work sessions\n1 tools\n~515 tok", shape=box, fillcolor="#e0f2f1", style="filled,rounded"]
        beh_behavior_status_context [label="Status Context\nShares current environment info\n1 tools\n~83 tok", shape=box, fillcolor="#e0f2f1", style="filled,rounded"]
        beh_behavior_streaming_ui [label="Live Streaming Display\nShows responses as they form\n1 tools\n~95 tok", shape=box, fillcolor="#e0f2f1", style="filled,rounded"]
        beh_behavior_tasks [label="Task Coordination\nBreaks work into delegated tasks\n1 tools · 2 ctx\n~5370 tok", shape=box, fillcolor="#e0f2f1", style="filled,rounded"]
        beh_behavior_todo_reminder [label="To-Do Reminders\nKeeps a running task list\n3 tools\n~232 tok", shape=box, fillcolor="#e0f2f1", style="filled,rounded"]
    }

    subgraph cluster_standalones {
        label="Ready-to-Use Bundles — complete kits you can run as-is"
        style="filled"
        fillcolor="#f9f9f9"
        color="#999999"

        sta_amplifier_dev [label="Amplifier Dev Kit\nFor building Amplifier", shape=box, fillcolor="#80cbc4", style="filled,rounded"]
        sta_foundation_minimal [label="Minimal Kit\nBare-bones starting point", shape=box, fillcolor="#80cbc4", style="filled,rounded"]
        sta_foundation_anthropic [label="Anthropic Kit\nPreset for Claude models", shape=box, fillcolor="#80cbc4", style="filled,rounded"]
        sta_foundation_openai [label="OpenAI Kit\nPreset for GPT models", shape=box, fillcolor="#80cbc4", style="filled,rounded"]
    }

    subgraph cluster_agents {
        label="Agents — specialist AI helpers you can hand work to"
        style="filled"
        fillcolor="#f9f9f9"
        color="#999999"

        agt_bug_hunter [label="Bug Hunter\nTracks down & fixes errors\n~190 tok desc", shape=box, fillcolor="#c8e6c9", style="filled,rounded"]
        agt_bundle_design_expert [label="Bundle Design Expert\nDesigns & builds bundles\n~414 tok desc", shape=box, fillcolor="#c8e6c9", style="filled,rounded"]
        agt_ecosystem_expert [label="Ecosystem Expert\nCoordinates across repos\n~373 tok desc", shape=box, fillcolor="#c8e6c9", style="filled,rounded"]
        agt_explorer [label="Explorer\nSurveys code & documents\n~289 tok desc", shape=box, fillcolor="#c8e6c9", style="filled,rounded"]
        agt_file_ops [label="File Operations\nReads, writes & searches files\n~371 tok desc", shape=box, fillcolor="#c8e6c9", style="filled,rounded"]
        agt_foundation_expert [label="Foundation Expert\nNavigates the foundation kit\n~400 tok desc", shape=box, fillcolor="#c8e6c9", style="filled,rounded"]
        agt_git_ops [label="Git Operations\nHandles commits & pull requests\n~373 tok desc", shape=box, fillcolor="#c8e6c9", style="filled,rounded"]
        agt_integration_specialist [label="Integration Specialist\nConnects external services & APIs\n~296 tok desc", shape=box, fillcolor="#c8e6c9", style="filled,rounded"]
        agt_modular_builder [label="Modular Builder\nWrites code from specs\n~325 tok desc", shape=box, fillcolor="#c8e6c9", style="filled,rounded"]
        agt_post_task_cleanup [label="Post-Task Cleanup\nTidies up after work is done\n~367 tok desc", shape=box, fillcolor="#c8e6c9", style="filled,rounded"]
        agt_security_guardian [label="Security Guardian\nReviews for vulnerabilities\n~365 tok desc", shape=box, fillcolor="#c8e6c9", style="filled,rounded"]
        agt_session_analyst [label="Session Analyst\nAnalyzes & repairs sessions\n~375 tok desc", shape=box, fillcolor="#c8e6c9", style="filled,rounded"]
        agt_shell_exec [label="Shell Runner\nRuns command-line tasks\n~365 tok desc", shape=box, fillcolor="#c8e6c9", style="filled,rounded"]
        agt_test_coverage [label="Test Coverage\nFinds gaps in testing\n~190 tok desc", shape=box, fillcolor="#c8e6c9", style="filled,rounded"]
        agt_web_research [label="Web Research\nSearches & summarizes the web\n~376 tok desc", shape=box, fillcolor="#c8e6c9", style="filled,rounded"]
        agt_zen_architect [label="Zen Architect\nPlans & reviews designs\n~342 tok desc", shape=box, fillcolor="#c8e6c9", style="filled,rounded"]
    }

    subgraph cluster_modules {
        label="Modules — the working code behind the habits"
        style="filled"
        fillcolor="#f9f9f9"
        color="#999999"

        mod_hooks_deprecation [label="Deprecation Notices\nWarns about retiring features", shape=box, fillcolor="#bbdefb", style="filled,rounded"]
        mod_hooks_process_guard [label="Process Guard\nLimits runaway processes", shape=box, fillcolor="#bbdefb", style="filled,rounded"]
        mod_hooks_progress_monitor [label="Progress Tracker\nReports work-in-progress", shape=box, fillcolor="#bbdefb", style="filled,rounded"]
        mod_hooks_session_naming [label="Session Namer\nAuto-names work sessions", shape=box, fillcolor="#bbdefb", style="filled,rounded"]
        mod_hooks_todo_display [label="To-Do Display\nShows the task list", shape=box, fillcolor="#bbdefb", style="filled,rounded"]
        mod_tool_delegate [label="Delegate Tool\nSends tasks to other helpers\n1 tool · ~695 tok", shape=box, fillcolor="#bbdefb", style="filled,rounded"]
    }

    subgraph cluster_providers {
        label="Providers — the AI models that power the helpers"
        style="filled"
        fillcolor="#f9f9f9"
        color="#999999"

        prv_anthropic_opus [label="Claude Opus\nAnthropic's most capable model", shape=box, fillcolor="#e0e0e0", style="filled,rounded"]
        prv_anthropic_sonnet [label="Claude Sonnet\nAnthropic's balanced model", shape=box, fillcolor="#e0e0e0", style="filled,rounded"]
        prv_openai_gpt_5 [label="GPT-5\nOpenAI flagship model", shape=box, fillcolor="#e0e0e0", style="filled,rounded"]
        prv_openai_gpt_codex [label="GPT Codex\nOpenAI coding model", shape=box, fillcolor="#e0e0e0", style="filled,rounded"]
        prv_openai_gpt [label="GPT\nOpenAI general model", shape=box, fillcolor="#e0e0e0", style="filled,rounded"]
    }

    subgraph cluster_experiments {
        label="Experiments — work-in-progress, not for everyday use"
        style="filled"
        fillcolor="#f9f9f9"
        color="#999999"

        exp_exp_amplifier_dev [label="Experimental Dev Kit\nTrial version of the dev kit", shape=box, fillcolor="#e1bee7", style="filled,rounded"]
        exp_exp_foundation [label="Experimental Foundation\nTrial version of the main kit", shape=box, fillcolor="#e1bee7", style="filled,rounded"]
        exp_delegation_only [label="Delegation-Only Trial\nTesting handoffs in isolation", shape=box, fillcolor="#e1bee7", style="filled,rounded"]
    }

    subgraph cluster_context {
        label="Context Files — shared knowledge the helpers read"
        style="filled"
        fillcolor="#f9f9f9"
        color="#999999"

        ctx_delegation_instructions_md [label="How to Delegate Work\ndelegation-instructions.md\n~3352 tok", shape=box, fillcolor="#e1bee7", style="filled,rounded"]
        ctx_multi_agent_patterns_md [label="Multi-Helper Patterns\nmulti-agent-patterns.md\n~1863 tok", shape=box, fillcolor="#e1bee7", style="filled,rounded"]
        ctx_bundle_design_awareness_md [label="Bundle Design Notes\nbundle-design-awareness.md\n~708 tok", shape=box, fillcolor="#e1bee7", style="filled,rounded"]
        ctx_bundle_awareness_md [label="Bundle Basics\nbundle-awareness.md\n~566 tok", shape=box, fillcolor="#e1bee7", style="filled,rounded"]
        ctx_common_system_base_md [label="Core Ground Rules\ncommon-system-base.md\n~1529 tok", shape=box, fillcolor="#e1bee7", style="filled,rounded"]
    }

    subgraph cluster_legend {
        label="Legend"
        style="filled"
        fillcolor="white"
        color="#cccccc"
        fontsize=9

        leg_root [label="root bundle", shape=box, fillcolor="#80cbc4", style="filled,rounded,bold", fontsize=9]
        leg_behavior [label="behavior", shape=box, fillcolor="#e0f2f1", style="filled,rounded", fontsize=9]
        leg_agent [label="agent", shape=box, fillcolor="#c8e6c9", style="filled,rounded", fontsize=9]
        leg_module [label="module", shape=box, fillcolor="#bbdefb", style="filled,rounded", fontsize=9]
        leg_provider [label="provider", shape=box, fillcolor="#e0e0e0", style="filled,rounded", fontsize=9]
        leg_context [label="context", shape=box, fillcolor="#e1bee7", style="filled,rounded", fontsize=9]
        leg_standalone [label="standalone", shape=box, fillcolor="#80cbc4", style="filled,rounded", fontsize=9]
        leg_experiment [label="experiment", shape=box, fillcolor="#e1bee7", style="filled,rounded", fontsize=9]
        leg_ext_cost [label="ext+cost", shape=box, fillcolor="#80cbc4", style="dashed", color="red", penwidth=2, fontsize=9]
        leg_ext_muted [label="ext+no-cost", shape=box, fillcolor="#f5f5f5", style="dashed", fontsize=9]
    }

    disclaimer [label="Token estimates: ~4 chars/token\nSolid border = local (counted)\nDashed + red = external, hidden cost (not counted)\nDashed + muted = external, no cost\nExcludes: sub-session costs, runtime-dynamic", shape=note, fillcolor="#eceff1", style="filled", fontsize=9]

    ext_githttps___github_com_microsoft_amplifier_mainsubdirectorybehaviors_amplifier_expert_yaml [label="Amplifier Expert (external)\namplifier-expert.yaml\n(external, cost)", shape=box, fillcolor="#80cbc4", style="dashed", color="red", penwidth=2]
    ext_githttps___github_com_microsoft_amplifier_core_mainsubdirectorybehaviors_core_expert_yaml [label="Core Expert (external)\ncore-expert.yaml\n(external, cost)", shape=box, fillcolor="#80cbc4", style="dashed", color="red", penwidth=2]
    ext_githttps___github_com_microsoft_amplifier_bundle_recipes_mainsubdirectorybehaviors_recipes_yaml [label="Recipes / Workflows (external)\nrecipes.yaml\n(external, cost)", shape=box, fillcolor="#80cbc4", style="dashed", color="red", penwidth=2]
    ext_githttps___github_com_microsoft_amplifier_bundle_design_intelligence_mainsubdirectorybehaviors_design_intelligence_yaml [label="Design Intelligence (external)\ndesign-intelligence.yaml\n(external, cost)", shape=box, fillcolor="#80cbc4", style="dashed", color="red", penwidth=2]
    ext_githttps___github_com_microsoft_amplifier_bundle_python_dev_main [label="Python Dev Tools (external)\namplifier-bundle-python-dev\n(external, cost)", shape=box, fillcolor="#80cbc4", style="dashed", color="red", penwidth=2]
    ext_githttps___github_com_microsoft_amplifier_bundle_amplifier_tester_main [label="Amplifier Tester (external)\namplifier-bundle-amplifier-tester\n(external, cost)", shape=box, fillcolor="#80cbc4", style="dashed", color="red", penwidth=2]
    ext_githttps___github_com_microsoft_amplifier_bundle_skills_mainsubdirectorybehaviors_skills_yaml [label="Skills Library (external)\nskills.yaml\n(external, cost)", shape=box, fillcolor="#80cbc4", style="dashed", color="red", penwidth=2]
    ext_githttps___github_com_microsoft_amplifier_bundle_browser_tester_mainsubdirectorybehaviors_browser_tester_yaml [label="Browser Tester (external)\nbrowser-tester.yaml\n(external, cost)", shape=box, fillcolor="#80cbc4", style="dashed", color="red", penwidth=2]
    ext_githttps___github_com_microsoft_amplifier_bundle_superpowers_mainsubdirectorybehaviors_superpowers_methodology_yaml [label="Superpowers Methodology (external)\nsuperpowers-methodology.yaml\n(external, cost)", shape=box, fillcolor="#80cbc4", style="dashed", color="red", penwidth=2]
    ext_githttps___github_com_microsoft_amplifier_bundle_llm_wiki_mainsubdirectorybehaviors_llm_wiki_yaml [label="LLM Wiki (external)\nllm-wiki.yaml\n(external, cost)", shape=box, fillcolor="#80cbc4", style="dashed", color="red", penwidth=2]
    ext_githttps___github_com_microsoft_amplifier_bundle_evaluation_mainsubdirectorybehaviors_evaluation_yaml [label="Evaluation Tools (external)\nevaluation.yaml\n(external, cost)", shape=box, fillcolor="#80cbc4", style="dashed", color="red", penwidth=2]
    ext_githttps___github_com_microsoft_amplifier_module_hook_shell_mainsubdirectorybehaviors_hook_shell_yaml [label="Shell Hook (external)\nhook-shell.yaml\n(external, cost)", shape=box, fillcolor="#80cbc4", style="dashed", color="red", penwidth=2]
    ext_githttps___github_com_microsoft_amplifier_module_tool_mcp_mainsubdirectorybehaviors_mcp_yaml [label="MCP Connector (external)\nmcp.yaml\n(external, cost)", shape=box, fillcolor="#80cbc4", style="dashed", color="red", penwidth=2]
    ext_githttps___github_com_microsoft_amplifier_bundle_filesystem_mainsubdirectorybehaviors_apply_patch_yaml [label="Apply Patch (external)\napply-patch.yaml\n(external, cost)", shape=box, fillcolor="#80cbc4", style="dashed", color="red", penwidth=2]
    ext_githttps___github_com_microsoft_amplifier_bundle_routing_matrix_main [label="Routing Matrix (external)\namplifier-bundle-routing-matrix\n(external, cost)", shape=box, fillcolor="#80cbc4", style="dashed", color="red", penwidth=2]

    root_foundation -> ext_githttps___github_com_microsoft_amplifier_mainsubdirectorybehaviors_amplifier_expert_yaml [style=dashed]
    root_foundation -> ext_githttps___github_com_microsoft_amplifier_core_mainsubdirectorybehaviors_core_expert_yaml [style=dashed]
    root_foundation -> beh_foundation_expert_behavior [label="composes"]
    root_foundation -> beh_behavior_sessions [label="composes"]
    root_foundation -> beh_behavior_status_context [label="composes"]
    root_foundation -> beh_behavior_redaction [label="composes"]
    root_foundation -> beh_behavior_todo_reminder [label="composes"]
    root_foundation -> beh_behavior_streaming_ui [label="composes"]
    root_foundation -> beh_behavior_agents [label="composes"]
    root_foundation -> ext_githttps___github_com_microsoft_amplifier_bundle_recipes_mainsubdirectorybehaviors_recipes_yaml [style=dashed]
    root_foundation -> ext_githttps___github_com_microsoft_amplifier_bundle_design_intelligence_mainsubdirectorybehaviors_design_intelligence_yaml [style=dashed]
    root_foundation -> ext_githttps___github_com_microsoft_amplifier_bundle_python_dev_main [style=dashed]
    root_foundation -> ext_githttps___github_com_microsoft_amplifier_bundle_amplifier_tester_main [style=dashed]
    root_foundation -> ext_githttps___github_com_microsoft_amplifier_bundle_skills_mainsubdirectorybehaviors_skills_yaml [style=dashed]
    root_foundation -> ext_githttps___github_com_microsoft_amplifier_bundle_browser_tester_mainsubdirectorybehaviors_browser_tester_yaml [style=dashed]
    root_foundation -> ext_githttps___github_com_microsoft_amplifier_bundle_superpowers_mainsubdirectorybehaviors_superpowers_methodology_yaml [style=dashed]
    root_foundation -> ext_githttps___github_com_microsoft_amplifier_bundle_llm_wiki_mainsubdirectorybehaviors_llm_wiki_yaml [style=dashed]
    root_foundation -> ext_githttps___github_com_microsoft_amplifier_bundle_evaluation_mainsubdirectorybehaviors_evaluation_yaml [style=dashed]
    root_foundation -> ext_githttps___github_com_microsoft_amplifier_module_hook_shell_mainsubdirectorybehaviors_hook_shell_yaml [style=dashed]
    root_foundation -> ext_githttps___github_com_microsoft_amplifier_module_tool_mcp_mainsubdirectorybehaviors_mcp_yaml [style=dashed]
    root_foundation -> ext_githttps___github_com_microsoft_amplifier_bundle_filesystem_mainsubdirectorybehaviors_apply_patch_yaml [style=dashed]
    root_foundation -> ext_githttps___github_com_microsoft_amplifier_bundle_routing_matrix_main [style=dashed]
    beh_behavior_agents -> mod_tool_delegate [label="uses", penwidth=0.8]
    beh_behavior_agents -> ctx_delegation_instructions_md [style=dotted, color=purple]
    beh_behavior_agents -> ctx_multi_agent_patterns_md [style=dotted, color=purple]
    beh_behavior_amplifier_dev -> agt_ecosystem_expert [label="owns"]
    beh_behavior_bundle_design -> agt_bundle_design_expert [label="owns"]
    beh_behavior_bundle_design -> ctx_bundle_design_awareness_md [style=dotted, color=purple]
    beh_foundation_expert_behavior -> agt_foundation_expert [label="owns"]
    beh_foundation_expert_behavior -> ctx_bundle_awareness_md [style=dotted, color=purple]
    beh_behavior_progress_monitor -> mod_hooks_progress_monitor [label="uses", penwidth=0.8]
    beh_behavior_sessions -> agt_session_analyst [label="owns"]
    beh_behavior_sessions -> mod_hooks_session_naming [label="uses", penwidth=0.8]
    beh_behavior_tasks -> ctx_delegation_instructions_md [style=dotted, color=purple]
    beh_behavior_tasks -> ctx_multi_agent_patterns_md [style=dotted, color=purple]
    root_foundation -> ctx_common_system_base_md [style=dotted, color=purple]
    sta_amplifier_dev -> root_foundation [label="extends", style=dashed]
    sta_foundation_minimal -> root_foundation [label="extends", style=dashed]
    sta_foundation_anthropic -> root_foundation [label="extends", style=dashed]
    sta_foundation_openai -> root_foundation [label="extends", style=dashed]
    exp_exp_amplifier_dev -> root_foundation [label="forks", style=dashed]
    exp_exp_foundation -> root_foundation [label="forks", style=dashed]
    exp_delegation_only -> root_foundation [label="forks", style=dashed]
}