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,455 +0,0 @@
1
- # Getting Started with AIA
2
-
3
- This guide will walk you through your first steps with AIA, from basic usage to creating your first prompts and workflows.
4
-
5
- ## Prerequisites
6
-
7
- Before starting, make sure you have:
8
-
9
- - [Installed AIA](../installation.md)
10
- - Set up your API keys (see [Installation](../installation.md#4-set-up-api-keys))
11
- - Created your prompts directory (`~/.prompts`)
12
-
13
- ## Your First AIA Command
14
-
15
- Let's start with the simplest possible usage:
16
-
17
- ```bash
18
- aia --chat
19
- ```
20
-
21
- This opens an interactive chat session. Type your question and press Enter:
22
-
23
- ```
24
- You: Hello, what can you help me with?
25
- AI: Hello! I'm an AI assistant that can help you with a wide variety of tasks...
26
- ```
27
-
28
- Type `exit` or press Ctrl+C to end the chat.
29
-
30
- ## Basic Usage Patterns
31
-
32
- ### 1. Direct Questions
33
-
34
- Ask questions directly without creating prompt files:
35
-
36
- ```bash
37
- # Simple question
38
- aia --chat "What's the capital of France?"
39
-
40
- # Technical question
41
- aia --chat "Explain how HTTP works"
42
- ```
43
-
44
- ### 2. Using Different Models
45
-
46
- Specify which AI model to use:
47
-
48
- ```bash
49
- # Use GPT-4
50
- aia --model gpt-4 --chat
51
-
52
- # Use Claude
53
- aia --model claude-3-sonnet --chat
54
-
55
- # See all available models
56
- aia --available-models
57
- ```
58
-
59
- ### 3. Adjusting AI Behavior
60
-
61
- Control the AI's response style:
62
-
63
- ```bash
64
- # More creative responses
65
- aia --temperature 1.2 --chat
66
-
67
- # More focused responses
68
- aia --temperature 0.3 --chat
69
-
70
- # Shorter responses
71
- aia --terse --chat
72
-
73
- # Limit response length
74
- aia --max-tokens 100 --chat
75
- ```
76
-
77
- ## Creating Your First Prompt
78
-
79
- Instead of typing questions each time, you can create reusable prompt files.
80
-
81
- ### 1. Create a Simple Prompt
82
-
83
- ```bash
84
- # Create your first prompt file
85
- echo "Explain this code and suggest improvements:" > ~/.prompts/code_review.md
86
- ```
87
-
88
- ### 2. Use the Prompt
89
-
90
- ```bash
91
- # Run the prompt (you'll be asked for the code to review)
92
- aia code_review
93
-
94
- # Or provide a context file
95
- aia code_review my_script.py
96
- ```
97
-
98
- ### 3. Create a More Complex Prompt
99
-
100
- ```bash
101
- cat > ~/.prompts/blog_writer.md << 'EOF'
102
- Write a professional blog post about the following topic:
103
-
104
- Topic: <%= topic %>
105
- Target audience: <%= audience %>
106
- Word count: <%= word_count %>
107
-
108
- Please include:
109
- - An engaging introduction
110
- - Well-structured main points
111
- - A compelling conclusion
112
- - SEO-friendly headings
113
- EOF
114
- ```
115
-
116
- Use it with parameters:
117
-
118
- ```bash
119
- aia blog_writer --topic "AI productivity tools" --audience "developers" --word_count 800
120
- ```
121
-
122
- ## Understanding Prompts with Context
123
-
124
- AIA can include context from files:
125
-
126
- ### 1. Review Code Files
127
-
128
- ```bash
129
- # Review a specific file
130
- aia code_review src/main.rb
131
-
132
- # Review multiple files
133
- aia code_review src/*.rb
134
- ```
135
-
136
- ### 2. Analyze Documents
137
-
138
- ```bash
139
- # Analyze a document
140
- echo "Summarize this document and extract key points:" > ~/.prompts/summarize.md
141
- aia summarize report.pdf
142
- ```
143
-
144
- ### 3. Process Data Files
145
-
146
- ```bash
147
- # Create a data analysis prompt
148
- echo "Analyze this data and provide insights:" > ~/.prompts/analyze_data.md
149
- aia analyze_data data.csv
150
- ```
151
-
152
- ## Using Directives
153
-
154
- Prompts can include special directives for dynamic behavior:
155
-
156
- ### 1. Configuration Directives
157
-
158
- ```bash
159
- cat > ~/.prompts/creative_writing.md << 'EOF'
160
- /config temperature 1.3
161
- /config max_tokens 2000
162
- /config model gpt-4
163
-
164
- Write a creative short story about:
165
- <%= topic %>
166
-
167
- Make it engaging and unique!
168
- EOF
169
- ```
170
-
171
- ### 2. File Inclusion Directives
172
-
173
- ```bash
174
- cat > ~/.prompts/project_analysis.md << 'EOF'
175
- Analyze this project structure and provide recommendations:
176
-
177
- /include README.md
178
- /include package.json
179
- /include src/
180
-
181
- Focus on architecture, dependencies, and best practices.
182
- EOF
183
- ```
184
-
185
- ### 3. Shell Command Directives
186
-
187
- ```bash
188
- cat > ~/.prompts/system_status.md << 'EOF'
189
- Here's my current system status:
190
-
191
- CPU Usage:
192
- /shell top -l 1 -n 10 | head -20
193
-
194
- Disk Usage:
195
- /shell df -h
196
-
197
- Memory Usage:
198
- /shell free -h
199
-
200
- Please analyze this and suggest optimizations.
201
- EOF
202
- ```
203
-
204
- ## Working with Roles
205
-
206
- Roles help set context for the AI:
207
-
208
- ### 1. Create a Role File
209
-
210
- ```bash
211
- mkdir -p ~/.prompts/roles
212
- cat > ~/.prompts/roles/code_expert.md << 'EOF'
213
- You are an expert software developer with 15+ years of experience.
214
- You specialize in clean code, best practices, and modern development patterns.
215
- Always provide specific, actionable advice with code examples.
216
- EOF
217
- ```
218
-
219
- ### 2. Use the Role
220
-
221
- ```bash
222
- aia --role code_expert code_review my_app.rb
223
- ```
224
-
225
- ## Fuzzy Search (with fzf)
226
-
227
- If you have `fzf` installed, you can use fuzzy search:
228
-
229
- ```bash
230
- # Search for prompts interactively
231
- aia --fuzzy
232
-
233
- # This opens a searchable list of all your prompts
234
- ```
235
-
236
- ## Saving Output
237
-
238
- Save AI responses to files:
239
-
240
- ```bash
241
- # Save to a file
242
- aia --output response.md my_prompt
243
-
244
- # Append to an existing file
245
- aia --output response.md --append my_prompt
246
-
247
- # Format with Markdown
248
- aia --output response.md --markdown my_prompt
249
- ```
250
-
251
- ## Chat Mode Features
252
-
253
- ### 1. Persistent Chat
254
-
255
- ```bash
256
- # Start a chat that remembers context
257
- aia --chat
258
- ```
259
-
260
- Within chat:
261
- - Your conversation history is maintained
262
- - You can reference previous messages
263
- - Type `/help` for chat commands
264
- - Type `/save filename.md` to save the conversation
265
-
266
- ### 2. Chat with Initial Prompt
267
-
268
- ```bash
269
- # Start chat with a specific role/prompt
270
- aia --chat --role code_expert
271
- aia --chat system_architect
272
- ```
273
-
274
- ### 3. Multi-turn Conversations
275
-
276
- ```bash
277
- You: Explain REST APIs
278
- AI: [Detailed explanation of REST APIs...]
279
-
280
- You: Now give me a Python example
281
- AI: [Python code example using the previous REST context...]
282
-
283
- You: How would you test this?
284
- AI: [Testing strategies specific to the Python example...]
285
- ```
286
-
287
- ## Common Workflows
288
-
289
- ### 1. Code Review Workflow
290
-
291
- ```bash
292
- # Set up the workflow
293
- echo "Review this code for bugs, style, and improvements:" > ~/.prompts/code_review.md
294
-
295
- # Use it regularly
296
- aia code_review src/new_feature.py
297
- aia --model claude-3-sonnet code_review complex_algorithm.rb
298
- ```
299
-
300
- ### 2. Documentation Workflow
301
-
302
- ```bash
303
- # Create documentation prompt
304
- cat > ~/.prompts/document_code.md << 'EOF'
305
- Generate comprehensive documentation for this code:
306
-
307
- /include <%= file %>
308
-
309
- Include:
310
- - Purpose and functionality
311
- - Parameters and return values
312
- - Usage examples
313
- - Edge cases and considerations
314
- EOF
315
-
316
- # Use it
317
- aia document_code --file src/api.py
318
- ```
319
-
320
- ### 3. Learning Workflow
321
-
322
- ```bash
323
- # Create learning prompt
324
- cat > ~/.prompts/explain_concept.md << 'EOF'
325
- /config temperature 0.7
326
- /role teacher
327
-
328
- Explain the concept of "<%= concept %>" in simple terms.
329
-
330
- Include:
331
- - Definition and core principles
332
- - Real-world examples
333
- - Common use cases
334
- - Key benefits and drawbacks
335
- - Related concepts
336
-
337
- Adjust the explanation for a <%= level %> level understanding.
338
- EOF
339
-
340
- # Use it for learning
341
- aia explain_concept --concept "microservices" --level "beginner"
342
- aia explain_concept --concept "machine learning" --level "intermediate"
343
- ```
344
-
345
- ## Best Practices
346
-
347
- ### 1. Organize Your Prompts
348
-
349
- ```bash
350
- # Create a logical directory structure
351
- mkdir -p ~/.prompts/{development,writing,analysis,personal}
352
-
353
- # Categorize prompts
354
- mv ~/.prompts/code_review.md ~/.prompts/development/
355
- mv ~/.prompts/blog_writer.md ~/.prompts/writing/
356
- ```
357
-
358
- ### 2. Use Descriptive Names
359
-
360
- ```bash
361
- # Good prompt names
362
- ~/.prompts/development/code_review_security.md
363
- ~/.prompts/writing/blog_post_technical.md
364
- ~/.prompts/analysis/data_insights.md
365
-
366
- # Avoid generic names
367
- ~/.prompts/prompt1.md
368
- ~/.prompts/test.md
369
- ```
370
-
371
- ### 3. Version Control Your Prompts
372
-
373
- ```bash
374
- cd ~/.prompts
375
- git init
376
- git add .
377
- git commit -m "Initial prompt collection"
378
-
379
- # Keep your prompts under version control
380
- git add new_prompt.md
381
- git commit -m "Add prompt for API documentation"
382
- ```
383
-
384
- ### 4. Test Different Models
385
-
386
- ```bash
387
- # Test with different models to find the best fit
388
- aia --model gpt-3.5-turbo code_review app.py
389
- aia --model gpt-4 code_review app.py
390
- aia --model claude-3-sonnet code_review app.py
391
-
392
- # Compare outputs and choose the best model for each task
393
- ```
394
-
395
- ## Next Steps
396
-
397
- Now that you understand the basics:
398
-
399
- 1. **Explore Advanced Features**:
400
- - [Chat Mode Guide](chat.md)
401
- - [Working with Models](models.md)
402
- - [Tools Integration](tools.md)
403
-
404
- 2. **Learn Advanced Techniques**:
405
- - [Advanced Prompting](../advanced-prompting.md)
406
- - [Workflows & Pipelines](../workflows-and-pipelines.md)
407
- - [Prompt Management](../prompt_management.md)
408
-
409
- 3. **Browse Examples**:
410
- - [Examples Directory](../examples/index.md)
411
- - [Tools & MCP Examples](../tools-and-mcp-examples.md)
412
-
413
- 4. **Reference Documentation**:
414
- - [CLI Reference](../cli-reference.md)
415
- - [Directives Reference](../directives-reference.md)
416
- - [Configuration Guide](../configuration.md)
417
-
418
- ## Troubleshooting
419
-
420
- ### Common Issues
421
-
422
- #### "No prompt found"
423
- - Check that the prompt file exists: `ls ~/.prompts/`
424
- - Verify the filename matches what you're typing
425
- - Try fuzzy search: `aia --fuzzy`
426
-
427
- #### "Model not available"
428
- - Check your API keys: `echo $OPENAI_API_KEY`
429
- - List available models: `aia --available-models`
430
- - Check your internet connection
431
-
432
- #### "Permission denied"
433
- - Check file permissions: `ls -la ~/.prompts/`
434
- - Ensure the prompts directory is readable
435
-
436
- ### Getting Help
437
-
438
- - Use `aia --help` for command help
439
- - Use `--verbose` flag to see what AIA is doing
440
- - Use `--debug` flag for detailed debugging information
441
- - Check the [FAQ](../faq.md) for common questions
442
- - Report issues on [GitHub](https://github.com/MadBomber/aia/issues)
443
-
444
- ## Summary
445
-
446
- You've learned:
447
-
448
- - ✅ How to run basic AIA commands
449
- - ✅ How to create and use prompts
450
- - ✅ How to work with different AI models
451
- - ✅ How to use roles and context files
452
- - ✅ How to organize your workflow
453
- - ✅ Basic troubleshooting
454
-
455
- You're now ready to explore AIA's more advanced features and create your own AI-powered workflows!