@atlashub/smartstack-cli 1.13.1 → 1.14.0

package/templates/skills/feature-full/SKILL.md

@@ -1,45 +1,45 @@
 ---
 name: feature-full
 description: |
-  Cree une feature complete SmartStack avec toutes les integrations.
-  Utiliser ce skill quand:
-  - L'utilisateur veut creer une feature complete de A a Z
-  - L'utilisateur mentionne "oneshot", "feature complete", "full-stack"
-  - Creation d'un module avec notifications, workflows et/ou IA
-  - Besoin d'une experience utilisateur complete
+  Creates a complete SmartStack feature with all integrations.
+  Use this skill when:
+  - User wants to create a complete feature from A to Z
+  - User mentions "oneshot", "complete feature", "full-stack"
+  - Creating a module with notifications, workflows and/or AI
+  - Need for complete user experience
   Scope: Domain → Application → Infrastructure → API → Web + Notifications + Workflows + AI
 ---
 
 # Skill Feature Full SmartStack
 
-> **OneShot Development:** Orchestre tous les skills pour une feature complete.
+> **OneShot Development:** Orchestrates all skills for a complete feature.
 
-**Référence:** [_shared.md](../_shared.md) pour architecture, permissions, i18n
+**Reference:** [_shared.md](../_shared.md) for architecture, permissions, i18n
 
-## QUAND CE SKILL S'ACTIVE
+## WHEN THIS SKILL ACTIVATES
 
-| Declencheur | Exemple |
-|-------------|---------|
-| Feature complete | "Cree un module de gestion des produits" |
-| Full-stack | "Cree le backend et le frontend pour..." |
-| Integration | "Avec notifications et emails automatiques" |
+| Trigger | Example |
+|---------|---------|
+| Complete feature | "Create a product management module" |
+| Full-stack | "Create the backend and frontend for..." |
+| Integration | "With notifications and automated emails" |
 
-## FLOW COMPLET
+## COMPLETE FLOW
 
 ```
 DOMAIN → APPLICATION → INFRASTRUCTURE → API → WEB
                       + NOTIFICATIONS + WORKFLOWS + AI
 ```
 
-## WORKFLOW DE CREATION
+## CREATION WORKFLOW
 
-### PHASE 1: ANALYSE
+### PHASE 1: ANALYSIS
 
 ```
-□ Module/fonctionnalite ?
-□ Entites ? Operations CRUD ? Regles metier ?
-□ Notifications requises ? Emails automatiques ? IA ?
-□ Affichage: Cards/Table/Kanban ? Permissions ?
+□ Module/functionality?
+□ Entities? CRUD operations? Business rules?
+□ Notifications required? Automated emails? AI?
+□ Display: Cards/Table/Kanban? Permissions?
 ```
 
 ### PHASE 2: DOMAIN
@@ -71,7 +71,7 @@ Task<{Entity}Dto> CreateAsync(Create{Entity}Request request, CancellationToken c
 public record {Entity}Dto(Guid Id, string Name, string Status, DateTime CreatedAt);
 public record Create{Entity}Request(string Name, string? Description);
 
-// Permissions.cs + PermissionConfiguration.cs (2 fichiers!)
+// Permissions.cs + PermissionConfiguration.cs (2 files!)
 public const string View = "{context}.{area}.{module}.read";
 ```
 
@@ -82,13 +82,13 @@ public const string View = "{context}.{area}.{module}.read";
 builder.ToTable("{Entity}s", "{schema}");
 builder.Property(x => x.Name).HasMaxLength(200).IsRequired();
 
-// {Entity}Service.cs avec Notifications
+// {Entity}Service.cs with Notifications
 public async Task<{Entity}Dto> CreateAsync(...) {
     var entity = {Entity}.Create(request.Name, _currentUser.Id);
     _context.{Entity}s.Add(entity);
     await _context.SaveChangesAsync(ct);
     await _notificationService.SendNotificationAsync(_currentUser.Id,
-        NotificationType.{Entity}Created, "Cree", $"{entity.Name} cree",
+        NotificationType.{Entity}Created, "Created", $"{entity.Name} created",
         relatedEntityType: nameof({Entity}), relatedEntityId: entity.Id, ct);
     return MapToDto(entity);
 }
@@ -122,7 +122,7 @@ export const {module}Api = {
   create: (data) => apiClient.post<{Entity}Dto>('/{area}/{module}', data),
 };
 
-// use{Module}.ts avec SignalR
+// use{Module}.ts with SignalR
 export function use{Module}() {
   const queryClient = useQueryClient();
   useSignalR({ onNotification: (n) => {
@@ -132,10 +132,10 @@ export function use{Module}() {
   return { create: createMutation.mutate, ... };
 }
 
-// {Module}Page.tsx avec EntityCard
-<EntityCard title={item.name} actions={[{ label: 'Voir', onClick: () => navigate(...) }]} />
+// {Module}Page.tsx with EntityCard
+<EntityCard title={item.name} actions={[{ label: 'View', onClick: () => navigate(...) }]} />
 
-// Routes (nested obligatoire)
+// Routes (nested mandatory)
 <Route path="{area}"><Route path="{module}"><Route index element={<{Module}Page />} /></Route></Route>
 ```
 
@@ -161,21 +161,21 @@ var result = await _aiCompletionService.ExecutePromptByCodeWithValidationAsync<{
     "{entity}-analyzer", new Dictionary<string, object>{ ["name"] = entity.Name }, ct);
 ```
 
-## CHECKLIST COMPLETE
+## COMPLETE CHECKLIST
 
 ### Backend
 ```
 □ Domain: Entity + Factory + Behaviors + Enum + IAuditableEntity
-□ Application: Interface + DTOs + Permissions (2 fichiers!)
+□ Application: Interface + DTOs + Permissions (2 files!)
 □ Infrastructure: EF Config + Service + DI + DbSet + Migration
 □ API: Controller + Authorize + RequirePermission + ProducesResponseType
 ```
 
 ### Frontend
 ```
-□ {module}Api.ts + use{Module}.ts (avec SignalR) + {Module}Page.tsx + {Module}Form.tsx
+□ {module}Api.ts + use{Module}.ts (with SignalR) + {Module}Page.tsx + {Module}Form.tsx
 □ i18n: fr, en, it, de
-□ Routes nested dans App.tsx
+□ Nested routes in App.tsx
 ```
 
 ### Integrations
@@ -190,7 +190,7 @@ var result = await _aiCompletionService.ExecutePromptByCodeWithValidationAsync<{
 □ dotnet build + npm run build + npm run lint OK
 ```
 
-## SKILLS ORCHESTRES
+## ORCHESTRATED SKILLS
 
 | Skill | Phase |
 |-------|-------|
@@ -202,12 +202,12 @@ var result = await _aiCompletionService.ExecutePromptByCodeWithValidationAsync<{
 | `/ui-components` | 6 |
 | `/efcore:migration` | 4 |
 
-## REGLES ABSOLUES
+## ABSOLUTE RULES
 
 | DO | DON'T |
 |----|-------|
-| Architecture en couches | Acces DB direct frontend |
-| Factory Methods entites | Permissions strings hardcodees |
-| Permissions 2 fichiers | Routes plates |
-| Hooks SignalR | Skip i18n 4 langues |
+| Layered architecture | Direct frontend DB access |
+| Entity Factory Methods | Hardcoded permission strings |
+| Permissions 2 files | Flat routes |
+| SignalR hooks | Skip i18n 4 languages |
 | ProducesResponseType | Skip logging |

package/templates/skills/gitflow/SKILL.md

@@ -0,0 +1,277 @@
+---
+name: gitflow
+description: GitFlow workflow with versioning, worktrees, and EF Core migration management. Progressive step loading for minimal context usage.
+argument-hint: "[-a] [-f|-r|-h] <action> [name]"
+---
+
+<objective>
+Execute GitFlow workflows with automatic versioning, worktree management, and EF Core migration validation. Uses progressive step loading to minimize context and maintain fresh state at each phase.
+</objective>
+
+<quick_start>
+**Start a feature:**
+```bash
+/gitflow start feature user-auth
+/gitflow -f user-auth              # Shorthand
+```
+
+**Commit with EF Core validation:**
+```bash
+/gitflow commit                    # Interactive
+/gitflow -a commit "Add login"     # Auto mode
+```
+
+**Create PR and merge:**
+```bash
+/gitflow pr                        # Create PR
+/gitflow merge                     # Merge after approval
+```
+
+**Complete workflow (feature):**
+```bash
+/gitflow -a -f my-feature          # Auto + feature mode
+```
+
+**Flags:**
+- `-a` (auto): Skip confirmations
+- `-f` (feature): Feature workflow
+- `-r` (release): Release workflow
+- `-h` (hotfix): Hotfix workflow
+- `-s` (status): Show status only
+</quick_start>
+
+<parameters>
+
+<flags>
+**Mode flags (mutually exclusive):**
+| Short | Long | Description |
+|-------|------|-------------|
+| `-f` | `--feature` | Feature workflow (target: develop) |
+| `-r` | `--release` | Release workflow (target: main, merge-back develop) |
+| `-h` | `--hotfix` | Hotfix workflow (target: main, merge-back develop) |
+
+**Behavior flags:**
+| Short | Long | Description |
+|-------|------|-------------|
+| `-a` | `--auto` | Autonomous mode: skip confirmations |
+| `-s` | `--status` | Status mode: show state only, no actions |
+| `-v` | `--verbose` | Verbose output |
+| `--dry-run` | | Preview actions without executing |
+
+**Disable flags:**
+| Short | Long | Description |
+|-------|------|-------------|
+| `-A` | `--no-auto` | Disable auto mode |
+</flags>
+
+<actions>
+**Primary actions:**
+| Action | Description | Step |
+|--------|-------------|------|
+| `init` | Initialize GitFlow config | step-init |
+| `start` | Create new branch + worktree | step-start |
+| `commit` | Commit with EF Core validation | step-commit |
+| `sync` | Sync + rebase with remote | step-sync |
+| `plan` | Generate integration plan | step-plan |
+| `pr` | Create pull request | step-pr |
+| `merge` | Merge PR after review | step-merge |
+| `finish` | Finalize (tag + cleanup) | step-finish |
+
+**Standalone phases:**
+| Action | Description | Phase |
+|--------|-------------|-------|
+| `status` | Show complete state | phases/status |
+| `abort` | Rollback/recovery | phases/abort |
+| `cleanup` | Audit worktrees | phases/cleanup |
+</actions>
+
+<examples>
+```bash
+# Initialize GitFlow
+/gitflow init
+
+# Start feature with worktree
+/gitflow start feature payment-integration
+/gitflow -f payment-integration    # Shorthand
+
+# Start release
+/gitflow start release 2.0.0
+/gitflow -r 2.0.0                  # Shorthand
+
+# Start hotfix
+/gitflow start hotfix critical-fix
+/gitflow -h critical-fix           # Shorthand
+
+# Commit (with EF Core validation)
+/gitflow commit
+/gitflow -a commit "Fix bug"       # Auto mode
+
+# Sync with remote
+/gitflow sync
+
+# Create PR
+/gitflow pr
+
+# Merge after review
+/gitflow merge
+
+# Finalize branch
+/gitflow finish
+
+# Status check
+/gitflow status
+/gitflow -s                        # Shorthand
+
+# Abort/rollback
+/gitflow abort
+/gitflow abort --checkpoint        # Restore from checkpoint
+
+# Cleanup worktrees
+/gitflow cleanup
+/gitflow cleanup --dry-run         # Preview only
+```
+</examples>
+
+</parameters>
+
+<workflows>
+```
+FEATURE WORKFLOW
+────────────────
+start ──► commit* ──► sync ──► pr ──► merge ──► finish
+  │        (loop)      │               │
+  └── worktree ────────┴── rebase? ────┴── squash merge
+
+RELEASE WORKFLOW
+────────────────
+start ──► commit* ──► sync ──► pr ──► merge ──► finish
+  │        (loop)             (main)    │        │
+  └── worktree ───────────────────────────── merge-back develop
+                                              + tag vX.Y.Z
+
+HOTFIX WORKFLOW
+───────────────
+start ──► commit* ──► sync ──► pr ──► merge ──► finish
+  │        (loop)             (main)    │        │
+  └── worktree ───────────────────────────── merge-back develop
+                                              + tag vX.Y.Z+1
+```
+</workflows>
+
+<state_variables>
+**Persist throughout all steps:**
+
+| Variable | Type | Description |
+|----------|------|-------------|
+| `{branch_type}` | string | feature, release, hotfix |
+| `{branch_name}` | string | Full branch name (e.g., feature/user-auth) |
+| `{base_branch}` | string | Target branch (develop or main) |
+| `{worktree_path}` | string | Path to worktree directory |
+| `{version_current}` | string | Current version (X.Y.Z) |
+| `{version_next}` | string | Next version after merge |
+| `{auto_mode}` | boolean | Skip confirmations |
+| `{has_migrations}` | boolean | EF Core migrations detected |
+| `{pr_number}` | number | PR number (after creation) |
+| `{git_provider}` | string | github or azuredevops |
+
+</state_variables>
+
+<entry_point>
+
+**ROUTING LOGIC:**
+
+1. Parse flags and action from input
+2. Route to appropriate step or phase:
+
+| Input Pattern | Route To |
+|---------------|----------|
+| `init` | `steps/step-init.md` |
+| `start {type} {name}` | `steps/step-start.md` |
+| `-f {name}` | `steps/step-start.md` (type=feature) |
+| `-r {name}` | `steps/step-start.md` (type=release) |
+| `-h {name}` | `steps/step-start.md` (type=hotfix) |
+| `commit [msg]` | `steps/step-commit.md` |
+| `sync` | `steps/step-sync.md` |
+| `plan` | `steps/step-plan.md` |
+| `pr` | `steps/step-pr.md` |
+| `merge` | `steps/step-merge.md` |
+| `finish` | `steps/step-finish.md` |
+| `status` or `-s` | `phases/status.md` |
+| `abort` | `phases/abort.md` |
+| `cleanup` | `phases/cleanup.md` |
+| (no action, on feature/*) | `steps/step-commit.md` |
+
+</entry_point>
+
+<step_files>
+**Progressive loading - only load current step:**
+
+| Step | File | Purpose |
+|------|------|---------|
+| init | `steps/step-init.md` | Configure GitFlow, create branches |
+| start | `steps/step-start.md` | Create branch + worktree |
+| commit | `steps/step-commit.md` | Commit with EF Core validation |
+| sync | `steps/step-sync.md` | Push/pull + rebase if behind |
+| plan | `steps/step-plan.md` | Generate integration plan |
+| pr | `steps/step-pr.md` | Create pull request |
+| merge | `steps/step-merge.md` | Review checklist + merge |
+| finish | `steps/step-finish.md` | Tag + cleanup + version |
+
+**Standalone phases:**
+
+| Phase | File | Purpose |
+|-------|------|---------|
+| status | `phases/status.md` | Complete state diagnostic |
+| abort | `phases/abort.md` | Rollback and recovery |
+| cleanup | `phases/cleanup.md` | Audit and remove orphan worktrees |
+
+</step_files>
+
+<efcore_rules>
+**EF Core validation (MANDATORY):**
+
+1. **1 migration per feature** - Recreate, don't accumulate
+2. **3 required files** per migration:
+   - `{Migration}.cs`
+   - `{Migration}.Designer.cs`
+   - `{DbContext}ModelSnapshot.cs`
+3. **Sync before merge** - Rebase on base branch
+4. **ModelSnapshot conflict** - Accept theirs + Regenerate
+5. **Release** - Generate idempotent SQL script
+
+**Blocking conditions:**
+- Missing migration files → Block commit
+- Snapshot divergence → Require `/efcore:rebase-snapshot`
+- Destructive changes → Require confirmation
+</efcore_rules>
+
+<versioning>
+**Source priority:** csproj → Directory.Build.props → VERSION file → git tag
+
+**Auto-increment rules:**
+| Branch Type | Version Change | Example |
+|-------------|----------------|---------|
+| feature | minor | 1.2.0 → 1.3.0 |
+| hotfix | patch | 1.2.0 → 1.2.1 |
+| release | as specified | 1.2.0 → 2.0.0 |
+</versioning>
+
+<execution_rules>
+
+- **Load one step at a time** - Only load the current step file
+- **ULTRA THINK** before each action
+- **Persist state variables** across all steps
+- **Follow next_step directive** at end of each step
+- **NEVER skip EF Core validation** - migrations are critical
+- **Safety > Correctness > Speed**
+</execution_rules>
+
+<success_criteria>
+
+- Branch created with worktree (if start)
+- All commits validated (EF Core)
+- PR created with proper target
+- Merge completed with correct strategy
+- Tags created for releases/hotfixes
+- Worktrees cleaned up after finish
+</success_criteria>

package/templates/{commands → skills}/gitflow/_shared.md

@@ -1,12 +1,12 @@
-# GitFlow - Fonctions Partagées
+# GitFlow - Shared Functions
 
-> **Usage:** Ce fichier contient les fonctions réutilisables. Référencer avec `{{REF:section_name}}` dans les autres fichiers.
+> **Usage:** This file contains reusable functions. Reference with `{{REF:section_name}}` in other files.
 
 ---
 
 ## DETECT_PROVIDER
 
-Détecte GitHub ou Azure DevOps depuis le remote.
+Detects GitHub or Azure DevOps from remote URL.
 
 ```bash
 detect_git_provider() {
@@ -31,7 +31,7 @@ detect_git_provider() {
 
 ## NORMALIZE_NAME
 
-Normalise un nom de branche (accents, espaces, caractères spéciaux).
+Normalizes a branch name (accents, spaces, special characters).
 
 ```bash
 normalize_branch_name() {
@@ -47,7 +47,7 @@ normalize_branch_name() {
 
 ## DETECT_WORKTREE_MODE
 
-Détecte le mode worktree (organized, adjacent, none).
+Detects worktree mode (organized, adjacent, none).
 
 ```bash
 detect_worktree_mode() {
@@ -69,7 +69,7 @@ detect_worktree_mode() {
 
 ## CLEANUP_WORKTREE
 
-Nettoie un worktree pour une branche donnée.
+Cleans up a worktree for a given branch.
 
 ```bash
 cleanup_worktree_for_branch() {
@@ -81,7 +81,7 @@ cleanup_worktree_for_branch() {
     hotfix/*)  WORKTREE_PATH="$WORKTREE_BASE/hotfixes/${BRANCH#hotfix/}" ;;
   esac
 
-  # Mode organized
+  # Organized mode
   [ -d "../features" ] && case "$BRANCH" in
     feature/*) WORKTREE_PATH="../features/${BRANCH#feature/}" ;;
     release/*) WORKTREE_PATH="../releases/${BRANCH#release/}" ;;
@@ -91,7 +91,7 @@ cleanup_worktree_for_branch() {
   [ -d "$WORKTREE_PATH" ] && {
     git worktree remove "$WORKTREE_PATH" --force 2>/dev/null || rm -rf "$WORKTREE_PATH"
     git worktree prune
-    echo "✓ Worktree nettoyé: $WORKTREE_PATH"
+    echo "✓ Worktree cleaned: $WORKTREE_PATH"
   }
 }
 ```
@@ -100,7 +100,7 @@ cleanup_worktree_for_branch() {
 
 ## SYNC_REMOTE
 
-Synchronise avec le remote et affiche l'état.
+Syncs with remote and displays status.
 
 ```bash
 sync_with_remote() {
@@ -109,8 +109,8 @@ sync_with_remote() {
   local AHEAD=$(git rev-list --count origin/$BRANCH..HEAD 2>/dev/null || echo "0")
   local BEHIND=$(git rev-list --count HEAD..origin/$BRANCH 2>/dev/null || echo "0")
 
-  [ "$BEHIND" -gt 0 ] && echo "⚠️ $BRANCH: $BEHIND commit(s) en retard"
-  [ "$AHEAD" -gt 0 ] && echo "ℹ️ $BRANCH: $AHEAD commit(s) non poussé(s)"
+  [ "$BEHIND" -gt 0 ] && echo "⚠️ $BRANCH: $BEHIND commit(s) behind"
+  [ "$AHEAD" -gt 0 ] && echo "ℹ️ $BRANCH: $AHEAD commit(s) not pushed"
 }
 ```
 
@@ -118,14 +118,14 @@ sync_with_remote() {
 
 ## READ_GITFLOW_CONFIG
 
-Lit la configuration GitFlow.
+Reads GitFlow configuration.
 
 ```bash
 read_gitflow_config() {
   local CONFIG_FILE=".claude/gitflow/config.json"
   [ ! -f "$CONFIG_FILE" ] && return 1
 
-  # Variables exportées
+  # Exported variables
   GF_LANG=$(grep -oP '"code":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
   GF_WORKTREE_MODE=$(grep -oP '"mode":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
   GF_MAIN_BRANCH=$(grep -oP '"main":\s*"\K[^"]+' "$CONFIG_FILE" | head -1)
@@ -142,7 +142,7 @@ read_gitflow_config() {
 
 ## CONFIG_TEMPLATE
 
-Template JSON de configuration GitFlow (version minimale).
+GitFlow configuration JSON template (minimal version).
 
 ```json
 {
@@ -150,20 +150,20 @@ Template JSON de configuration GitFlow (version minimale).
   "branches": { "main": "main", "develop": "develop" },
   "prefixes": { "feature": "feature/", "release": "release/", "hotfix": "hotfix/" },
   "worktrees": { "mode": "organized" },
-  "language": { "code": "fr" }
+  "language": { "code": "en" }
 }
 ```
 
-**Options worktrees.mode:**
+**worktrees.mode options:**
 - `organized`: `../features/`, `../releases/`, `../hotfixes/`
 - `adjacent`: `../worktrees/{type}/`
-- `disabled`: Pas de worktrees
+- `disabled`: No worktrees
 
 ---
 
 ## PR_COMMANDS
 
-Commandes PR par provider.
+PR commands by provider.
 
 ### GitHub
 ```bash
@@ -183,7 +183,7 @@ az repos pr update --id $NUMBER --status completed --squash true --delete-source
 
 ## OUTPUT_FORMAT
 
-Format de sortie standard (remplace ASCII art).
+Standard output format (replaces ASCII art).
 
 ```bash
 output_header() { echo -e "\n## $1\n"; }
@@ -192,5 +192,5 @@ output_item() { echo "- $1"; }
 output_success() { echo "✓ $1"; }
 output_warning() { echo "⚠️ $1"; }
 output_error() { echo "❌ $1"; }
-output_next() { echo "→ Prochain: $1"; }
+output_next() { echo "→ Next: $1"; }
 ```