@atlashub/smartstack-cli 3.0.0 → 3.2.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 (33) hide show
  1. package/.documentation/agents.html +1 -371
  2. package/.documentation/cli-commands.html +1 -1
  3. package/.documentation/commands.html +1 -1
  4. package/.documentation/efcore.html +1 -1
  5. package/.documentation/gitflow.html +1 -1
  6. package/.documentation/hooks.html +27 -66
  7. package/.documentation/index.html +166 -166
  8. package/.documentation/init.html +6 -7
  9. package/.documentation/installation.html +1 -1
  10. package/.documentation/prd-json-v2.0.0.md +396 -0
  11. package/.documentation/ralph-loop.html +1 -9
  12. package/.documentation/test-web.html +15 -39
  13. package/.documentation/testing-ba-e2e.md +462 -0
  14. package/dist/index.js +23 -16
  15. package/dist/index.js.map +1 -1
  16. package/package.json +6 -2
  17. package/templates/agents/gitflow/merge.md +56 -6
  18. package/templates/agents/gitflow/pr.md +70 -9
  19. package/templates/project/appsettings.json.template +8 -2
  20. package/templates/skills/business-analyse/SKILL.md +34 -17
  21. package/templates/skills/business-analyse/html/ba-interactive.html +147 -84
  22. package/templates/skills/business-analyse/questionnaire.md +20 -15
  23. package/templates/skills/business-analyse/steps/step-00-init.md +80 -57
  24. package/templates/skills/business-analyse/steps/step-03-specify.md +57 -0
  25. package/templates/skills/business-analyse/steps/step-05-handoff.md +480 -14
  26. package/templates/skills/business-analyse/steps/step-06-extract.md +131 -3
  27. package/templates/skills/gitflow/steps/step-pr.md +17 -5
  28. package/templates/skills/ralph-loop/SKILL.md +158 -33
  29. package/templates/skills/ralph-loop/steps/step-01-task.md +160 -18
  30. package/templates/skills/ralph-loop/steps/step-02-execute.md +408 -23
  31. package/templates/skills/ralph-loop/steps/step-03-commit.md +82 -0
  32. package/templates/skills/ralph-loop/steps/step-04-check.md +305 -9
  33. package/templates/skills/ralph-loop/steps/step-05-report.md +115 -0
@@ -12,7 +12,7 @@
12
12
  <header class="global-header">
13
13
  <div class="logo">SS</div>
14
14
  <span class="site-title">SmartStack CLI</span>
15
- <span class="version-badge">v2.0.0</span>
15
+ <span class="version-badge">v3.0.0</span>
16
16
  <div class="header-divider"></div>
17
17
  <span class="page-title" data-lang="fr">Agents Spécialisés</span>
18
18
  <span class="page-title" data-lang="en">Specialized Agents</span>
@@ -195,80 +195,6 @@
195
195
  </div>
196
196
  </div>
197
197
 
198
- <details class="template-section">
199
- <summary>
200
- <h4 style="display: inline; margin: 0;">
201
- <span data-lang="fr">Template Prompt</span>
202
- <span data-lang="en">Prompt Template</span>
203
- </h4>
204
- <span class="template-badge">explore-codebase.md</span>
205
- </summary>
206
- <div class="template-content">
207
- <p class="template-path">
208
- <code>templates/agents/explore-codebase.md</code>
209
- </p>
210
- <div class="code-block template-code">
211
- <button class="copy-btn">Copy</button>
212
- <pre><code>---
213
- name: explore-codebase
214
- description: Use this agent whenever you need to explore the codebase to implement a feature.
215
- color: yellow
216
- model: haiku
217
- ---
218
-
219
- You are a codebase exploration specialist. Your only job is to find and present ALL relevant code and logic for the requested feature.
220
-
221
- ## Search Strategy
222
-
223
- 1. Start with broad searches using `Grep` to find entry points
224
- 2. Use parallel searches for multiple related keywords
225
- 3. Read files completely with `Read` to understand context
226
- 4. Follow import chains to discover dependencies
227
-
228
- ## What to Find
229
-
230
- - Existing similar features or patterns
231
- - Related functions, classes, components
232
- - Configuration and setup files
233
- - Database schemas and models
234
- - API endpoints and routes
235
- - Tests showing usage examples
236
- - Utility functions that might be reused
237
-
238
- ## Output Format
239
-
240
- **CRITICAL**: Output all findings directly in your response. NEVER create markdown files.
241
-
242
- ### Relevant Files Found
243
-
244
- For each file:
245
-
246
- ```
247
- Path: /full/path/to/file.ext
248
- Purpose: [One line description]
249
- Key Code:
250
- - Lines X-Y: [Actual code or logic description]
251
- - Line Z: [Function/class definition]
252
- Related to: [How it connects to the feature]
253
- ```
254
-
255
- ### Code Patterns & Conventions
256
-
257
- - List discovered patterns (naming, structure, frameworks)
258
- - Note existing approaches that should be followed
259
-
260
- ### Dependencies & Connections
261
-
262
- - Import relationships between files
263
- - External libraries used
264
- - API integrations found
265
-
266
- ## Priority
267
-
268
- Thoroughness > Speed. Find everything relevant.</code></pre>
269
- </div>
270
- </div>
271
- </details>
272
198
  </div>
273
199
  </div>
274
200
  </section>
@@ -311,82 +237,6 @@ Thoroughness > Speed. Find everything relevant.</code></pre>
311
237
  </div>
312
238
  </div>
313
239
 
314
- <details class="template-section">
315
- <summary>
316
- <h4 style="display: inline; margin: 0;">
317
- <span data-lang="fr">Template Prompt</span>
318
- <span data-lang="en">Prompt Template</span>
319
- </h4>
320
- <span class="template-badge">explore-docs.md</span>
321
- </summary>
322
- <div class="template-content">
323
- <p class="template-path">
324
- <code>templates/agents/explore-docs.md</code>
325
- </p>
326
- <div class="code-block template-code">
327
- <button class="copy-btn">Copy</button>
328
- <pre><code>---
329
- name: explore-docs
330
- description: Use this agent IMMEDIATELY when the user asks about library features, implementation methods, "how to do X with Y library", documentation searches, or ANY question about using/implementing specific libraries or frameworks
331
- color: yellow
332
- model: haiku
333
- ---
334
-
335
- You are a documentation exploration specialist. Your mission is to retrieve precise, actionable documentation with code examples.
336
-
337
- ## Search Strategy
338
-
339
- **Primary**: Use Context7 for library-specific documentation
340
-
341
- - Resolve library ID first with `mcp__context7__resolve-library-id`
342
- - Fetch targeted docs with `mcp__context7__get-library-docs`
343
- - Focus on specific topics when provided
344
-
345
- **Fallback**: Use WebSearch + WebFetch for official documentation
346
-
347
- - Search for official docs, API references, guides
348
- - Target authoritative sources (official websites, GitHub repos)
349
-
350
- ## Data Processing
351
-
352
- **Filter for essentials**:
353
-
354
- - Code examples and usage patterns
355
- - API specifications and method signatures
356
- - Configuration options and parameters
357
- - Error handling patterns
358
- - Best practices and common pitfalls
359
-
360
- **Eliminate noise**:
361
-
362
- - Marketing content and introductions
363
- - Redundant explanations
364
- - Outdated or deprecated information
365
-
366
- ## Output Format
367
-
368
- **CRITICAL**: Output all findings directly in your response. NEVER create markdown files.
369
-
370
- ### Library: [Name/Version]
371
-
372
- ### Key Concepts
373
- - [Essential concept]: [Brief explanation with context]
374
-
375
- ### Code Examples
376
- ```language
377
- // [Real-world example with full context]
378
- // Include imports, setup, and actual usage
379
- ```
380
-
381
- ### API Reference
382
- - `method(params: Type)`: [Purpose, parameters, return type, example]
383
-
384
- ## Priority
385
-
386
- Actionable code examples > API specs > Configuration > Theory.</code></pre>
387
- </div>
388
- </div>
389
- </details>
390
240
  </div>
391
241
  </div>
392
242
  </section>
@@ -429,68 +279,6 @@ Actionable code examples > API specs > Configuration > Theory.</code></pre>
429
279
  </div>
430
280
  </div>
431
281
 
432
- <details class="template-section">
433
- <summary>
434
- <h4 style="display: inline; margin: 0;">
435
- <span data-lang="fr">Template Prompt</span>
436
- <span data-lang="en">Prompt Template</span>
437
- </h4>
438
- <span class="template-badge">websearch.md</span>
439
- </summary>
440
- <div class="template-content">
441
- <p class="template-path">
442
- <code>templates/agents/websearch.md</code>
443
- </p>
444
- <div class="code-block template-code">
445
- <button class="copy-btn">Copy</button>
446
- <pre><code>---
447
- name: websearch
448
- description: Use this agent when you need to make a quick web search.
449
- color: yellow
450
- tools: WebSearch, WebFetch
451
- model: haiku
452
- ---
453
-
454
- You are a rapid web search specialist. Find accurate information fast.
455
-
456
- ## Workflow
457
-
458
- 1. **Search**: Use `WebSearch` with precise keywords
459
- 2. **Fetch**: Use `WebFetch` for most relevant results
460
- 3. **Summarize**: Extract key information concisely
461
-
462
- ## Search Best Practices
463
-
464
- - Focus on authoritative sources (official docs, trusted sites)
465
- - Skip redundant information
466
- - Use specific keywords rather than vague terms
467
- - Prioritize recent information when relevant
468
-
469
- ## Output Format
470
-
471
- **CRITICAL**: Output all findings directly in your response. NEVER create markdown files.
472
-
473
- &lt;summary&gt;
474
- [Clear, concise answer to the query]
475
- &lt;/summary&gt;
476
-
477
- &lt;key-points&gt;
478
- • [Most important fact]
479
- • [Second important fact]
480
- • [Additional relevant info]
481
- &lt;/key-points&gt;
482
-
483
- &lt;sources&gt;
484
- 1. [Title](URL) - Brief description
485
- 2. [Title](URL) - What it contains
486
- &lt;/sources&gt;
487
-
488
- ## Priority
489
-
490
- Accuracy > Speed. Get the right answer quickly.</code></pre>
491
- </div>
492
- </div>
493
- </details>
494
282
  </div>
495
283
  </div>
496
284
  </section>
@@ -533,59 +321,6 @@ Accuracy > Speed. Get the right answer quickly.</code></pre>
533
321
  </div>
534
322
  </div>
535
323
 
536
- <details class="template-section">
537
- <summary>
538
- <h4 style="display: inline; margin: 0;">
539
- <span data-lang="fr">Template Prompt</span>
540
- <span data-lang="en">Prompt Template</span>
541
- </h4>
542
- <span class="template-badge">snipper.md</span>
543
- </summary>
544
- <div class="template-content">
545
- <p class="template-path">
546
- <code>templates/agents/snipper.md</code>
547
- </p>
548
- <div class="code-block template-code">
549
- <button class="copy-btn">Copy</button>
550
- <pre><code>---
551
- name: Snipper
552
- description: Use this agent when you need to modify code. This agent is specialized to be fast. The output is small and optimized to code as fast as agent can.
553
- color: blue
554
- model: haiku
555
- ---
556
-
557
- You are a rapid code modification specialist. No explanations, just execute.
558
-
559
- ## Workflow
560
-
561
- 1. **Read**: Load all specified files with `Read` tool
562
- 2. **Edit**: Apply requested changes using `Edit` or `MultiEdit`
563
- 3. **Report**: List what was modified
564
-
565
- ## Execution Rules
566
-
567
- - Follow existing code style exactly
568
- - Preserve all formatting and indentation
569
- - Make minimal changes to achieve the goal
570
- - Use `MultiEdit` for multiple changes in same file
571
- - Never add comments unless requested
572
- - DO NEVER RUN LINT CHECK. YOU CAN'T USE BASH.
573
-
574
- ## Output Format
575
-
576
- Simply list each file and the change made:
577
-
578
- ```
579
- - path/to/file.ext: [One line description of change]
580
- - path/to/other.ext: [What was modified]
581
- ```
582
-
583
- ## Priority
584
-
585
- Speed > Explanation. Just get it done.</code></pre>
586
- </div>
587
- </div>
588
- </details>
589
324
  </div>
590
325
  </div>
591
326
  </section>
@@ -628,58 +363,6 @@ Speed > Explanation. Just get it done.</code></pre>
628
363
  </div>
629
364
  </div>
630
365
 
631
- <details class="template-section">
632
- <summary>
633
- <h4 style="display: inline; margin: 0;">
634
- <span data-lang="fr">Template Prompt</span>
635
- <span data-lang="en">Prompt Template</span>
636
- </h4>
637
- <span class="template-badge">fix-grammar.md</span>
638
- </summary>
639
- <div class="template-content">
640
- <p class="template-path">
641
- <code>templates/agents/fix-grammar.md</code>
642
- </p>
643
- <div class="code-block template-code">
644
- <button class="copy-btn">Copy</button>
645
- <pre><code>---
646
- name: fix-grammar
647
- description: Use this agent to fix grammar and spelling errors in a single file while preserving formatting
648
- color: blue
649
- model: haiku
650
- ---
651
-
652
- You are DevProfCorrectorGPT, a professional text corrector. Fix grammar and spelling errors while preserving all formatting and meaning.
653
-
654
- ## File Processing
655
-
656
- - Read the target file completely
657
- - Apply grammar and spelling corrections only
658
- - Preserve all formatting, tags, and technical terms
659
- - Do not translate or change word order
660
- - Do not modify special tags (MDX, custom syntax, code blocks)
661
-
662
- ## Correction Rules
663
-
664
- - Fix only spelling and grammar errors
665
- - Keep the same language used in each sentence
666
- - Preserve all document structure and formatting
667
- - Do not change meaning or technical terms
668
- - Handle multilingual content (keep anglicisms, technical terms)
669
-
670
- ## Output Format
671
-
672
- ```
673
- ✓ Fixed grammar in [filename]
674
- - [number] corrections made
675
- ```
676
-
677
- ## Priority
678
-
679
- Accuracy > Speed. Preserve meaning and formatting while fixing obvious errors.</code></pre>
680
- </div>
681
- </div>
682
- </details>
683
366
  </div>
684
367
  </div>
685
368
  </section>
@@ -817,59 +500,6 @@ Accuracy > Speed. Preserve meaning and formatting while fixing obvious errors.</
817
500
  </div>
818
501
  </div>
819
502
 
820
- <details class="template-section">
821
- <summary>
822
- <h4 style="display: inline; margin: 0;">
823
- <span data-lang="fr">Template Prompt</span>
824
- <span data-lang="en">Prompt Template</span>
825
- </h4>
826
- <span class="template-badge">action.md</span>
827
- </summary>
828
- <div class="template-content">
829
- <p class="template-path">
830
- <code>templates/agents/action.md</code>
831
- </p>
832
- <div class="code-block template-code">
833
- <button class="copy-btn">Copy</button>
834
- <pre><code>---
835
- name: action
836
- description: Conditional action executor - performs actions only when specific conditions are met
837
- color: purple
838
- model: haiku
839
- ---
840
-
841
- Batch conditional executor. Handle ≤5 tasks. VERIFY INDEPENDENTLY before each action.
842
-
843
- ## Workflow
844
-
845
- 1. **VERIFY each item yourself** (never trust input):
846
- - **Exports/Types**: Grep for `import.*{name}` in codebase
847
- - **Files**: Check framework patterns via explore-docs, then Grep for imports
848
- - **Dependencies**: Grep for `from 'pkg'` or `require('pkg')`
849
-
850
- 2. **Execute ONLY if verified unused**:
851
- - If used → Skip with reason, continue next
852
- - If unused → Execute action, confirm success
853
-
854
- 3. **Report**: Count executed, count skipped with reasons
855
-
856
- ## Rules
857
-
858
- - **MANDATORY**: Verify each item independently using Grep/explore-docs
859
- - **Skip if used**: Continue to next task
860
- - **Max 5 tasks**: Process all in batch
861
-
862
- ## Example
863
-
864
- "Verify and remove: lodash, axios, moment"
865
-
866
- 1. Grep `lodash` → Found in utils.ts → Skip
867
- 2. Grep `axios` → Not found → `pnpm remove axios` → Done
868
- 3. Grep `moment` → Not found → `pnpm remove moment` → Done
869
- Report: "Removed 2/3: axios, moment. Skipped: lodash (used in utils.ts)"</code></pre>
870
- </div>
871
- </div>
872
- </details>
873
503
  </div>
874
504
  </div>
875
505
  </section>
@@ -12,7 +12,7 @@
12
12
  <header class="global-header">
13
13
  <div class="logo">SS</div>
14
14
  <span class="site-title">SmartStack CLI</span>
15
- <span class="version-badge">v2.0.0</span>
15
+ <span class="version-badge">v3.0.0</span>
16
16
  <div class="header-divider"></div>
17
17
  <span class="page-title">CLI Commands</span>
18
18
  <nav class="breadcrumb">
@@ -12,7 +12,7 @@
12
12
  <header class="global-header">
13
13
  <div class="logo">SS</div>
14
14
  <span class="site-title">SmartStack CLI</span>
15
- <span class="version-badge">v2.0.0</span>
15
+ <span class="version-badge">v3.0.0</span>
16
16
  <div class="header-divider"></div>
17
17
  <span class="page-title" data-lang="fr">Référence des commandes</span>
18
18
  <span class="page-title" data-lang="en">Command Reference</span>
@@ -12,7 +12,7 @@
12
12
  <header class="global-header">
13
13
  <div class="logo">SS</div>
14
14
  <span class="site-title">SmartStack CLI</span>
15
- <span class="version-badge">v2.0.0</span>
15
+ <span class="version-badge">v3.0.0</span>
16
16
  <div class="header-divider"></div>
17
17
  <span class="page-title">EF Core Migrations</span>
18
18
  <nav class="breadcrumb">
@@ -12,7 +12,7 @@
12
12
  <header class="global-header">
13
13
  <div class="logo">SS</div>
14
14
  <span class="site-title">SmartStack CLI</span>
15
- <span class="version-badge">v2.6.3</span>
15
+ <span class="version-badge">v3.0.0</span>
16
16
  <div class="header-divider"></div>
17
17
  <span class="page-title">GitFlow Workflow</span>
18
18
  <nav class="breadcrumb">
@@ -12,7 +12,7 @@
12
12
  <header class="global-header">
13
13
  <div class="logo">SS</div>
14
14
  <span class="site-title">SmartStack CLI</span>
15
- <span class="version-badge">v2.0.0</span>
15
+ <span class="version-badge">v3.0.0</span>
16
16
  <div class="header-divider"></div>
17
17
  <span class="page-title">Hooks</span>
18
18
  <nav class="breadcrumb">
@@ -208,37 +208,25 @@
208
208
  <section id="configuration">
209
209
  <h2>Configuration</h2>
210
210
 
211
- <p data-lang="fr">Les hooks sont configures dans <code>~/.claude/hooks/hooks.json</code> :</p>
212
- <p data-lang="en">Hooks are configured in <code>~/.claude/hooks/hooks.json</code>:</p>
211
+ <p data-lang="fr">
212
+ Les hooks sont automatiquement installes et configures par <code>smartstack install</code>. Aucune configuration manuelle n'est necessaire.
213
+ </p>
214
+ <p data-lang="en">
215
+ Hooks are automatically installed and configured by <code>smartstack install</code>. No manual configuration is needed.
216
+ </p>
213
217
 
214
- <div class="code-block">
215
- <button class="copy-btn">Copy</button>
216
- <pre><code>{
217
- "hooks": {
218
- "PreToolUse": [
219
- {
220
- "matcher": "Bash",
221
- "hooks": [
222
- {
223
- "type": "command",
224
- "command": "node ~/.claude/scripts/validate-command.js"
225
- }
226
- ]
227
- }
228
- ],
229
- "PostToolUse": [
230
- {
231
- "matcher": "Write",
232
- "hooks": [
233
- {
234
- "type": "command",
235
- "command": "echo 'File written: $TOOL_OUTPUT'"
236
- }
237
- ]
238
- }
239
- ]
240
- }
241
- }</code></pre>
218
+ <div class="alert alert-success">
219
+ <span class="alert-icon">&#128161;</span>
220
+ <div class="alert-content">
221
+ <h5 data-lang="fr">Fichier de configuration</h5>
222
+ <h5 data-lang="en">Configuration file</h5>
223
+ <p data-lang="fr">
224
+ Les hooks sont stockes dans <code>~/.claude/hooks/hooks.json</code>. Ce fichier est gere automatiquement par la CLI.
225
+ </p>
226
+ <p data-lang="en">
227
+ Hooks are stored in <code>~/.claude/hooks/hooks.json</code>. This file is automatically managed by the CLI.
228
+ </p>
229
+ </div>
242
230
  </div>
243
231
  </section>
244
232
 
@@ -366,43 +354,16 @@ EF_MIGRATION_FORCE=1 git commit -m "message"</code></pre>
366
354
  <!-- Custom Hooks -->
367
355
  <section id="custom">
368
356
  <h2>
369
- <span data-lang="fr">Creer un hook personnalise</span>
370
- <span data-lang="en">Create a custom hook</span>
357
+ <span data-lang="fr">Hooks personnalises</span>
358
+ <span data-lang="en">Custom Hooks</span>
371
359
  </h2>
372
360
 
373
- <div class="code-block">
374
- <button class="copy-btn">Copy</button>
375
- <pre><code>{
376
- "hooks": {
377
- "PreToolUse": [
378
- {
379
- "matcher": "Bash",
380
- "hooks": [
381
- {
382
- "type": "command",
383
- "command": "node my-validation-script.js",
384
- "blocking": true
385
- }
386
- ]
387
- }
388
- ]
389
- }
390
- }</code></pre>
391
- </div>
392
-
393
- <div class="alert alert-info">
394
- <span class="alert-icon">&#128161;</span>
395
- <div class="alert-content">
396
- <h5 data-lang="fr">Variables d'environnement</h5>
397
- <h5 data-lang="en">Environment variables</h5>
398
- <p data-lang="fr">
399
- Les hooks ont acces a <code>$TOOL_NAME</code>, <code>$TOOL_INPUT</code>, <code>$TOOL_OUTPUT</code>, et <code>$CLAUDE_PLUGIN_ROOT</code>.
400
- </p>
401
- <p data-lang="en">
402
- Hooks have access to <code>$TOOL_NAME</code>, <code>$TOOL_INPUT</code>, <code>$TOOL_OUTPUT</code>, and <code>$CLAUDE_PLUGIN_ROOT</code>.
403
- </p>
404
- </div>
405
- </div>
361
+ <p data-lang="fr">
362
+ Vous pouvez creer vos propres hooks pour ajouter des validations specifiques a votre projet. Consultez la <a href="https://docs.anthropic.com/en/docs/claude-code/hooks" target="_blank">documentation officielle Claude Code</a> pour la syntaxe complete.
363
+ </p>
364
+ <p data-lang="en">
365
+ You can create your own hooks to add project-specific validations. See the <a href="https://docs.anthropic.com/en/docs/claude-code/hooks" target="_blank">official Claude Code documentation</a> for the full syntax.
366
+ </p>
406
367
  </section>
407
368
 
408
369
  <!-- Hook: mcp-check -->