aia 2.0.0.0.pre.alpha → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (236) hide show
  1. checksums.yaml +4 -4
  2. data/.version +1 -1
  3. data/CHANGELOG.md +151 -228
  4. data/README.md +42 -19
  5. data/bin/aia +8 -3
  6. data/lib/aia/aia_completion.bash +2 -3
  7. data/lib/aia/aia_completion.fish +6 -5
  8. data/lib/aia/aia_completion.zsh +2 -3
  9. data/lib/aia/chat_loop.rb +24 -66
  10. data/lib/aia/config/cli_parser.rb +164 -123
  11. data/lib/aia/config/defaults.yml +12 -39
  12. data/lib/aia/config/mcp_parser.rb +42 -40
  13. data/lib/aia/config/model_spec.rb +8 -14
  14. data/lib/aia/config/validator.rb +144 -156
  15. data/lib/aia/config/value_caster.rb +76 -0
  16. data/lib/aia/config.rb +72 -54
  17. data/lib/aia/content_extractor.rb +2 -0
  18. data/lib/aia/cost_calculator.rb +1 -0
  19. data/lib/aia/crew.rb +29 -19
  20. data/lib/aia/debate_handler.rb +45 -20
  21. data/lib/aia/delegate_handler.rb +7 -3
  22. data/lib/aia/directive.rb +10 -8
  23. data/lib/aia/directives/configuration_directives.rb +164 -109
  24. data/lib/aia/directives/context_directives.rb +55 -40
  25. data/lib/aia/directives/execution_directives.rb +25 -25
  26. data/lib/aia/directives/model_directives.rb +112 -195
  27. data/lib/aia/directives/trakflow_directives.rb +27 -9
  28. data/lib/aia/directives/utility_directives.rb +86 -87
  29. data/lib/aia/directives/web_and_file_directives.rb +83 -63
  30. data/lib/aia/fact_asserter.rb +3 -3
  31. data/lib/aia/history_transfer.rb +64 -24
  32. data/lib/aia/layered_orchestrator.rb +66 -43
  33. data/lib/aia/logger.rb +27 -62
  34. data/lib/aia/mcp_config_normalizer.rb +27 -14
  35. data/lib/aia/mcp_connection_manager.rb +193 -186
  36. data/lib/aia/mcp_discovery.rb +43 -15
  37. data/lib/aia/mcp_grouper.rb +2 -1
  38. data/lib/aia/mcp_server_config.rb +48 -0
  39. data/lib/aia/mcp_utility.rb +28 -20
  40. data/lib/aia/mention_router.rb +22 -52
  41. data/lib/aia/modality_query.rb +36 -0
  42. data/lib/aia/model_alias_registry.rb +11 -11
  43. data/lib/aia/model_registry.rb +75 -0
  44. data/lib/aia/network_builder.rb +17 -11
  45. data/lib/aia/network_memory_manager.rb +6 -6
  46. data/lib/aia/patches/ruby_llm_streaming_error.rb +21 -4
  47. data/lib/aia/patches/ruby_llm_tool_param_compat.rb +18 -0
  48. data/lib/aia/pipeline_orchestrator.rb +88 -45
  49. data/lib/aia/plugin_monitor.rb +9 -6
  50. data/lib/aia/prompt_decomposer.rb +6 -4
  51. data/lib/aia/prompt_handler.rb +90 -69
  52. data/lib/aia/provider_registry.rb +105 -0
  53. data/lib/aia/robot_builder.rb +1 -1
  54. data/lib/aia/robot_factory.rb +77 -69
  55. data/lib/aia/robot_namer.rb +2 -8
  56. data/lib/aia/robot_sync.rb +79 -0
  57. data/lib/aia/role_catalog.rb +89 -0
  58. data/lib/aia/session.rb +32 -14
  59. data/lib/aia/session_tracker.rb +39 -41
  60. data/lib/aia/similarity_scorer.rb +5 -3
  61. data/lib/aia/skill_utils.rb +60 -19
  62. data/lib/aia/spawn_handler.rb +16 -4
  63. data/lib/aia/spawn_spec_parser.rb +6 -7
  64. data/lib/aia/special_mode_handler.rb +80 -57
  65. data/lib/aia/speech.rb +103 -0
  66. data/lib/aia/startup_coordinator.rb +17 -91
  67. data/lib/aia/streaming_runner.rb +16 -5
  68. data/lib/aia/system_prompt_assembler.rb +20 -15
  69. data/lib/aia/task_board.rb +60 -0
  70. data/lib/aia/task_coordinator.rb +10 -5
  71. data/lib/aia/timing.rb +15 -0
  72. data/lib/aia/tool_approver.rb +205 -0
  73. data/lib/aia/tool_filter.rb +1 -9
  74. data/lib/aia/tool_filter_strategy.rb +39 -25
  75. data/lib/aia/tool_introspection.rb +25 -0
  76. data/lib/aia/tool_loader.rb +71 -31
  77. data/lib/aia/tool_utility.rb +6 -5
  78. data/lib/aia/tools/delegate_to_foreman_tool.rb +6 -4
  79. data/lib/aia/tools/recruit_robot_tool.rb +12 -12
  80. data/lib/aia/tools/reskill_robot_tool.rb +7 -7
  81. data/lib/aia/tools/task_board_tool.rb +17 -16
  82. data/lib/aia/trakflow_bridge.rb +19 -11
  83. data/lib/aia/turn_state.rb +32 -8
  84. data/lib/aia/ui_presenter.rb +83 -59
  85. data/lib/aia/utility.rb +8 -24
  86. data/lib/aia/variable_input_collector.rb +1 -3
  87. data/lib/aia/verification_network.rb +10 -12
  88. data/lib/aia.rb +49 -8
  89. metadata +27 -162
  90. data/.better-commits.json +0 -150
  91. data/.config/tocer/configuration.yml +0 -6
  92. data/.envrc +0 -15
  93. data/.loki +0 -231
  94. data/.quality/flay_baseline.txt +0 -1
  95. data/.quality/flog_baseline.txt +0 -29
  96. data/.quality/reek_baseline.txt +0 -80
  97. data/.rubocop.yml +0 -116
  98. data/COMMITS.md +0 -196
  99. data/IMPLEMENTATION_PLAN.md +0 -506
  100. data/Rakefile +0 -160
  101. data/architecture_review.md +0 -314
  102. data/docs/AGENTS.md +0 -40
  103. data/docs/advanced-prompting.md +0 -814
  104. data/docs/assets/images/aia.png +0 -0
  105. data/docs/cli-reference.md +0 -1241
  106. data/docs/configuration.md +0 -747
  107. data/docs/contributing.md +0 -386
  108. data/docs/directives-reference.md +0 -1145
  109. data/docs/examples/index.md +0 -277
  110. data/docs/examples/mcp/index.md +0 -475
  111. data/docs/examples/prompts/analysis/index.md +0 -78
  112. data/docs/examples/prompts/automation/index.md +0 -109
  113. data/docs/examples/prompts/development/index.md +0 -125
  114. data/docs/examples/prompts/index.md +0 -333
  115. data/docs/examples/prompts/learning/index.md +0 -127
  116. data/docs/examples/prompts/writing/index.md +0 -62
  117. data/docs/examples/tools/index.md +0 -282
  118. data/docs/faq.md +0 -578
  119. data/docs/guides/available-models.md +0 -366
  120. data/docs/guides/basic-usage.md +0 -478
  121. data/docs/guides/chat.md +0 -680
  122. data/docs/guides/crew.md +0 -239
  123. data/docs/guides/executable-prompts.md +0 -331
  124. data/docs/guides/first-prompt.md +0 -454
  125. data/docs/guides/getting-started.md +0 -455
  126. data/docs/guides/image-generation.md +0 -507
  127. data/docs/guides/index.md +0 -48
  128. data/docs/guides/local-models.md +0 -306
  129. data/docs/guides/migrate-prompts.md +0 -335
  130. data/docs/guides/models.md +0 -1017
  131. data/docs/guides/shared-tools.md +0 -254
  132. data/docs/guides/tools.md +0 -831
  133. data/docs/index.md +0 -259
  134. data/docs/installation.md +0 -274
  135. data/docs/mcp-integration.md +0 -603
  136. data/docs/prompt_management.md +0 -665
  137. data/docs/security.md +0 -674
  138. data/docs/special_projects_guide.md +0 -386
  139. data/docs/tools-and-mcp-examples.md +0 -1211
  140. data/docs/workflows-and-pipelines.md +0 -636
  141. data/examples/.gitignore +0 -2
  142. data/examples/00_setup_aia.sh +0 -111
  143. data/examples/01_basic_usage.sh +0 -23
  144. data/examples/02_frontmatter.sh +0 -33
  145. data/examples/03_shell_integration.sh +0 -55
  146. data/examples/04_erb_templating.sh +0 -56
  147. data/examples/05_shell_then_erb.sh +0 -38
  148. data/examples/06_prompt_chaining.sh +0 -59
  149. data/examples/07_pipeline.sh +0 -46
  150. data/examples/08_context_files.sh +0 -43
  151. data/examples/09_roles.sh +0 -67
  152. data/examples/10_stdin_piping.sh +0 -49
  153. data/examples/11_multi_model.sh +0 -65
  154. data/examples/12_token_usage.sh +0 -52
  155. data/examples/13_cost_tracking.sh +0 -68
  156. data/examples/14_output_file.sh +0 -91
  157. data/examples/15_parameters.sh +0 -68
  158. data/examples/16_directives.sh +0 -113
  159. data/examples/17_require_and_conditionals.sh +0 -68
  160. data/examples/18_tools.sh +0 -61
  161. data/examples/19_local_tools.sh +0 -34
  162. data/examples/20_mcp_servers.sh +0 -102
  163. data/examples/21_executable_prompts.sh +0 -78
  164. data/examples/22_chat_mode.sh +0 -217
  165. data/examples/23_verify.sh +0 -139
  166. data/examples/24_decompose.sh +0 -139
  167. data/examples/25_spawn.sh +0 -139
  168. data/examples/26_debate.sh +0 -97
  169. data/examples/27_mention_routing.sh +0 -157
  170. data/examples/28_model_switching.sh +0 -106
  171. data/examples/29_agent_harness.sh +0 -177
  172. data/examples/README.md +0 -321
  173. data/examples/advanced_multi_robot_capabilities_without_examples.md +0 -106
  174. data/examples/aia_config.yml +0 -22
  175. data/examples/aia_config_orchestrator.yml +0 -45
  176. data/examples/aia_config_with_mcp.yml +0 -21
  177. data/examples/common.sh +0 -39
  178. data/examples/context/project_goals.md +0 -6
  179. data/examples/context/tech_stack.md +0 -7
  180. data/examples/directives/timestamp_directive.rb +0 -22
  181. data/examples/mcp/filesystem.json +0 -9
  182. data/examples/prompts_dir/analyze.md +0 -2
  183. data/examples/prompts_dir/brainstorm.md +0 -2
  184. data/examples/prompts_dir/conditional.md +0 -17
  185. data/examples/prompts_dir/creative.md +0 -4
  186. data/examples/prompts_dir/erbinfo.md +0 -5
  187. data/examples/prompts_dir/erbinfo_raw.md +0 -8
  188. data/examples/prompts_dir/evaluate.md +0 -2
  189. data/examples/prompts_dir/explain_joke.md +0 -1
  190. data/examples/prompts_dir/explain_recursion.md +0 -1
  191. data/examples/prompts_dir/fun_fact +0 -3
  192. data/examples/prompts_dir/greeting.md +0 -8
  193. data/examples/prompts_dir/greeting_required.md +0 -7
  194. data/examples/prompts_dir/hello.md +0 -1
  195. data/examples/prompts_dir/includes/ruby_facts.md +0 -4
  196. data/examples/prompts_dir/limerick.md +0 -1
  197. data/examples/prompts_dir/list_with_mcp.md +0 -3
  198. data/examples/prompts_dir/pick_best.md +0 -2
  199. data/examples/prompts_dir/project_summary +0 -12
  200. data/examples/prompts_dir/quiz_with_include.md +0 -6
  201. data/examples/prompts_dir/require_demo.md +0 -5
  202. data/examples/prompts_dir/roles/formal.md +0 -3
  203. data/examples/prompts_dir/roles/orchestrator.md +0 -21
  204. data/examples/prompts_dir/roles/pirate.md +0 -3
  205. data/examples/prompts_dir/shell_then_erb.md +0 -6
  206. data/examples/prompts_dir/sort_compare.md +0 -2
  207. data/examples/prompts_dir/summarize_context.md +0 -2
  208. data/examples/prompts_dir/sysinfo.md +0 -5
  209. data/examples/prompts_dir/sysinfo_raw.md +0 -8
  210. data/examples/prompts_dir/tagline.md +0 -1
  211. data/examples/prompts_dir/tell_joke.md +0 -1
  212. data/examples/prompts_dir/tell_joke_with_next.md +0 -4
  213. data/examples/prompts_dir/use_local_tool.md +0 -8
  214. data/examples/prompts_dir/use_tools.md +0 -8
  215. data/examples/prompts_dir/weather.md +0 -2
  216. data/examples/prompts_dir/whats_new.md +0 -2
  217. data/examples/prompts_dir/with_timestamp.md +0 -5
  218. data/examples/requirements/sinatra_taskflow_app.md +0 -139
  219. data/examples/rules/01_classify_ruby.rb +0 -16
  220. data/examples/rules/02_prefer_claude_for_code.rb +0 -19
  221. data/examples/rules/03_gate_prompt_length.rb +0 -19
  222. data/examples/rules/04_tool_selection.rb +0 -41
  223. data/examples/rules/README.md +0 -30
  224. data/examples/run_all.sh +0 -294
  225. data/examples/tools/word_count_tool.rb +0 -30
  226. data/lib/AGENTS.md +0 -57
  227. data/lib/aia/model_switch_handler.rb +0 -100
  228. data/mcp_servers/README.md +0 -110
  229. data/mcp_servers/apple-mcp.json +0 -8
  230. data/mcp_servers/filesystem.json +0 -9
  231. data/mcp_servers/mcp_server_chart.json +0 -11
  232. data/mcp_servers/playwright_one.json +0 -8
  233. data/mcp_servers/playwright_server_definition.json +0 -9
  234. data/mcp_servers/playwright_two.json +0 -8
  235. data/mcp_servers/tavily_mcp_server.json +0 -8
  236. data/mkdocs.yml +0 -169
@@ -1,386 +0,0 @@
1
- <!-- Tocer[start]: Auto-generated, don't remove. -->
2
-
3
- ## Table of Contents
4
-
5
- - [Special Projects Guide](#special-projects-guide)
6
- - [Table of Contents](#table-of-contents)
7
- - [Dynamic Model Switching](#dynamic-model-switching)
8
- - [@mention Routing](#mention-routing)
9
- - [Supported Phrases](#supported-phrases)
10
- - [How It Works](#how-it-works)
11
- - [Model Aliases](#model-aliases)
12
- - [Custom Aliases](#custom-aliases)
13
- - [Conversation History on Switch](#conversation-history-on-switch)
14
- - [MCP Server Concurrency](#mcp-server-concurrency)
15
- - [Configuration](#configuration)
16
- - [Three Ways to Trigger](#three-ways-to-trigger)
17
- - [Server Grouping](#server-grouping)
18
- - [TrakFlow Integration](#trakflow-integration)
19
- - [Setup](#setup)
20
- - [Chat Directives](#chat-directives)
21
- - [Pipeline Tracking](#pipeline-tracking)
22
- - [Session Continuity](#session-continuity)
23
- - [Expert Routing](#expert-routing)
24
- - [Enable](#enable)
25
- - [How It Works](#how-it-works-1)
26
- - [Example Flow](#example-flow)
27
- - [Verification Networks](#verification-networks)
28
- - [Usage](#usage)
29
- - [How It Works](#how-it-works-2)
30
- - [Prompt Decomposition](#prompt-decomposition)
31
- - [Usage](#usage-1)
32
- - [How It Works](#how-it-works-3)
33
- - [Session Tracking and Learning](#session-tracking-and-learning)
34
- - [What's Tracked](#whats-tracked)
35
- - [Learning Rules](#learning-rules)
36
- - [Configuration Reference](#configuration-reference)
37
- - [New Config Sections](#new-config-sections)
38
- - [MCP Server Metadata Fields](#mcp-server-metadata-fields)
39
-
40
- <!-- Tocer[finish]: Auto-generated, don't remove. -->
41
-
42
- # Special Projects Guide
43
-
44
- This guide documents the advanced features implemented from the Special Projects roadmap. Each feature builds on AIA v2's architecture of RobotFactory, ChatLoop, and the directive system.
45
-
46
- ## Table of Contents
47
-
48
- 1. [Dynamic Model Switching](#dynamic-model-switching)
49
- 2. [MCP Server Concurrency](#mcp-server-concurrency)
50
- 3. [TrakFlow Integration](#trakflow-integration)
51
- 4. [Expert Routing](#expert-routing)
52
- 5. [Verification Networks](#verification-networks)
53
- 6. [Prompt Decomposition](#prompt-decomposition)
54
- 7. [Session Tracking and Learning](#session-tracking-and-learning)
55
- 8. [Configuration Reference](#configuration-reference)
56
-
57
- ---
58
-
59
- ## Dynamic Model Switching
60
-
61
- Switch models mid-chat using natural language instead of the formal `/model` directive.
62
-
63
- ### @mention Routing
64
- In a multi-model network, route a message to a specific robot by prefixing its registered name with `@`:
65
- ```
66
- @tobor Explain your reasoning step by step.
67
- ```
68
- Use `/robots` to see the active crew and their `@mention` handles. The mention router scans the input for `@name` tokens, matches them against robot names, and routes the prompt only to the mentioned robots.
69
-
70
- ### Supported Phrases
71
-
72
- - **Switch**: "switch to claude", "use GPT-4o", "try gemini"
73
- - **Compare**: "compare claude and gemini", "hear from both models"
74
- - **Capability**: "use something cheaper", "switch to the best model"
75
-
76
- ### How It Works
77
-
78
- 1. The classification KB detects model-change intent
79
- 2. `ModelSwitchHandler` extracts model names from the text
80
- 3. Names are resolved through `ModelAliasRegistry`
81
- 4. User is asked to confirm before switching
82
- 5. Robot is rebuilt with the new model(s)
83
-
84
- ### Model Aliases
85
-
86
- Short names, provider names, and capability descriptors all resolve to model IDs:
87
-
88
- | Alias | Resolves To |
89
- |-------|------------|
90
- | claude, sonnet | claude-sonnet-4-20250514 |
91
- | opus | claude-opus-4-20250514 |
92
- | haiku, fast | claude-haiku-4-5-20251001 |
93
- | gpt4, gpt4o | gpt-4o |
94
- | cheap, gpt4mini | gpt-4o-mini |
95
- | best | claude-opus-4-20250514 |
96
- | gemini, flash | gemini-2.0-flash |
97
- | llama | llama-3.1-70b |
98
- | anthropic | claude-sonnet-4-20250514 |
99
- | openai | gpt-4o |
100
- | google | gemini-2.0-flash |
101
- | meta | llama-3.1-70b |
102
- | coding | claude-sonnet-4-20250514 |
103
- | vision | gpt-4o |
104
-
105
- ### Custom Aliases
106
-
107
- Add custom aliases in your config:
108
-
109
- ```yaml
110
- # ~/.config/aia/aia.yml
111
- model_aliases:
112
- mymodel: my-custom-model-id
113
- team: our-fine-tuned-model
114
- ```
115
-
116
- ### Conversation History on Switch
117
-
118
- Control what happens to conversation history when switching models:
119
-
120
- ```yaml
121
- model_switch_history: clean # fresh start (default)
122
- model_switch_history: replay # replay all messages to new model
123
- model_switch_history: summarize # summarize and inject context
124
- ```
125
-
126
- ---
127
-
128
- ## MCP Server Concurrency
129
-
130
- When a prompt needs multiple independent MCP servers, AIA can fan out to a robot-per-server and merge results.
131
-
132
- ### Configuration
133
-
134
- Add `topics` to your MCP server configs for domain-driven routing:
135
-
136
- ```json
137
- {
138
- "mcpServers": {
139
- "filesystem": {
140
- "command": "npx",
141
- "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"],
142
- "topics": ["files", "code", "directory"]
143
- },
144
- "database": {
145
- "command": "python",
146
- "args": ["-m", "mcp_server_sqlite"],
147
- "topics": ["data", "sql", "records"]
148
- }
149
- }
150
- }
151
- ```
152
-
153
- ### Three Ways to Trigger
154
-
155
- 1. **Directive**: `/concurrent` before your prompt
156
- 2. **Auto-detection**: Set `concurrency.auto: true` in config
157
- 3. **Config-driven**: List independent servers in config
158
-
159
- ```yaml
160
- # ~/.config/aia/aia.yml
161
- concurrency:
162
- auto: true
163
- independent_servers: [filesystem, database, web_search]
164
- threshold: 2 # minimum independent servers to trigger
165
- ```
166
-
167
- ### Server Grouping
168
-
169
- Servers can be grouped for sequential access:
170
-
171
- ```json
172
- {
173
- "mcpServers": {
174
- "db_reader": {
175
- "command": "...",
176
- "group": "database"
177
- },
178
- "db_writer": {
179
- "command": "...",
180
- "group": "database"
181
- }
182
- }
183
- }
184
- ```
185
-
186
- Grouped servers run sequentially within their group; different groups run concurrently.
187
-
188
- ---
189
-
190
- ## TrakFlow Integration
191
-
192
- TrakFlow is a distributed task tracking system for AI agents. AIA connects to it as an MCP server.
193
-
194
- ### Setup
195
-
196
- ```bash
197
- # Add TrakFlow MCP to your AIA config
198
- aia --mcp mcp_servers/trak_flow.json --chat
199
- ```
200
-
201
- ### Chat Directives
202
-
203
- | Directive | Description |
204
- |-----------|-------------|
205
- | `/tasks` | Show ready tasks |
206
- | `/tasks summary` | Show project summary |
207
- | `/tf` | Alias for `/tasks` |
208
- | `/plan <description>` | Create a TrakFlow plan |
209
- | `/task <title>` | Create a single task |
210
-
211
- ### Pipeline Tracking
212
-
213
- Enable automatic pipeline tracking in TrakFlow:
214
-
215
- ```yaml
216
- flags:
217
- track_pipeline: true
218
- ```
219
-
220
- When enabled, AIA creates a TrakFlow Plan for each pipeline and updates task status as steps complete:
221
-
222
- ```
223
- Pipeline: summarize → analyze → recommend
224
-
225
- TrakFlow Plan:
226
- Step 1: summarize → started → completed ✓
227
- Step 2: analyze → started → completed ✓
228
- Step 3: recommend → started → in_progress...
229
- ```
230
-
231
- ### Session Continuity
232
-
233
- When TrakFlow is connected and you start a chat session, AIA checks for open tasks from previous sessions:
234
-
235
- ```
236
- Open tasks from previous sessions found:
237
- - Step 4: Review auth module (blocked - needs user input)
238
- - Task: Update documentation (ready)
239
- ```
240
-
241
- ---
242
-
243
- ## Expert Routing
244
-
245
- Route different prompt types to specialist robots with different models and MCP servers.
246
-
247
- ### Enable
248
-
249
- ```yaml
250
- flags:
251
- expert_routing: true
252
- ```
253
-
254
- ### How It Works
255
-
256
- 1. The prompt is categorized by domain (code, data, image, planning)
257
- 2. The best model for that domain is selected
258
- 3. Relevant MCP servers are activated
259
- 4. `ExpertRouter` builds a specialist robot with those specifics
260
- 5. The specialist handles the prompt instead of the default robot
261
-
262
- ### Example Flow
263
-
264
- ```
265
- User: "Refactor the auth module"
266
- → Classification: domain=code
267
- → Model Selection: claude-sonnet (code task)
268
- → MCP Routing: filesystem server activated
269
- → Expert robot built with claude-sonnet + filesystem MCP
270
- → Specialist handles the prompt
271
- ```
272
-
273
- ---
274
-
275
- ## Verification Networks
276
-
277
- Use consensus for quality — two robots independently answer, then a third reconciles.
278
-
279
- ### Usage
280
-
281
- ```
282
- /verify
283
- How does quantum entanglement work?
284
- ```
285
-
286
- ### How It Works
287
-
288
- 1. Two verifier robots independently answer the question
289
- 2. A reconciler compares both answers
290
- 3. The reconciler produces a final, verified answer noting agreements and uncertainties
291
-
292
- ---
293
-
294
- ## Prompt Decomposition
295
-
296
- For complex prompts, a coordinator breaks them into independent sub-tasks, executes them in parallel, then synthesizes.
297
-
298
- ### Usage
299
-
300
- ```
301
- /decompose
302
- Research current AI safety approaches, compare them with historical precedents,
303
- and recommend a framework for our team.
304
- ```
305
-
306
- ### How It Works
307
-
308
- 1. The robot analyzes the prompt and identifies 2-5 independent sub-tasks
309
- 2. Each sub-task runs separately
310
- 3. Results are synthesized into a coherent response
311
-
312
- If the prompt cannot be meaningfully decomposed, it falls back to normal execution.
313
-
314
- ---
315
-
316
- ## Session Tracking and Learning
317
-
318
- AIA tracks session metrics for the post-response learning loop.
319
-
320
- ### What's Tracked
321
-
322
- Per turn:
323
- - Model used
324
- - Input length
325
- - Token counts
326
- - Cost estimate
327
- - Routing decisions
328
- - Timestamp
329
-
330
- Session-wide:
331
- - Total turns
332
- - Total cost
333
- - Total tokens
334
- - Model switch events
335
- - User feedback signals
336
-
337
- ### Learning Rules
338
-
339
- The post-response learning step fires after each response:
340
-
341
- | Rule | Signal | Meaning |
342
- |------|--------|---------|
343
- | `track_model_switch` | model_dissatisfaction | User switched models after a response |
344
- | `track_success` | model_success | User accepted the response |
345
- | `cost_tracking` | cost_update | Running cost total |
346
-
347
- These signals are currently informational. Future versions can use them to automatically adjust routing rules.
348
-
349
- ---
350
-
351
- ## Configuration Reference
352
-
353
- ### New Config Sections
354
-
355
- ```yaml
356
- # ~/.config/aia/aia.yml
357
-
358
- # Model aliases (custom overrides)
359
- model_aliases:
360
- mymodel: my-custom-model-id
361
-
362
- # History mode on model switch
363
- model_switch_history: clean # clean | replay | summarize
364
-
365
- # MCP concurrency
366
- concurrency:
367
- auto: false
368
- independent_servers: []
369
- threshold: 2
370
-
371
- # New flags
372
- flags:
373
- track_pipeline: false # Track pipelines in TrakFlow
374
- expert_routing: false # Per-turn expert routing
375
- ```
376
-
377
- ### MCP Server Metadata Fields
378
-
379
- ```json
380
- {
381
- "topics": ["code", "files"],
382
- "independent": true,
383
- "group": "database"
384
- }
385
- ```
386
-