@atlashub/smartstack-cli 1.13.2 → 1.14.1

package/templates/skills/_shared.md

@@ -1,29 +1,29 @@
-# Skills SmartStack - Fonctions Partagées
+# Skills SmartStack - Shared Functions
 
-## Stratégie Modèles
+## Model Strategy
 
-| Tâche | Modèle | Raison |
-|-------|--------|--------|
-| Génération code | **Sonnet** | Rapport qualité/coût optimal |
-| Audit sécurité | **Opus** | Analyse critique requise |
-| Validation finale | **Opus** | Décisions architecturales |
+| Task | Model | Reason |
+|------|-------|--------|
+| Code generation | **Sonnet** | Optimal quality/cost ratio |
+| Security audit | **Opus** | Critical analysis required |
+| Final validation | **Opus** | Architectural decisions |
 
-## Architecture SmartStack
+## SmartStack Architecture
 
 ```
 Domain → Application → Infrastructure → API → Web
 ```
 
 ### Layers
-| Layer | Responsabilité | Namespace |
-|-------|---------------|-----------|
-| Domain | Entités, ValueObjects | `SmartStack.Domain.{Context}` |
+| Layer | Responsibility | Namespace |
+|-------|-----------------|-----------|
+| Domain | Entities, ValueObjects | `SmartStack.Domain.{Context}` |
 | Application | Services, DTOs, Interfaces | `SmartStack.Application.{Context}` |
-| Infrastructure | Implémentations, EF Core | `SmartStack.Infrastructure.{Context}` |
+| Infrastructure | Implementations, EF Core | `SmartStack.Infrastructure.{Context}` |
 | API | Controllers, Middleware | `SmartStack.Api.Controllers.{Area}` |
 | Web | React components, pages | `src/pages/{context}/{app}/{module}` |
 
-## Permissions (2 fichiers obligatoires)
+## Permissions (2 mandatory files)
 
 ### 1. Permissions.cs (Application layer)
 ```csharp
@@ -45,16 +45,16 @@ builder.HasData(
 );
 ```
 
-## i18n (4 langues obligatoires)
+## i18n (4 mandatory languages)
 
-| Langue | Fichier | Code |
-|--------|---------|------|
-| Français | `fr.json` | `fr` |
+| Language | File | Code |
+|----------|------|------|
+| French | `fr.json` | `fr` |
 | English | `en.json` | `en` |
-| Italiano | `it.json` | `it` |
-| Deutsch | `de.json` | `de` |
+| Italian | `it.json` | `it` |
+| German | `de.json` | `de` |
 
-### Structure i18n
+### i18n Structure
 ```json
 {
   "{context}": {
@@ -70,48 +70,48 @@ builder.HasData(
 }
 ```
 
-## Services Communs à Injecter
+## Common Services to Inject
 
 | Service | Usage |
 |---------|-------|
-| `IApplicationDbContext` | Accès DB |
-| `ICurrentUserService` | User courant |
+| `IApplicationDbContext` | DB access |
+| `ICurrentUserService` | Current user |
 | `ILogger<T>` | Logging |
 | `IMapper` | AutoMapper |
-| `IPermissionService` | Cache permissions |
+| `IPermissionService` | Permission cache |
 
-## Validation Sécurité
+## Security Validation
 
-### Logs Critiques
-| Événement | Niveau |
-|-----------|--------|
-| Login échoué | `Critical` |
-| Permission refusée | `Critical` |
-| Compte verrouillé | `Critical` |
+### Critical Logs
+| Event | Level |
+|-------|-------|
+| Failed login | `Critical` |
+| Permission denied | `Critical` |
+| Account locked | `Critical` |
 | Password change | `Warning` |
-| Suppression | `Warning` |
+| Deletion | `Warning` |
 
-### Protection Comptes Système
+### System Account Protection
 ```csharp
 if (entity.UserType == UserType.System || entity.UserType == UserType.LocalAdmin)
     return BadRequest(new { message = "Cannot modify system accounts" });
 ```
 
-## Checklist Validation Commune
+## Common Validation Checklist
 
 ```
-□ Permissions créées (Permissions.cs + PermissionConfiguration.cs)
-□ Migration EF Core créée
-□ i18n 4 langues (fr, en, it, de)
-□ Tests unitaires
-□ Documentation API (ProducesResponseType)
+□ Permissions created (Permissions.cs + PermissionConfiguration.cs)
+□ EF Core migration created
+□ i18n 4 languages (fr, en, it, de)
+□ Unit tests
+□ API documentation (ProducesResponseType)
 ```
 
-## Références MCP Tools
+## MCP Tools References
 
 | Tool | Usage |
 |------|-------|
-| `mcp__smartstack__validate_conventions` | Validation conventions |
-| `mcp__smartstack__scaffold_extension` | Génération code |
-| `mcp__smartstack__check_migrations` | Vérification migrations |
-| `mcp__smartstack__scaffold_tests` | Génération tests |
+| `mcp__smartstack__validate_conventions` | Validate conventions |
+| `mcp__smartstack__scaffold_extension` | Code generation |
+| `mcp__smartstack__check_migrations` | Check migrations |
+| `mcp__smartstack__scaffold_tests` | Generate tests |

package/templates/skills/ai-prompt/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: ai-prompt
 description: |
-  Integre les capacites IA dans les features SmartStack.
-  Utiliser ce skill quand:
-  - L'utilisateur veut integrer l'IA dans une fonctionnalite
-  - L'utilisateur mentionne "prompt", "GPT", "Claude", "IA", "AI"
-  - Creation d'un assistant ou chatbot
-  - Generation de contenu automatique
-  - Validation de reponses IA avec schema
+  Integrates AI capabilities into SmartStack features.
+  Use this skill when:
+  - User wants to integrate AI into a feature
+  - User mentions "prompt", "GPT", "Claude", "IA", "AI"
+  - Creating an assistant or chatbot
+  - Automatic content generation
+  - AI response validation with schema
   Types: Prompt, OutputSchema, Provider, Model
 ---
 
@@ -16,19 +16,19 @@ description: |
 > **Architecture:** Prompt + Blocks → Provider + Model → Completion → Schema Validation
 > Multi-provider: OpenAI, Anthropic (Claude), Azure OpenAI, Google Gemini
 
-**Référence:** [_shared.md](../_shared.md) pour patterns communs
+**Reference:** [_shared.md](../_shared.md) for common patterns
 
-## QUAND CE SKILL S'ACTIVE
+## WHEN THIS SKILL ACTIVATES
 
-| Declencheur | Exemple |
-|-------------|---------|
-| Demande explicite | "Integre GPT pour generer des descriptions" |
-| Chatbot/Assistant | "Cree un assistant pour le support" |
-| Generation contenu | "Genere automatiquement des reponses" |
-| Analyse texte | "Analyse le sentiment des commentaires" |
-| Mots-cles | "prompt", "GPT", "Claude", "IA", "completion", "LLM" |
+| Trigger | Example |
+|---------|---------|
+| Explicit request | "Integrate GPT to generate descriptions" |
+| Chatbot/Assistant | "Create an assistant for support" |
+| Content generation | "Auto-generate responses" |
+| Text analysis | "Analyze the sentiment of comments" |
+| Keywords | "prompt", "GPT", "Claude", "IA", "completion", "LLM" |
 
-## FLOW IA
+## AI FLOW
 
 ```
 Feature → IAiCompletionService.ExecutePromptAsync()
@@ -38,7 +38,7 @@ Prompt + Blocks → Provider Instance → External API (OpenAI/Claude/Azure/Gemi
 AI Response → OutputSchema Validation → Typed Result<T>
 ```
 
-## ENTITES PRINCIPALES
+## MAIN ENTITIES
 
 ### AiProvider & AiModel
 - **Providers:** OpenAI, Anthropic, Azure OpenAI, Google
@@ -46,7 +46,7 @@ AI Response → OutputSchema Validation → Typed Result<T>
 - Properties: Code, ContextWindow, MaxOutputTokens, InputCost, OutputCost, SupportsVision, SupportsStreaming
 
 ### AiProviderInstance
-Instance configurée: Code, Name, SystemContext, DefaultModel, MonthlyBudgetLimit, EncryptedApiKey
+Configured instance: Code, Name, SystemContext, DefaultModel, MonthlyBudgetLimit, EncryptedApiKey
 
 ### Prompt & PromptBlock
 ```csharp
@@ -56,20 +56,20 @@ Instance configurée: Code, Name, SystemContext, DefaultModel, MonthlyBudgetLimi
 ```
 
 ### OutputSchema
-JSON Schema pour validation: Code, Name, JsonSchema, DotNetType
+JSON Schema for validation: Code, Name, JsonSchema, DotNetType
 
 ## WORKFLOW INTEGRATION
 
-### 1. Definir le Use Case
+### 1. Define the Use Case
 | Question | Impact |
 |----------|--------|
-| Type de contenu ? | Choix modele |
-| Reponse structuree ? | OutputSchema |
-| Multi-langue ? | Variables langue |
-| Budget limite ? | ProviderInstance |
-| Temps reel ? | Streaming |
+| Content type? | Model choice |
+| Structured response? | OutputSchema |
+| Multi-language? | Language variables |
+| Budget limited? | ProviderInstance |
+| Real-time? | Streaming |
 
-### 2. Creer le Prompt
+### 2. Create the Prompt
 ```csharp
 var promptId = await _promptService.CreatePromptAsync(new CreatePromptRequest
 {
@@ -90,7 +90,7 @@ var promptId = await _promptService.CreatePromptAsync(new CreatePromptRequest
 });
 ```
 
-### 3. Definir OutputSchema (si reponse structuree)
+### 3. Define OutputSchema (if structured response)
 ```csharp
 var schemaId = await _schemaService.CreateAsync(new CreateSchemaRequest
 {
@@ -100,22 +100,22 @@ var schemaId = await _schemaService.CreateAsync(new CreateSchemaRequest
 });
 ```
 
-### 4. Executer le Prompt
+### 4. Execute the Prompt
 ```csharp
-// Execution simple
+// Simple execution
 var result = await _aiService.ExecutePromptAsync(promptId, new Dictionary<string, object>
 {
     ["ticketTitle"] = ticket.Title,
     ["ticketDescription"] = ticket.Description
 });
 
-// Avec validation typee
+// With typed validation
 var typedResult = await _aiService.ExecutePromptWithValidationAsync<TicketAnalysisResult>(
     promptId, variables);
 if (typedResult.Success && typedResult.IsValid) { /* use typedResult.Data */ }
 ```
 
-## SERVICES IA
+## AI SERVICES
 
 ### IAiCompletionService
 ```csharp
@@ -151,17 +151,17 @@ const { execute, loading, error, result } = useAiCompletion<T>(promptCode);
 const data = await execute(variables);
 ```
 
-### Composant AiAssistantButton
+### Component AiAssistantButton
 ```tsx
 <AiAssistantButton
   promptCode="ticket-analyzer"
   variables={{ ticketTitle, ticketDescription }}
   onResult={(result) => handleAnalysis(result)}
-  label="Analyser avec IA"
+  label="Analyze with AI"
 />
 ```
 
-## PATTERNS AVANCES
+## ADVANCED PATTERNS
 
 ### Streaming Response
 ```typescript
@@ -180,32 +180,32 @@ foreach (var provider in providers.OrderBy(p => p.Priority)) {
 ## CHECKLIST
 
 ```
-□ Prompt cree (Code unique, Blocks, Variables, Version)
-□ OutputSchema si reponse structuree
-□ Service avec IAiCompletionService injecte
-□ Gestion erreurs + Logging (tokens, temps)
-□ Frontend: Hook/composant, Loading, Error handling
-□ ProviderInstance avec limite budget
-□ Tests: execution, variables, validation schema
+□ Prompt created (unique Code, Blocks, Variables, Version)
+□ OutputSchema if structured response
+□ Service with IAiCompletionService injected
+□ Error handling + Logging (tokens, time)
+□ Frontend: Hook/component, Loading, Error handling
+□ ProviderInstance with budget limit
+□ Tests: execution, variables, schema validation
 ```
 
-## REGLES ABSOLUES
+## ABSOLUTE RULES
 
 | DO | DON'T |
 |----|-------|
-| IAiCompletionService pour executions | Appels API directs |
-| OutputSchema pour reponses structurees | Reponses non validees |
-| Gestion erreurs (API down, quota) | Ignorer les limites tokens |
-| Logger executions (tokens, duree) | Hardcoder cles API |
-| Variables pour contenu dynamique | Exposer prompts systeme au frontend |
+| IAiCompletionService for executions | Direct API calls |
+| OutputSchema for structured responses | Unvalidated responses |
+| Error handling (API down, quota) | Ignore token limits |
+| Log executions (tokens, duration) | Hardcode API keys |
+| Variables for dynamic content | Expose system prompts to frontend |
 
-## FICHIERS CLES
+## KEY FILES
 
-| Fichier | Role |
-|---------|------|
-| `Domain/AI/Prompts/Prompt.cs` | Entite prompt |
+| File | Role |
+|------|------|
+| `Domain/AI/Prompts/Prompt.cs` | Prompt entity |
 | `Domain/AI/Schemas/OutputSchema.cs` | Schema validation |
-| `Domain/AI/AiProviderInstance.cs` | Instance configuree |
-| `Application/Common/Interfaces/IAiCompletionService.cs` | Interface service |
+| `Domain/AI/AiProviderInstance.cs` | Configured instance |
+| `Application/Common/Interfaces/IAiCompletionService.cs` | Service interface |
 | `Infrastructure/Services/AI/AiCompletionService.cs` | Implementation |
-| `web/src/services/api/aiApi.ts` | API frontend |
+| `web/src/services/api/aiApi.ts` | Frontend API |

package/templates/skills/apex/SKILL.md

@@ -0,0 +1,235 @@
+---
+name: apex
+description: Systematic implementation using APEX methodology (Analyze-Plan-Execute-eXamine) with progressive step loading and context refresh.
+argument-hint: "[-a] [-x] [-s] [-t] [-e] [-i] [-b] [-pr] [-r <task-id>] <task description>"
+---
+
+<objective>
+Execute systematic implementation workflows using the APEX methodology. This skill uses progressive step loading to minimize context usage and maintain fresh context throughout the workflow.
+</objective>
+
+<quick_start>
+**Basic usage:**
+
+```bash
+/apex add authentication middleware
+```
+
+**Recommended workflow (autonomous with save):**
+
+```bash
+/apex -a -s implement user registration
+```
+
+**With adversarial review:**
+
+```bash
+/apex -a -x -s fix login bug
+```
+
+**Flags:**
+
+- `-a` (auto): Skip confirmations
+- `-s` (save): Save outputs to `.claude/output/apex/`
+- `-x` (examine): Include adversarial code review
+- `-t` (test): Create and run tests
+- `-e` (economy): No subagents, direct tool usage
+
+See `<parameters>` for complete flag list.
+</quick_start>
+
+<parameters>
+
+<flags>
+**Enable flags (turn ON):**
+| Short | Long | Description |
+|-------|------|-------------|
+| `-a` | `--auto` | Autonomous mode: skip confirmations, auto-approve plans |
+| `-x` | `--examine` | Auto-examine mode: proceed to adversarial review |
+| `-s` | `--save` | Save mode: output each step to `.claude/output/apex/` |
+| `-t` | `--test` | Test mode: include test creation and runner steps |
+| `-e` | `--economy` | Economy mode: no subagents, save tokens |
+| `-r` | `--resume` | Resume mode: continue from a previous task |
+| `-b` | `--branch` | Branch mode: verify not on main, create branch if needed |
+| `-pr` | `--pull-request` | PR mode: create pull request at end (enables -b) |
+| `-i` | `--interactive` | Interactive mode: configure flags via AskUserQuestion |
+
+**Disable flags (turn OFF):**
+| Short | Long | Description |
+|-------|------|-------------|
+| `-A` | `--no-auto` | Disable auto mode |
+| `-X` | `--no-examine` | Disable examine mode |
+| `-S` | `--no-save` | Disable save mode |
+| `-T` | `--no-test` | Disable test mode |
+| `-E` | `--no-economy` | Disable economy mode |
+| `-B` | `--no-branch` | Disable branch mode |
+| `-PR` | `--no-pull-request` | Disable PR mode |
+</flags>
+
+<examples>
+```bash
+# Basic usage
+/apex add auth middleware
+
+# Autonomous mode (no confirmations)
+/apex -a add auth middleware
+
+# Save outputs for review
+/apex -s add auth middleware
+
+# With adversarial review
+/apex -x add auth middleware
+
+# Full autonomous with examine and save
+/apex -a -x -s add auth middleware
+
+# Include test creation and runner
+/apex -t add auth middleware
+
+# Resume a previous task
+/apex -r 01-auth-middleware
+/apex -r 01 # Partial match supported
+
+# Combined flags
+/apex -a -x -s -t add auth middleware
+
+# Interactive mode (configure flags via menu)
+/apex -i add auth middleware
+
+# Economy mode (save tokens, no subagents)
+/apex -e add auth middleware
+
+# Branch mode (ensure not on main, create branch if needed)
+/apex -b add auth middleware
+
+# Create PR at end (automatically enables -b)
+/apex -pr add auth middleware
+/apex -a -pr add auth middleware # Auto + PR mode
+
+# Full workflow: auto + examine + save + tests + PR
+/apex -a -x -s -t -pr add auth middleware
+```
+</examples>
+
+<parsing_rules>
+**Flag parsing:**
+
+1. Defaults loaded from `steps/step-00-init.md` `<defaults>` section
+2. Command-line flags override defaults
+3. Flags removed from input, remainder becomes `{task_description}`
+4. Task ID generated as `NN-kebab-case-description`
+</parsing_rules>
+
+</parameters>
+
+<output_structure>
+**When `{save_mode}` = true:**
+
+All outputs saved to PROJECT directory:
+```
+.claude/output/apex/{task-id}/
+├── 00-context.md     # Params, user request, timestamp
+├── 01-analyze.md     # Analysis findings
+├── 02-plan.md        # Implementation plan
+├── 03-execute.md     # Execution log
+├── 04-validate.md    # Validation results
+├── 05-examine.md     # Review findings (if -x)
+├── 06-resolve.md     # Resolution log (if -x)
+├── 07-tests.md       # Test creation (if -t)
+├── 08-run-tests.md   # Test runner log (if -t)
+└── 09-finish.md      # PR creation (if -pr)
+```
+</output_structure>
+
+<resume_workflow>
+**Resume mode (`-r {task-id}`):**
+
+When provided, step-00 will:
+
+1. Locate the task folder in `.claude/output/apex/`
+2. Read `00-context.md` to restore state
+3. Find the last completed step
+4. Continue from the next step
+</resume_workflow>
+
+<workflow>
+**Standard flow:**
+1. Parse flags and task description
+2. If `-r`: Execute resume workflow
+3. If `-s`: Create output folder and 00-context.md
+4. Load step-01-analyze.md -> gather context
+5. Load step-02-plan.md -> create strategy
+6. Load step-03-execute.md -> implement
+7. Load step-04-validate.md -> verify
+8. If `--test`: Load step-07-tests.md -> create tests
+9. If `--test`: Load step-08-run-tests.md -> run until green
+10. If `-x` or user requests: Load step-05-examine.md -> adversarial review
+11. If findings: Load step-06-resolve.md -> fix findings
+12. If `-pr`: Load step-09-finish.md -> create pull request
+</workflow>
+
+<state_variables>
+**Persist throughout all steps:**
+
+| Variable                | Type    | Description                                            |
+| ----------------------- | ------- | ------------------------------------------------------ |
+| `{task_description}`    | string  | What to implement (flags removed)                      |
+| `{feature_name}`        | string  | Kebab-case name (e.g., `add-auth-middleware`)          |
+| `{task_id}`             | string  | Full identifier (e.g., `01-add-auth-middleware`)       |
+| `{acceptance_criteria}` | list    | Success criteria (inferred or explicit)                |
+| `{auto_mode}`           | boolean | Skip confirmations                                     |
+| `{examine_mode}`        | boolean | Auto-proceed to adversarial review                     |
+| `{save_mode}`           | boolean | Save outputs to .claude/output/apex/                   |
+| `{test_mode}`           | boolean | Include test steps (07-08)                             |
+| `{economy_mode}`        | boolean | No subagents, direct tool usage only                   |
+| `{branch_mode}`         | boolean | Verify not on main, create branch if needed            |
+| `{pr_mode}`             | boolean | Create pull request at end                             |
+| `{interactive_mode}`    | boolean | Configure flags interactively                          |
+| `{resume_task}`         | string  | Task ID to resume (if -r provided)                     |
+| `{output_dir}`          | string  | Full path to output directory                          |
+| `{branch_name}`         | string  | Created branch name (if branch_mode)                   |
+
+</state_variables>
+
+<entry_point>
+
+**FIRST ACTION:** Load `steps/step-00-init.md`
+
+</entry_point>
+
+<step_files>
+**Progressive loading - only load current step:**
+
+| Step | File                         | Purpose                                              |
+| ---- | ---------------------------- | ---------------------------------------------------- |
+| 00   | `steps/step-00-init.md`      | Parse flags, create output folder, initialize state  |
+| 01   | `steps/step-01-analyze.md`   | Pure context gathering (what exists, not what to do) |
+| 02   | `steps/step-02-plan.md`      | File-by-file implementation strategy                 |
+| 03   | `steps/step-03-execute.md`   | Todo-driven implementation                           |
+| 04   | `steps/step-04-validate.md`  | Self-check and validation                            |
+| 05   | `steps/step-05-examine.md`   | Adversarial code review (optional)                   |
+| 06   | `steps/step-06-resolve.md`   | Finding resolution (optional)                        |
+| 07   | `steps/step-07-tests.md`     | Test analysis and creation (if --test)               |
+| 08   | `steps/step-08-run-tests.md` | Test runner loop until green (if --test)             |
+| 09   | `steps/step-09-finish.md`    | Create pull request (if --pull-request)              |
+
+</step_files>
+
+<execution_rules>
+
+- **Load one step at a time** - Only load the current step file
+- **ULTRA THINK** before major decisions
+- **Persist state variables** across all steps
+- **Follow next_step directive** at end of each step
+- **Save outputs** if `{save_mode}` = true (write to step file)
+- **Use parallel agents** for independent exploration tasks (unless economy_mode)
+</execution_rules>
+
+<success_criteria>
+
+- Each step loaded progressively
+- All validation checks passing
+- Outputs saved if `{save_mode}` enabled
+- Tests passing if `{test_mode}` enabled
+- Clear completion summary provided
+</success_criteria>