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,454 +0,0 @@
1
- # Your First Prompt
2
-
3
- A step-by-step guide to creating and running your very first AIA prompt, from the simplest examples to more sophisticated patterns.
4
-
5
- ## Before You Start
6
-
7
- Make sure you have:
8
- - [Installed AIA](../installation.md)
9
- - Set up your API keys
10
- - Created your prompts directory (`mkdir -p ~/.prompts`)
11
-
12
- ## The Simplest Prompt
13
-
14
- Let's start with the most basic prompt possible:
15
-
16
- ### Step 1: Create Your First Prompt File
17
- ```bash
18
- echo "What is Ruby programming language?" > ~/.prompts/what_is_ruby.md
19
- ```
20
-
21
- ### Step 2: Run Your Prompt
22
- ```bash
23
- aia what_is_ruby
24
- ```
25
-
26
- That's it! AIA will:
27
- 1. Find your prompt file in `~/.prompts/`
28
- 2. Send it to the default AI model
29
- 3. Display the response in your terminal
30
-
31
- ## Adding Context to Prompts
32
-
33
- Now let's create a prompt that works with files:
34
-
35
- ### Step 1: Create a Context-Aware Prompt
36
- ```bash
37
- cat > ~/.prompts/explain_code.md << 'EOF'
38
- Please explain what this code does:
39
-
40
- <%= context_file %>
41
-
42
- Provide a clear explanation that covers:
43
- - What the code accomplishes
44
- - How it works
45
- - Any potential improvements
46
- EOF
47
- ```
48
-
49
- ### Step 2: Use It with a File
50
- ```bash
51
- # Create a sample code file
52
- echo 'puts "Hello, World!"' > hello.rb
53
-
54
- # Run the prompt with context
55
- aia explain_code hello.rb
56
- ```
57
-
58
- AIA automatically includes the file content where you specified `<%= context_file %>`.
59
-
60
- ## Using Directives
61
-
62
- Directives are special commands in prompts that start with `/`. Let's try some:
63
-
64
- ### Configuration Directives
65
- ```bash
66
- cat > ~/.prompts/detailed_analysis.md << 'EOF'
67
- /config model gpt-4
68
- /config temperature 0.3
69
-
70
- Provide a detailed technical analysis of this code:
71
-
72
- <%= context_file %>
73
-
74
- Focus on:
75
- - Architecture and design patterns
76
- - Performance considerations
77
- - Security implications
78
- - Best practices compliance
79
- EOF
80
- ```
81
-
82
- ### File Inclusion Directives
83
- ```bash
84
- cat > ~/.prompts/project_overview.md << 'EOF'
85
- /include README.md
86
- /include package.json
87
-
88
- Based on the project files above, provide an overview of:
89
- - Project purpose and goals
90
- - Technology stack
91
- - Getting started instructions
92
- - Key dependencies
93
- EOF
94
- ```
95
-
96
- ### Shell Command Directives
97
- ```bash
98
- cat > ~/.prompts/system_status.md << 'EOF'
99
- Current system status:
100
-
101
- /shell date
102
- /shell whoami
103
- /shell uptime
104
- /shell df -h
105
-
106
- Please analyze the system status and provide recommendations.
107
- EOF
108
- ```
109
-
110
- ## Interactive Prompts with Parameters
111
-
112
- Create prompts that accept parameters:
113
-
114
- ### Step 1: Create a Parameterized Prompt
115
- ```bash
116
- cat > ~/.prompts/code_review.md << 'EOF'
117
- /config model gpt-4
118
- /config temperature 0.2
119
-
120
- # Code Review: <%= file_name %>
121
-
122
- Review this <%= language %> code for:
123
- - Bugs and potential issues
124
- - Code quality and style
125
- - Performance optimizations
126
- - Security considerations
127
-
128
- Focus level: <%= focus_level || "standard" %>
129
-
130
- Code to review:
131
- /include <%= file_name %>
132
-
133
- Please provide specific, actionable feedback.
134
- EOF
135
- ```
136
-
137
- ### Step 2: Use with Parameters
138
- ```bash
139
- # ERB-style parameters (in prompt content)
140
- aia code_review --file_name "app.py" --language "Python" --focus_level "security"
141
- ```
142
-
143
- ## Your First Chat Session
144
-
145
- Try AIA's interactive chat mode:
146
-
147
- ### Step 1: Start a Chat
148
- ```bash
149
- aia --chat
150
- ```
151
-
152
- ### Step 2: Have a Conversation
153
- ```
154
- You: Help me understand how to use AIA effectively
155
- AI: I'd be happy to help! AIA is a powerful CLI tool for AI interactions...
156
-
157
- You: Can you help me write a Python function?
158
- AI: Of course! What kind of function would you like to create?
159
-
160
- You: A function that calculates factorial
161
- AI: Here's a Python factorial function...
162
- ```
163
-
164
- ### Step 3: Save Your Conversation
165
- ```
166
- You: /save factorial_help.md
167
- ```
168
-
169
- ## Working with Different Models
170
-
171
- Try different AI models for different tasks:
172
-
173
- ### Quick Tasks
174
- ```bash
175
- aia --model gpt-3.5-turbo what_is_ruby
176
- ```
177
-
178
- ### Complex Analysis
179
- ```bash
180
- aia --model gpt-4 detailed_analysis complex_code.py
181
- ```
182
-
183
- ### Long Documents
184
- ```bash
185
- aia --model claude-3-sonnet project_overview
186
- ```
187
-
188
- ## Creating Your First Workflow
189
-
190
- Chain prompts together for multi-step processes:
191
-
192
- ### Step 1: Create Individual Steps
193
- ```bash
194
- # Step 1: Extract requirements
195
- cat > ~/.prompts/extract_requirements.md << 'EOF'
196
- /next analyze_requirements
197
-
198
- Extract and list all requirements from this project:
199
-
200
- /include README.md
201
- /include requirements.txt
202
-
203
- Provide a structured list of:
204
- - Functional requirements
205
- - Non-functional requirements
206
- - Dependencies
207
- - Constraints
208
- EOF
209
-
210
- # Step 2: Analyze requirements
211
- cat > ~/.prompts/analyze_requirements.md << 'EOF'
212
- /next generate_recommendations
213
-
214
- Based on the requirements extraction, analyze:
215
- - Completeness of requirements
216
- - Potential conflicts or gaps
217
- - Implementation complexity
218
- - Risk factors
219
- EOF
220
-
221
- # Step 3: Generate recommendations
222
- cat > ~/.prompts/generate_recommendations.md << 'EOF'
223
- Based on the requirements and analysis, provide:
224
- - Implementation recommendations
225
- - Architecture suggestions
226
- - Risk mitigation strategies
227
- - Next steps
228
- EOF
229
- ```
230
-
231
- ### Step 2: Run the Workflow
232
- ```bash
233
- aia extract_requirements
234
- ```
235
-
236
- AIA will automatically run all three prompts in sequence!
237
-
238
- ## Common Beginner Mistakes to Avoid
239
-
240
- ### ❌ Don't: Create overly complex first prompts
241
- ```bash
242
- # Too complex for beginners
243
- cat > ~/.prompts/bad_first_prompt.md << 'EOF'
244
- /config model gpt-4
245
- /config temperature 0.7
246
- /ruby complex_calculations
247
- /shell complex_command | grep something
248
- /include multiple_files.txt
249
-
250
- Perform complex multi-step analysis with advanced features...
251
- EOF
252
- ```
253
-
254
- ### ✅ Do: Start simple and build up
255
- ```bash
256
- # Good first prompt
257
- cat > ~/.prompts/good_first_prompt.md << 'EOF'
258
- Summarize this file in simple terms:
259
-
260
- <%= context_file %>
261
- EOF
262
- ```
263
-
264
- ### ❌ Don't: Ignore error messages
265
- ```bash
266
- # If this fails, read the error message!
267
- aia nonexistent_prompt
268
- ```
269
-
270
- ### ✅ Do: Use debug mode when learning
271
- ```bash
272
- # See what AIA is doing
273
- aia --debug --verbose your_prompt
274
- ```
275
-
276
- ## Practice Exercises
277
-
278
- Try these exercises to reinforce what you've learned:
279
-
280
- ### Exercise 1: File Analyzer
281
- Create a prompt that analyzes any file type and provides insights.
282
-
283
- ```bash
284
- cat > ~/.prompts/analyze_file.md << 'EOF'
285
- Analyze this file:
286
-
287
- /include <%= file %>
288
-
289
- Provide:
290
- - File type and format
291
- - Key content summary
292
- - Purpose and use case
293
- - Any notable features
294
- EOF
295
- ```
296
-
297
- ### Exercise 2: Code Formatter
298
- Create a prompt that suggests code improvements.
299
-
300
- ```bash
301
- cat > ~/.prompts/improve_code.md << 'EOF'
302
- /config temperature 0.3
303
-
304
- Suggest improvements for this code:
305
-
306
- /include <%= code_file %>
307
-
308
- Focus on:
309
- - Readability
310
- - Performance
311
- - Best practices
312
- - Error handling
313
- EOF
314
- ```
315
-
316
- ### Exercise 3: Project Documentation
317
- Create a prompt that generates README content.
318
-
319
- ```bash
320
- cat > ~/.prompts/generate_readme.md << 'EOF'
321
- Generate README.md content for this project:
322
-
323
- Project structure:
324
- /shell find . -type f -name "*.py" -o -name "*.rb" -o -name "*.js" | head -10
325
-
326
- Configuration files:
327
- /shell ls *.json *.yml *.yaml 2>/dev/null || echo "No config files found"
328
-
329
- Create a comprehensive README with:
330
- - Project description
331
- - Installation instructions
332
- - Usage examples
333
- - Contributing guidelines
334
- EOF
335
- ```
336
-
337
- ## Tips for Success
338
-
339
- ### Start Small
340
- - Begin with simple, single-purpose prompts
341
- - Test each prompt thoroughly before making it complex
342
- - Add one new feature at a time
343
-
344
- ### Use Descriptive Names
345
- ```bash
346
- # Good prompt names
347
- ~/.prompts/analyze_python_code.md
348
- ~/.prompts/summarize_research_paper.md
349
- ~/.prompts/generate_api_docs.md
350
-
351
- # Poor prompt names
352
- ~/.prompts/prompt1.md
353
- ~/.prompts/test.md
354
- ~/.prompts/stuff.md
355
- ```
356
-
357
- ### Organize Your Prompts
358
- ```bash
359
- # Create categories
360
- mkdir -p ~/.prompts/{development,analysis,writing,learning}
361
-
362
- # Move prompts to appropriate directories
363
- mv ~/.prompts/code_review.md ~/.prompts/development/
364
- mv ~/.prompts/analyze_file.md ~/.prompts/analysis/
365
- ```
366
-
367
- ### Version Control Your Prompts
368
- ```bash
369
- cd ~/.prompts
370
- git init
371
- git add .
372
- git commit -m "My first AIA prompts"
373
- ```
374
-
375
- ### Experiment and Iterate
376
- - Try different models for the same prompt
377
- - Adjust temperature settings to see the difference
378
- - Refine prompts based on the results you get
379
-
380
- ## Getting Help
381
-
382
- ### Built-in Help
383
- ```bash
384
- # General help
385
- aia --help
386
-
387
- # Model information
388
- aia --available-models
389
-
390
- # Debug information
391
- aia --debug my_prompt
392
- ```
393
-
394
- ### Community Resources
395
- - Check the [FAQ](../faq.md) for common questions
396
- - Browse [Examples](../examples/index.md) for inspiration
397
- - Read the [Advanced Prompting](../advanced-prompting.md) guide when ready
398
-
399
- ## Next Steps
400
-
401
- After mastering your first prompt, explore:
402
-
403
- 1. **[Basic Usage](basic-usage.md)** - Common usage patterns
404
- 2. **[Chat Mode](chat.md)** - Interactive conversations
405
- 3. **[Working with Models](models.md)** - Model selection strategies
406
- 4. **[Tools Integration](tools.md)** - Extending capabilities
407
- 5. **[Advanced Prompting](../advanced-prompting.md)** - Expert techniques
408
-
409
- ## Troubleshooting Your First Prompt
410
-
411
- ### Prompt Not Found
412
- ```bash
413
- # Check if file exists
414
- ls ~/.prompts/your_prompt.md
415
-
416
- # Check file permissions
417
- chmod 644 ~/.prompts/your_prompt.md
418
-
419
- # Use full path if needed
420
- aia --prompts-dir ~/.prompts your_prompt
421
- ```
422
-
423
- ### API Errors
424
- ```bash
425
- # Check API key
426
- echo $OPENAI_API_KEY | cut -c1-10
427
-
428
- # Test with simple prompt
429
- aia --model gpt-3.5-turbo --debug simple_test
430
- ```
431
-
432
- ### Unexpected Results
433
- ```bash
434
- # Use debug mode
435
- aia --debug --verbose your_prompt
436
-
437
- # Try different model
438
- aia --model claude-3-sonnet your_prompt
439
-
440
- # Simplify the prompt
441
- echo "Simple test question" | aia --chat
442
- ```
443
-
444
- ## Congratulations!
445
-
446
- You've created and run your first AIA prompt! You now understand:
447
- - ✅ How to create basic prompt files
448
- - ✅ How to run prompts with context
449
- - ✅ How to use simple directives
450
- - ✅ How to work with different models
451
- - ✅ How to start chat sessions
452
- - ✅ How to create basic workflows
453
-
454
- Keep experimenting and building more sophisticated prompts as you become comfortable with these fundamentals!