@iservu-inc/adf-cli 0.12.12 → 0.14.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 (72) hide show
  1. package/.claude/settings.local.json +6 -1
  2. package/.context/memory/architecture.md +40 -0
  3. package/.context/memory/glossary.md +19 -0
  4. package/.project/docs/VERSIONING-GUIDE.md +127 -0
  5. package/AGENTS.md +53 -0
  6. package/CHANGELOG.md +149 -0
  7. package/bin/adf.js +10 -0
  8. package/conductor/archive/context_synthesis_20260112/metadata.json +8 -0
  9. package/conductor/archive/context_synthesis_20260112/plan.md +40 -0
  10. package/conductor/archive/context_synthesis_20260112/spec.md +43 -0
  11. package/conductor/archive/verify_opencode_20260111/metadata.json +8 -0
  12. package/conductor/archive/verify_opencode_20260111/plan.md +34 -0
  13. package/conductor/archive/verify_opencode_20260111/spec.md +25 -0
  14. package/conductor/code_styleguides/javascript.md +51 -0
  15. package/conductor/product-guidelines.md +26 -0
  16. package/conductor/product.md +25 -0
  17. package/conductor/setup_state.json +1 -0
  18. package/conductor/tech-stack.md +28 -0
  19. package/conductor/tracks/bootstrap_agents_20260111/metadata.json +8 -0
  20. package/conductor/tracks/bootstrap_agents_20260111/plan.md +17 -0
  21. package/conductor/tracks/bootstrap_agents_20260111/spec.md +27 -0
  22. package/conductor/tracks.md +9 -0
  23. package/conductor/workflow.md +333 -0
  24. package/lib/analysis/ai-gap-analyzer.js +66 -0
  25. package/lib/analysis/dynamic-question-generator.js +55 -0
  26. package/lib/analysis/heuristic-gap-analyzer.js +45 -0
  27. package/lib/analysis/synthesis-engine.js +142 -0
  28. package/lib/commands/deploy.js +28 -2
  29. package/lib/commands/guide.js +173 -150
  30. package/lib/commands/tools.js +38 -0
  31. package/lib/generators/codex-cli-generator.js +41 -0
  32. package/lib/generators/index.js +33 -0
  33. package/lib/generators/kiro-generator.js +49 -0
  34. package/lib/generators/opencode-generator.js +332 -153
  35. package/lib/generators/trae-generator.js +34 -0
  36. package/lib/templates/scripts/analyze-framework-updates.js +361 -0
  37. package/lib/templates/scripts/build.js +608 -0
  38. package/lib/templates/scripts/check-framework-updates.js +118 -0
  39. package/lib/templates/scripts/config-helpers.js +1 -1
  40. package/lib/templates/scripts/deploy.js +13 -28
  41. package/lib/templates/scripts/init.js +110 -220
  42. package/lib/templates/scripts/postinstall.js +13 -0
  43. package/lib/templates/scripts/update-frameworks.js +28 -0
  44. package/lib/templates/scripts/validate-env.js +428 -0
  45. package/lib/templates/scripts/validate-mcp.js +471 -0
  46. package/lib/templates/scripts/validate.js +482 -0
  47. package/lib/templates/shared/agents/analyst.md +1 -1
  48. package/lib/templates/shared/agents/architect.md +13 -17
  49. package/lib/templates/shared/agents/dev.md +2 -2
  50. package/lib/templates/shared/agents/pm.md +1 -1
  51. package/lib/templates/shared/agents/qa.md +1 -1
  52. package/lib/templates/shared/agents/sm.md +2 -2
  53. package/lib/templates/shared/templates/README.md +2 -2
  54. package/lib/templates/shared/templates/openspec-proposal.md +2 -2
  55. package/lib/templates/shared/templates/prd-template.md +1 -1
  56. package/lib/templates/shared/templates/story-template.md +1 -1
  57. package/lib/utils/context-extractor.js +157 -0
  58. package/lib/utils/framework-detector.js +54 -0
  59. package/lib/utils/tool-feature-registry.js +102 -0
  60. package/package.json +1 -1
  61. package/tests/ai-gap-analyzer.test.js +38 -0
  62. package/tests/codex-cli-generator.test.js +29 -0
  63. package/tests/context-extractor.test.js +70 -0
  64. package/tests/deploy-integration.test.js +36 -0
  65. package/tests/deploy.test.js +57 -0
  66. package/tests/dynamic-question-generator.test.js +29 -0
  67. package/tests/framework-detector.test.js +55 -0
  68. package/tests/heuristic-gap-analyzer.test.js +46 -0
  69. package/tests/kiro-trae-generators.test.js +43 -0
  70. package/tests/opencode-generator.test.js +113 -0
  71. package/tests/synthesis-engine.test.js +52 -0
  72. package/tests/tool-feature-registry.test.js +23 -0
@@ -7,57 +7,68 @@ const TOOL_GUIDES = {
7
7
  name: 'Codeium Windsurf',
8
8
  files: [
9
9
  { path: '.windsurfrules', desc: 'Legacy rules file (deprecated)' },
10
- { path: '.windsurf/rules/*.md', desc: 'Modular rules (one per agent)' },
10
+ { path: '.windsurf/rules/*.md', desc: 'Modular rules (max 12000 chars per file)' },
11
11
  { path: '.windsurf/workflows/*.md', desc: 'Workflow definitions' },
12
12
  { path: 'AGENTS.md', desc: 'Universal agent manifest (ANDF standard)' }
13
13
  ],
14
14
  setup: [
15
- '1. Open your project in Windsurf IDE',
16
- '2. Windsurf automatically detects .windsurfrules and .windsurf/ directory',
17
- '3. Agent rules are loaded when you start a coding session',
18
- '4. Use Cmd/Ctrl+L to open AI chat with agent context'
15
+ '1. Download and install Windsurf from: https://codeium.com/windsurf',
16
+ '2. Open your project in Windsurf IDE',
17
+ '3. Create .windsurf/rules/ directory for modular rules',
18
+ '4. Each .md file in rules/ directory auto-loaded (max 12000 chars)',
19
+ '5. Rules active immediately in Cascade AI'
19
20
  ],
20
21
  usage: [
21
- '• Start coding - agents automatically follow project rules',
22
- '• Use @agents.md to reference the agent manifest',
23
- '• Access workflows via Cmd/Ctrl+K Select Workflow',
24
- '• Agents adapt based on your workflow level (rapid/balanced/comprehensive)'
22
+ '• Cmd/Ctrl+L - Open Cascade AI chat',
23
+ '• Rules from .windsurf/rules/*.md applied automatically',
24
+ '• Character limit: 12000 chars per rule file',
25
+ '• Split large agents across multiple .md files if needed',
26
+ '• Use @agents.md to reference manifest explicitly',
27
+ '• Workflows in .windsurf/workflows/ directory',
28
+ '• Docs: https://docs.windsurf.com/windsurf/cascade/memories'
25
29
  ],
26
30
  mcpServers: [],
27
31
  troubleshooting: [
28
- '• Rules not loading? Check .windsurf/rules/ contains .md files',
29
- '• Restart Windsurf if rules don\'t update',
30
- '• Check Output Windsurf for any parsing errors'
32
+ '• Rules not loading? Check each .md file is ≤12000 characters',
33
+ '• Verify .windsurf/rules/ directory exists',
34
+ '• Restart Windsurf IDE after adding new rules',
35
+ '• Check View → Output → Windsurf for parsing errors'
31
36
  ]
32
37
  },
33
38
 
34
39
  'cursor': {
35
40
  name: 'Cursor AI IDE',
36
41
  files: [
37
- { path: '.cursor/rules', desc: 'Cursor rules file (symlink to AGENTS.md)' },
38
- { path: '.cursorrules', desc: 'Deprecated - shows migration notice' },
42
+ { path: '.cursor/rules/*.mdc', desc: 'Cursor rules with YAML frontmatter' },
43
+ { path: '.cursorrules', desc: 'Legacy single-file rules (deprecated)' },
39
44
  { path: 'AGENTS.md', desc: 'Universal agent manifest' },
40
45
  { path: '.context/', desc: 'Deep context (architecture, glossary)' }
41
46
  ],
42
47
  setup: [
43
- '1. Open your project in Cursor',
44
- '2. Cursor automatically reads .cursor/rules (which links to AGENTS.md)',
45
- '3. Rules are active in all AI interactions (Cmd/Ctrl+K and Cmd/Ctrl+L)',
46
- '4. No additional setup needed!'
48
+ '1. Download and install Cursor from: https://cursor.sh',
49
+ '2. Open your project in Cursor',
50
+ '3. Create .cursor/rules/ directory',
51
+ '4. Add .mdc files with YAML frontmatter (see usage)',
52
+ '5. Rules auto-apply to Agent (Cmd/Ctrl+L) and Cmd+K'
47
53
  ],
48
54
  usage: [
49
- '• Cmd/Ctrl+K - Inline code generation with agent context',
50
- '• Cmd/Ctrl+L - Chat with AI using project rules',
51
- '• Use @AGENTS.md to explicitly reference agent instructions',
52
- '• Use @.context/memory/ for architecture details',
55
+ '• Cmd/Ctrl+K - Inline editing with rules applied',
56
+ '• Cmd/Ctrl+L - Chat (Agent) with rules applied',
57
+ '• Rules format (.mdc file):',
58
+ ' ---',
59
+ ' title: Developer Agent',
60
+ ' description: Development guidelines',
61
+ ' ---',
62
+ ' [Your agent instructions here]',
63
+ '• Use @AGENTS.md to reference manifest',
53
64
  '• Tab to accept AI suggestions'
54
65
  ],
55
66
  mcpServers: [],
56
67
  troubleshooting: [
57
- '• Rules not active? Check .cursor/rules exists',
58
- '• Verify symlink: should point to ../AGENTS.md',
59
- '• Restart Cursor if rules don\'t apply',
60
- '• Check Settings → Features → Rules enabled'
68
+ '• Rules not active? Check .cursor/rules/ directory exists',
69
+ '• Verify .mdc files have valid YAML frontmatter',
70
+ '• Restart Cursor after adding new rules',
71
+ '• Check Cursor Settings → Features → Rules enabled'
61
72
  ]
62
73
  },
63
74
 
@@ -65,103 +76,106 @@ const TOOL_GUIDES = {
65
76
  name: 'Visual Studio Code (GitHub Copilot)',
66
77
  files: [
67
78
  { path: '.github/copilot-instructions.md', desc: 'GitHub Copilot custom instructions' },
68
- { path: '.vscode/settings.json', desc: 'Custom chat participants and commands' },
79
+ { path: '.vscode/settings.json', desc: 'Workspace settings' },
69
80
  { path: 'AGENTS.md', desc: 'Universal agent manifest' },
70
81
  { path: '.context/', desc: 'Deep context directory' }
71
82
  ],
72
83
  setup: [
73
- '1. Install GitHub Copilot extension in VS Code',
74
- '2. Open your project - settings load automatically',
75
- '3. Custom instructions are read by Copilot automatically',
76
- '4. Restart VS Code to load custom chat modes'
84
+ '1. Download VS Code from: https://code.visualstudio.com',
85
+ '2. Install GitHub Copilot extension from marketplace',
86
+ '3. Create .github/copilot-instructions.md in project root',
87
+ '4. Copilot automatically reads instructions on chat start',
88
+ '5. No restart needed - instructions load per conversation'
77
89
  ],
78
90
  usage: [
79
- '• Use @workspace to include project context in Copilot chat',
91
+ '• Cmd/Ctrl+I - Inline Copilot chat',
92
+ '• Cmd/Ctrl+Shift+I - Copilot panel (sidebar)',
80
93
  '• Copilot reads .github/copilot-instructions.md automatically',
81
- '• Custom chat participants defined in settings.json:',
82
- ' - @architect - Architecture discussions',
83
- ' - @reviewer - Code review',
84
- ' - @planner - Planning and estimation',
85
- '• Inline suggestions follow your project\'s patterns'
94
+ '• Use @workspace to include entire workspace context',
95
+ ' Reference specific files: @filename.js',
96
+ ' Instructions format: Plain markdown in copilot-instructions.md',
97
+ ' Documentation: https://docs.github.com/copilot'
86
98
  ],
87
99
  mcpServers: [],
88
100
  troubleshooting: [
89
- '• Instructions not working? Check GitHub Copilot is active',
90
- '• Verify .github/copilot-instructions.md exists',
91
- '• Settings not loading? Reload VS Code window',
92
- '• Check Copilot status in bottom-right status bar'
101
+ '• Instructions not loading? Verify .github/ directory exists',
102
+ '• Check Copilot status icon in bottom-right corner',
103
+ '• Restart Copilot: Cmd/Ctrl+Shift+P "Copilot: Restart"',
104
+ '• Verify GitHub Copilot subscription is active'
93
105
  ]
94
106
  },
95
107
 
96
108
  'zed': {
97
109
  name: 'Zed Editor',
98
110
  files: [
99
- { path: '.zed/settings.json', desc: 'Zed-specific settings with MCP config' },
100
- { path: '.zed/keymap.json', desc: 'Agent switching shortcuts' },
101
- { path: '.zed/rules', desc: 'Symlink to AGENTS.md' },
111
+ { path: '.zed/settings.json', desc: 'Project-specific settings' },
102
112
  { path: 'AGENTS.md', desc: 'Universal agent manifest' },
103
- { path: '.context/', desc: 'Deep context accessible via MCP' }
113
+ { path: '.context/', desc: 'Deep context directory' }
104
114
  ],
105
115
  setup: [
106
- '1. Open your project in Zed',
107
- '2. Zed reads .zed/settings.json automatically',
108
- '3. MCP servers start automatically (project_context, archon)',
109
- '4. Use keyboard shortcuts to switch agents (Ctrl+Shift+A)'
116
+ '1. Download and install Zed from: https://zed.dev',
117
+ '2. Open your project in Zed',
118
+ '3. Create .zed/settings.json in project root (optional)',
119
+ '4. Global settings at: ~/.config/zed/settings.json',
120
+ '5. MCP servers configured in settings.json'
110
121
  ],
111
122
  usage: [
112
- '• Ctrl+Shift+A - Switch active agent',
113
- '• Ctrl+Enter - Quick agent action',
114
- '• Ctrl+Shift+L - List available tools/workflows',
115
- '• Agents access .context/ via MCP filesystem server',
116
- ' Use /assistant to interact with current agent'
123
+ '• /assistant - Open AI assistant panel',
124
+ '• Cmd/Ctrl+Enter - Submit to assistant',
125
+ '• Configure MCP servers in settings.json:',
126
+ ' {',
127
+ ' "context_servers": {',
128
+ ' "project": {',
129
+ ' "command": "npx",',
130
+ ' "args": ["@modelcontextprotocol/server-filesystem", ".context"]',
131
+ ' }',
132
+ ' }',
133
+ ' }',
134
+ '• Reference AGENTS.md manually in conversation'
117
135
  ],
118
136
  mcpServers: [
119
137
  {
120
- name: 'project_context',
121
- command: 'npx @modelcontextprotocol/server-filesystem .context',
122
- desc: 'Provides read-only access to .context/ directory'
123
- },
124
- {
125
- name: 'archon',
126
- url: 'http://archon.ad.iservu.cc:8051/mcp',
127
- desc: 'Internal API documentation and RAG (if available)'
138
+ name: 'filesystem',
139
+ command: 'npx @modelcontextprotocol/server-filesystem',
140
+ desc: 'Provides file access via MCP protocol'
128
141
  }
129
142
  ],
130
143
  troubleshooting: [
131
- '• Rules not loading? Check .zed/rules symlink exists',
132
- '• MCP servers not starting? Check Node.js is installed',
133
- '• Verify MCP config in .zed/settings.json',
134
- '• Check Zed logs: View → Debug → Show Logs'
144
+ '• MCP servers not starting? Check Node.js installed',
145
+ '• Verify settings.json syntax is valid JSON',
146
+ '• Check Zed logs: View → Debug → Developer Tools',
147
+ '• Documentation: https://zed.dev/docs'
135
148
  ]
136
149
  },
137
150
 
138
151
  'antigravity': {
139
152
  name: 'Google Antigravity',
140
153
  files: [
141
- { path: '.antigravity/agents.yaml', desc: 'Antigravity agent configuration' },
142
- { path: 'AGENTS.md', desc: 'Universal agent manifest (mounted in container)' },
154
+ { path: 'AGENTS.md', desc: 'Universal agent manifest' },
143
155
  { path: '.context/', desc: 'Deep context (architecture, glossary)' }
144
156
  ],
145
157
  setup: [
146
- '1. Open your project in Antigravity',
147
- '2. Antigravity reads .antigravity/agents.yaml',
148
- '3. AGENTS.md is mounted read-only in agent filesystem',
149
- '4. Agent automatically reads AGENTS.md on startup',
150
- '5. No additional setup needed!'
158
+ '1. Access Antigravity (Google internal tool)',
159
+ '2. Open your project or codebase',
160
+ '3. Click ... menu Customizations',
161
+ '4. Add Rules and Workflows via customization UI',
162
+ '5. Rules and workflows saved automatically'
151
163
  ],
152
164
  usage: [
153
- '• Agent has access to AGENTS.md via file system mount',
154
- '• .context/ directory accessible for architecture details',
155
- '• Use conversational commands: "follow the dev agent workflow"',
156
- '• Agent references AGENTS.md automatically for instructions',
157
- '• Switch agent modes by referencing different roles in AGENTS.md'
165
+ '• Access customizations: Click ... Customizations',
166
+ '• Rules: Add custom instructions for AI behavior',
167
+ '• Workflows: Define multi-step processes',
168
+ '• Reference project files in conversation',
169
+ '• Use "Read AGENTS.md" to access agent manifest',
170
+ '• Conversational commands: "Follow dev workflow"',
171
+ '• .context/ directory accessible for detailed docs'
158
172
  ],
159
173
  mcpServers: [],
160
174
  troubleshooting: [
161
- '• Agent not following rules? Check .antigravity/agents.yaml exists',
162
- '• Verify AGENTS.md file path in filesystem mount',
163
- '• Check agent logs for AGENTS.md read confirmation',
164
- '• Restart Antigravity session if config doesn\'t load'
175
+ '• Customizations not applying? Check ... → Customizations menu',
176
+ '• Restart Antigravity session if changes not reflected',
177
+ '• Verify rules syntax is correct in customization UI',
178
+ '• Contact Google internal support for Antigravity issues'
165
179
  ]
166
180
  },
167
181
 
@@ -169,77 +183,84 @@ const TOOL_GUIDES = {
169
183
  name: 'Claude Code CLI',
170
184
  files: [
171
185
  { path: '.framework/agents/*.md', desc: 'Agent definition files (analyst, pm, dev, qa, etc.)' },
186
+ { path: '.claude/commands/', desc: 'Custom commands directory' },
172
187
  { path: 'AGENTS.md', desc: 'Universal agent manifest' },
173
188
  { path: '.context/', desc: 'Deep context directory' }
174
189
  ],
175
190
  setup: [
176
- '1. Navigate to your project directory',
177
- '2. Run: claude-code --agents .framework/agents/',
178
- '3. Or configure in .claude/settings.json:',
179
- ' {',
180
- ' "agentsPath": ".framework/agents/"',
181
- ' }',
182
- '4. Claude Code loads agents automatically'
191
+ '1. Install Claude Code: curl -fsSL https://claude.ai/install.sh | bash',
192
+ '2. Authenticate: Follow prompts after installation',
193
+ '3. Navigate to your project directory',
194
+ '4. Custom commands in .claude/commands/ (optional)',
195
+ '5. Reference agent files manually in conversation'
183
196
  ],
184
197
  usage: [
185
198
  '• Start chat: claude-code',
186
- '• Agents are available as slash commands:',
187
- ' /dev - Switch to developer agent',
188
- ' /pm - Switch to product manager agent',
189
- ' /qa - Switch to QA engineer agent',
190
- '• Reference AGENTS.md in chat: "read AGENTS.md"',
191
- '• Access requirements: "show me .adf/sessions/*/outputs/"'
199
+ '• Interactive terminal-based chat with Claude',
200
+ ' Reference project files: "read .framework/agents/dev.md"',
201
+ ' Access AGENTS.md: "follow instructions in AGENTS.md"',
202
+ ' Custom commands: Place scripts in .claude/commands/',
203
+ '• Requirements: "show .adf/sessions/*/outputs/"',
204
+ '• Documentation: https://claude.ai/code'
192
205
  ],
193
206
  mcpServers: [
194
207
  {
195
208
  name: 'filesystem',
196
- desc: 'Can be configured to access project files',
197
- command: 'Add to .claude/settings.json MCP servers config'
209
+ desc: 'Can be configured via .claude/settings.json',
210
+ command: 'Configure MCP servers in settings file'
198
211
  }
199
212
  ],
200
213
  troubleshooting: [
201
- '• Agents not loading? Check .framework/agents/ contains .md files',
202
- '• Verify agentsPath in .claude/settings.json',
203
- '• Run: claude-code doctor to check configuration',
204
- '• Check for agent file read permissions'
214
+ '• Installation issues? Check: https://claude.ai/code',
215
+ '• Command not found? Restart terminal after install',
216
+ '• Authentication failed? Run installation script again',
217
+ '• Custom commands not working? Check .claude/commands/ permissions'
205
218
  ]
206
219
  },
207
220
 
208
221
  'opencode': {
209
222
  name: 'OpenCode CLI',
210
223
  files: [
211
- { path: '.opencode.json', desc: 'OpenCode project configuration' },
212
- { path: 'AGENTS.md', desc: 'Universal agent manifest' },
224
+ { path: '.opencode.json', desc: 'OpenCode multi-agent configuration' },
225
+ { path: 'AGENTS.md', desc: 'Universal agent manifest (auto-referenced)' },
213
226
  { path: '.context/', desc: 'Deep context directory' }
214
227
  ],
215
228
  setup: [
216
- '1. Navigate to your project directory',
217
- '2. Run: opencode init (if not already initialized)',
218
- '3. OpenCode reads .opencode.json automatically',
219
- '4. MCP filesystem server starts automatically',
220
- '5. Agents configured based on workflow level'
229
+ '1. Install: npm install -g opencode-ai@latest',
230
+ '2. Or quick install: curl -fsSL https://opencode.ai/install | bash',
231
+ '3. Authenticate: opencode (interactive provider setup)',
232
+ '4. Navigate to your project directory',
233
+ '5. OpenCode reads .opencode.json automatically'
221
234
  ],
222
235
  usage: [
223
- '• Start coding session: opencode',
224
- '• Agents automatically have project context',
225
- '• MCP provides access to all project files',
226
- '• Use natural language for tasks:',
227
- ' "Implement the login feature"',
228
- ' "Review the authentication code"',
229
- ' "Run tests and fix failures"'
236
+ '• Start session: opencode',
237
+ '• Terminal-based AI coding agent (TUI)',
238
+ '• Supports multiple AI providers (Anthropic, OpenAI, Google, OpenRouter)',
239
+ '• Multi-agent system with specialized agents:',
240
+ ' - dev (primary): Senior software engineer',
241
+ ' - analyst: Business analyst for requirements',
242
+ ' - pm: Product manager for planning',
243
+ ' - architect: Solutions architect for design',
244
+ ' - qa: QA engineer for testing',
245
+ ' - sm: Scrum master for agile workflow',
246
+ '• Configuration schema: https://opencode.ai/config.json',
247
+ '• Auto-loads AGENTS.md and session outputs',
248
+ '• Documentation: https://opencode.ai/docs'
230
249
  ],
231
250
  mcpServers: [
232
251
  {
233
- name: 'filesystem',
234
- command: 'npx -y @modelcontextprotocol/server-filesystem',
235
- desc: 'Provides full project file access'
252
+ name: 'project_filesystem',
253
+ desc: 'Provides project file access via MCP protocol',
254
+ command: 'npx -y @modelcontextprotocol/server-filesystem'
236
255
  }
237
256
  ],
238
257
  troubleshooting: [
239
- '• Config not loading? Check .opencode.json syntax',
240
- '• MCP errors? Ensure npx is available',
241
- '• Verify Node.js version >= 18.0.0',
242
- '• Run: opencode --version to check installation'
258
+ '• Command not found? Restart terminal after install',
259
+ '• Config errors? Validate against: https://opencode.ai/config.json',
260
+ '• Provider auth issues? Run: opencode (interactive setup)',
261
+ '• Check version: opencode --version',
262
+ '• Documentation: https://opencode.ai/docs',
263
+ '• GitHub: https://github.com/anomalyco/opencode/issues'
243
264
  ]
244
265
  },
245
266
 
@@ -251,26 +272,26 @@ const TOOL_GUIDES = {
251
272
  { path: '.context/', desc: 'Deep context directory' }
252
273
  ],
253
274
  setup: [
254
- '1. Install Gemini CLI: npm install -g @google/generative-ai-cli',
255
- '2. Configure API key: export GOOGLE_API_KEY=your_key',
256
- '3. Navigate to your project directory',
257
- '4. Gemini CLI automatically detects GEMINI.md'
275
+ '1. Install Gemini CLI: npm install -g @google/gemini-cli',
276
+ '2. Configure API key: gemini auth (interactive setup)',
277
+ '3. Or set manually: export GOOGLE_API_KEY=your_key',
278
+ '4. Navigate to your project directory',
279
+ '5. Start CLI: gemini (not gemini-cli)'
258
280
  ],
259
281
  usage: [
260
- '• Start session: gemini-cli',
261
- '• Gemini reads GEMINI.md automatically for context',
262
- '• Reference project docs:',
263
- ' "Read the requirements in .adf/sessions/"',
264
- ' "Follow the workflow defined in GEMINI.md"',
265
- '• Use for code generation, review, and planning',
266
- '• Agent adapts based on your workflow level'
282
+ '• Start session: gemini',
283
+ '• Interactive chat interface with Google Gemini models',
284
+ '• Reference project files: gemini --file path/to/file',
285
+ ' Use GEMINI.md for project context (reference manually)',
286
+ ' Access requirements: "Read .adf/sessions/*/outputs/"',
287
+ '• Documentation: https://geminicli.com'
267
288
  ],
268
289
  mcpServers: [],
269
290
  troubleshooting: [
270
- '• GEMINI.md not detected? Check file exists in project root',
271
- '• API key issues? Verify GOOGLE_API_KEY is set',
272
- '• Check Gemini CLI version: gemini-cli --version',
273
- '• Review GEMINI.md for correct formatting'
291
+ '• Command not found? Verify npm global install path in PATH',
292
+ '• API key issues? Run: gemini auth',
293
+ '• Check installation: gemini --version',
294
+ '• Documentation: https://geminicli.com/docs'
274
295
  ]
275
296
  },
276
297
 
@@ -282,24 +303,26 @@ const TOOL_GUIDES = {
282
303
  { path: 'AGENTS.md', desc: 'Universal agent manifest' }
283
304
  ],
284
305
  setup: [
285
- '1. Install DeepAgent: pip install deepagent',
286
- '2. Navigate to your project directory',
287
- '3. Run: deepagent init (loads .deepagent/ config)',
288
- '4. Agents are loaded automatically'
306
+ '1. Install Abacus.ai CLI: npm install -g @abacus-ai/cli',
307
+ '2. Authenticate: abacusai login',
308
+ '3. Navigate to your project directory',
309
+ '4. DeepAgent configurations in .deepagent/ directory',
310
+ '5. Use command: abacusai (not deepagent)'
289
311
  ],
290
312
  usage: [
291
- '• Start session: deepagent',
292
- '• Switch agents: deepagent --agent dev',
293
- '• Agents read their .md files for instructions',
294
- '• Use natural language for development tasks',
295
- '• DeepAgent follows workflow level automatically'
313
+ '• Start session: abacusai',
314
+ '• Terminal/CLI interface for Abacus.ai platform',
315
+ '• Access DeepAgent features via CLI commands',
316
+ '• Agent markdown files can be referenced manually',
317
+ '• Check available commands: abacusai --help',
318
+ '• Documentation: https://abacus.ai/docs'
296
319
  ],
297
320
  mcpServers: [],
298
321
  troubleshooting: [
299
- '• Agents not loading? Check .deepagent/agents/ directory',
300
- '• Verify agent .md files are present',
301
- '• Check DeepAgent version: deepagent --version',
302
- '• Review .deepagent/README.md for setup info'
322
+ '• Command not found? Verify npm global install: npm list -g @abacus-ai/cli',
323
+ '• Authentication issues? Run: abacusai login',
324
+ '• Check CLI version: abacusai --version',
325
+ '• Documentation: https://abacus.ai/docs'
303
326
  ]
304
327
  }
305
328
  };
@@ -0,0 +1,38 @@
1
+ const chalk = require('chalk');
2
+ const ToolFeatureRegistry = require('../utils/tool-feature-registry');
3
+
4
+ /**
5
+ * Tools Audit Command
6
+ * Displays a report of supported tools and their features.
7
+ */
8
+ async function audit() {
9
+ const report = ToolFeatureRegistry.audit();
10
+
11
+ console.log(chalk.cyan.bold('\n🛠️ ADF Tool Support Audit\n'));
12
+ console.log(chalk.gray(`Total Tools: ${report.totalCount}`));
13
+ console.log(chalk.gray(`Timestamp: ${new Date(report.timestamp).toLocaleString()}\n`));
14
+
15
+ console.log(chalk.white.bold('ID'.padEnd(15)) + chalk.white.bold('Name'.padEnd(20)) + chalk.white.bold('Status'));
16
+ console.log(chalk.gray('─'.repeat(50)));
17
+
18
+ for (const [id, tool] of Object.entries(report.tools)) {
19
+ let statusColor = chalk.green;
20
+ if (tool.status === 'partial') statusColor = chalk.yellow;
21
+ if (tool.status === 'deprecated') statusColor = chalk.red;
22
+
23
+ console.log(
24
+ chalk.cyan(id.padEnd(15)) +
25
+ chalk.white(tool.name.padEnd(20)) +
26
+ statusColor(tool.status)
27
+ );
28
+
29
+ if (tool.features && tool.features.length > 0) {
30
+ console.log(chalk.gray(` Features: ${tool.features.join(', ')}`));
31
+ }
32
+ console.log('');
33
+ }
34
+
35
+ console.log(chalk.yellow('💡 Use "adf deploy <tool>" to configure any of these targets.\n'));
36
+ }
37
+
38
+ module.exports = audit;
@@ -0,0 +1,41 @@
1
+ const ToolConfigGenerator = require('./tool-config-generator');
2
+ const path = require('path');
3
+ const fs = require('fs-extra');
4
+
5
+ /**
6
+ * Generator for Codex CLI
7
+ */
8
+ class CodexCLIGenerator extends ToolConfigGenerator {
9
+ async generate() {
10
+ await this.initialize();
11
+ await this.ensureDir('.codex');
12
+
13
+ const projectContext = await this.getProjectContext();
14
+
15
+ const config = `# Codex CLI Configuration
16
+ # AgentDevFramework
17
+
18
+ [framework]
19
+ name = "AgentDevFramework"
20
+ version = "1.0.0"
21
+ project = "${projectContext.name}"
22
+
23
+ [project_structure]
24
+ framework = ".adf/"
25
+ docs = "docs/"
26
+ specs = "specs/"
27
+ `;
28
+
29
+ await this.writeToProject('.codex/config.toml', config);
30
+
31
+ const instructions = `# Codex Instructions - ${projectContext.name}
32
+ Follow AgentDevFramework standards for all development.
33
+ Always prioritize TDD and high code coverage.
34
+ `;
35
+ await this.writeToProject('.codex/instructions.md', instructions);
36
+
37
+ return { config: '.codex/config.toml' };
38
+ }
39
+ }
40
+
41
+ module.exports = CodexCLIGenerator;
@@ -12,6 +12,9 @@ const AntigravityGenerator = require('./antigravity-generator');
12
12
  const OpenCodeGenerator = require('./opencode-generator');
13
13
  const GeminiCLIGenerator = require('./gemini-cli-generator');
14
14
  const DeepAgentGenerator = require('./deepagent-generator');
15
+ const KiroGenerator = require('./kiro-generator');
16
+ const TraeGenerator = require('./trae-generator');
17
+ const CodexCLIGenerator = require('./codex-cli-generator');
15
18
  const ToolConfigGenerator = require('./tool-config-generator');
16
19
 
17
20
  /**
@@ -129,6 +132,30 @@ async function generateDeepAgent(sessionPath, projectPath, framework) {
129
132
  return await generator.generate();
130
133
  }
131
134
 
135
+ /**
136
+ * Generate Kiro configurations
137
+ */
138
+ async function generateKiro(sessionPath, projectPath, framework) {
139
+ const generator = new KiroGenerator(sessionPath, projectPath, framework);
140
+ return await generator.generate();
141
+ }
142
+
143
+ /**
144
+ * Generate Trae configurations
145
+ */
146
+ async function generateTrae(sessionPath, projectPath, framework) {
147
+ const generator = new TraeGenerator(sessionPath, projectPath, framework);
148
+ return await generator.generate();
149
+ }
150
+
151
+ /**
152
+ * Generate Codex CLI configurations
153
+ */
154
+ async function generateCodexCLI(sessionPath, projectPath, framework) {
155
+ const generator = new CodexCLIGenerator(sessionPath, projectPath, framework);
156
+ return await generator.generate();
157
+ }
158
+
132
159
  module.exports = {
133
160
  generateAll,
134
161
  generateAgentsMd,
@@ -140,6 +167,9 @@ module.exports = {
140
167
  generateOpenCode,
141
168
  generateGeminiCLI,
142
169
  generateDeepAgent,
170
+ generateKiro,
171
+ generateTrae,
172
+ generateCodexCLI,
143
173
  AgentsMdGenerator,
144
174
  WindsurfGenerator,
145
175
  CursorGenerator,
@@ -149,5 +179,8 @@ module.exports = {
149
179
  OpenCodeGenerator,
150
180
  GeminiCLIGenerator,
151
181
  DeepAgentGenerator,
182
+ KiroGenerator,
183
+ TraeGenerator,
184
+ CodexCLIGenerator,
152
185
  ToolConfigGenerator
153
186
  };