@atlashub/smartstack-cli 1.13.2 → 1.14.1

package/templates/commands/apex.md

@@ -1,76 +0,0 @@
----
-description: Systematic implementation using APEX methodology (Analyze-Plan-Execute-eXamine)
----
-
-You are a systematic implementation specialist. Follow the APEX workflow rigorously for every task.
-
-**You need to always ULTRA THINK.**
-
-**CRITICAL: When starting each phase, output a clear heading like "# 1. ANALYZE", "# 2. PLAN", "# 3. EXECUTE", "# 4. EXAMINE" so the user can see which phase you're in.**
-
-## 1. ANALYZE
-
-**Goal**: Find all relevant files for implementation
-
-- Launch **parallel subagents** to search codebase (`explore-codebase` agent is good for that)
-- Launch **parallel subagents** to gather online information (`websearch` agent is good for that)
-- Launch **parallel subagents** to search inside documentation (`explore-docs` agent is good for that)
-- Find files to use as **examples** or **edit targets**
-- Return relevant file paths and useful context
-- **CRITICAL**: Think deeply before starting agents - know exactly what to search for
-- Use multiple agents to search across different areas
-
-## 2. PLAN
-
-**Goal**: Create detailed implementation strategy
-
-- Write comprehensive implementation plan including:
-  - Core functionality changes
-  - Test coverage requirements
-  - Lookbook components if needed
-  - Documentation updates
-- **STOP and ASK** user if anything remains unclear
-
-## 3. EXECUTE
-
-**Goal**: Implement following existing patterns
-
-- Follow existing codebase style:
-  - Prefer clear variable/method names over comments
-  - Match existing patterns and conventions
-- **CRITICAL RULES**:
-  - Stay **STRICTLY IN SCOPE** - change only what's needed
-  - NO comments unless absolutely necessary
-  - Run autoformatting scripts when done
-  - Fix reasonable linter warnings
-
-## 4. EXAMINE
-
-**Goal**: Verify your changes work correctly
-
-- **First check package.json** for available scripts:
-  - Look for: `lint`, `typecheck`, `test`, `format`, `build`
-  - Run relevant commands like `npm run lint`, `npm run typecheck`
-- Run **ONLY tests related to your feature** using subagents
-- **STAY IN SCOPE**: Don't run entire test suite, just tests that match your changes
-- For major UX changes:
-  - Create test checklist for affected features only
-  - Use browser agent to verify specific functionality
-- **CRITICAL**: Code must pass linting and type checks
-- If tests fail: **return to PLAN phase** and rethink approach
-
-## Execution Rules
-
-- Use parallel execution for speed
-- Think deeply at each phase transition
-- Never exceed task boundaries
-- Follow repo standards for tests/docs/components
-- Test ONLY what you changed
-
-## Priority
-
-Correctness > Completeness > Speed. Each phase must be thorough before proceeding.
-
----
-
-User: $ARGUMENTS

package/templates/commands/application/create.md

@@ -1,362 +0,0 @@
-# /application:create - Génération Full-Stack SmartStack
-
-> **Synergie Skill/Commande:**
-> - **Skill** (`.claude/skills/application/`) → Invocation automatique par Claude
-> - **Commande** (`/application:create`) → Invocation manuelle par l'utilisateur
-> - Templates partagés dans `.claude/skills/application/templates-*.md`
-
----
-
-## ARGUMENTS
-
-```
-/application:create <level> <parent> <code> [options]
-```
-
-| Variable | Description | Valeurs |
-|----------|-------------|---------|
-| `level` | Niveau de navigation | `context`, `application`, `module`, `section` |
-| `parent` | Code du parent | Ex: `platform`, `platform.administration` |
-| `code` | Code de l'entité | Ex: `products`, `crm`, `erp` |
-
-**Exemples:**
-```bash
-# Créer un nouveau context
-/application:create context _ erp
-
-# Créer une application dans un context existant
-/application:create application platform sales
-
-# Créer un module dans une application existante
-/application:create module platform.administration products
-
-# Créer une section dans un module existant
-/application:create section platform.administration.users settings
-```
-
----
-
-## WORKFLOW
-
-### PHASE 1: PARSING & VALIDATION
-
-```
-1. EXTRAIRE level, parent, code des arguments
-2. VALIDER que le parent existe (sauf pour context)
-3. DÉTECTER le context racine
-4. GÉNÉRER les chemins de route et permission
-```
-
-### PHASE 2: COLLECTE DES TRADUCTIONS
-
-```typescript
-AskUserQuestion({
-  questions: [
-    {
-      header: "Labels FR",
-      question: "Libellés en français ?",
-      options: [
-        { label: "$CODE_PASCAL", description: "Label par défaut" }
-      ]
-    },
-    {
-      header: "Icône",
-      question: "Quelle icône Lucide ?",
-      options: [
-        { label: "Package", description: "Icône produit" },
-        { label: "Folder", description: "Icône générique" },
-        { label: "Settings", description: "Icône configuration" }
-      ]
-    }
-  ]
-})
-```
-
-### PHASE 3: GÉNÉRATION DB SEED
-
-| Fichier | Action |
-|---------|--------|
-| `Navigation{Level}Configuration.cs` | Ajouter entité |
-| `NavigationTranslationConfiguration.cs` | Ajouter 4 traductions |
-| `PermissionConfiguration.cs` | Ajouter permissions CRUD |
-| `RolePermissionConfiguration.cs` | Assigner aux rôles |
-
-**Templates:** → `.claude/skills/application/templates-seed.md`
-
-### PHASE 4: GÉNÉRATION BACKEND
-
-| Fichier | Action |
-|---------|--------|
-| `Permissions.cs` | Ajouter classe permissions |
-| `I{Entity}Service.cs` | Créer interface |
-| `{Entity}Service.cs` | Créer implémentation |
-| `{Entity}Dto.cs` | Créer DTOs |
-| `{Entity}.cs` | Créer entité Domain |
-| `{Entity}Configuration.cs` | Créer config EF |
-| `IApplicationDbContext.cs` | Ajouter DbSet |
-| `DependencyInjection.cs` | Enregistrer service |
-
-**Templates:** → `.claude/skills/application/templates-backend.md`
-
-**Chaîner:** → `/controller:create $AREA $MODULE $ENTITY`
-
-### PHASE 5: GÉNÉRATION FRONTEND
-
-| Fichier | Action |
-|---------|--------|
-| `{Module}Page.tsx` | Créer page principale |
-| `{Module}ListView.tsx` | Créer composant liste |
-| `use{Module}Preferences.ts` | Créer hook préférences |
-| `{module}Api.ts` | Créer service API |
-| `App.tsx` | Ajouter routes |
-
-**Templates:** → `.claude/skills/application/templates-frontend.md`
-
-#### 5.1 RÈGLE SECTIONS: Toute section DOIT avoir une page
-
-Pour les **sections** (`level=section`), vérifier si une page dédiée est demandée :
-
-```typescript
-// Logique de décision
-if (level === 'section') {
-  const hasCustomPage = userRequestedSpecificPage();
-
-  if (!hasCustomPage) {
-    // Créer page placeholder avec UnderDevelopment
-    createPlaceholderPage(code, parent);
-  }
-}
-```
-
-**Création automatique de page placeholder:**
-
-1. **Vérifier** que `UnderDevelopment.tsx` existe dans `components/ui/`
-2. **Créer** `{Section}Page.tsx` utilisant `UnderDevelopment`
-3. **Ajouter** route dans `App.tsx`
-4. **Ajouter** traductions i18n pour la section
-
-**Template page placeholder:**
-
-```tsx
-// web/smartstack-web/src/pages/{area}/{Section}Page.tsx
-import { {Icon} } from 'lucide-react';
-import { useTranslation } from 'react-i18next';
-import { UnderDevelopment } from '@/components/ui/UnderDevelopment';
-
-export function {Section}Page() {
-  const { t } = useTranslation('{namespace}');
-
-  return (
-    <div className="space-y-6">
-      <div>
-        <h1 className="text-2xl font-bold text-[var(--text-primary)]">
-          {t('{section}.title')}
-        </h1>
-        <p className="text-sm text-[var(--text-tertiary)] mt-1">
-          {t('{section}.subtitle')}
-        </p>
-      </div>
-      <div className="card">
-        <UnderDevelopment
-          title={t('{section}.underDevelopmentTitle')}
-          description={t('{section}.underDevelopmentDescription')}
-          icon={<{Icon} className="w-10 h-10 text-amber-600 dark:text-amber-400" />}
-          showBackButton={true}
-          backUrl="{parentRoute}"
-        />
-      </div>
-    </div>
-  );
-}
-```
-
-**Template traductions placeholder (à ajouter dans le namespace existant):**
-
-```json
-"{section}": {
-  "title": "{Label}",
-  "subtitle": "{Description}",
-  "underDevelopmentTitle": "{Label}",
-  "underDevelopmentDescription": "Cette fonctionnalité sera bientôt disponible."
-}
-```
-
-### PHASE 6: GÉNÉRATION I18N
-
-| Fichier | Action |
-|---------|--------|
-| `fr/{module}.json` | Créer traductions FR |
-| `en/{module}.json` | Créer traductions EN |
-| `it/{module}.json` | Créer traductions IT |
-| `de/{module}.json` | Créer traductions DE |
-| `navigation.json` (×4) | Mettre à jour |
-| `i18n/index.ts` | Enregistrer namespace |
-
-**Templates:** → `.claude/skills/application/templates-i18n.md`
-
-### PHASE 7: MIGRATION
-
-```bash
-# Chaîner automatiquement
-/efcore:migration Add{Level}{Code}
-```
-
-### PHASE 8: VALIDATION
-
-```bash
-# Backend
-dotnet build
-dotnet test
-
-# Frontend
-cd web/smartstack-web
-npm run build
-npm run lint
-npm run test
-```
-
-### PHASE 9: RÉSUMÉ
-
-```markdown
-## ✅ Création terminée
-
-### Fichiers créés
-- 📁 Backend: X fichiers
-- 📁 Frontend: X fichiers
-- 🌐 i18n: 4 langues
-
-### Navigation
-- Route: /$ROUTE
-- Permission: $PERMISSION_PATH.*
-
-### Prochaines étapes
-1. Vérifier les seeds générés
-2. Tester avec Swagger
-3. Valider l'UI
-
-### Commandes utiles
-- `dotnet ef database update` - Appliquer migration
-- `npm run dev` - Lancer frontend
-```
-
----
-
-## RÈGLES ABSOLUES
-
-1. **TOUJOURS** 4 langues (FR, EN, IT, DE)
-2. **TOUJOURS** respecter l'architecture en couches
-3. **TOUJOURS** implémenter les préférences utilisateur (template complet)
-4. **TOUJOURS** chaîner avec `/controller:create` et `/efcore:migration`
-5. **TOUJOURS** utiliser GUIDs déterministes (`GenerateGuid(index)`)
-6. **TOUJOURS** créer une page pour chaque section (placeholder si non spécifiée)
-7. **JAMAIS** de violation d'architecture (WEB → Infrastructure)
-8. **JAMAIS** de traduction manquante
-9. **JAMAIS** de section sans page frontend correspondante
-
----
-
-## VALIDATION ARCHITECTURE
-
-Le skill **DOIT** vérifier après génération :
-
-```typescript
-// Vérifier qu'aucun fichier frontend n'importe Infrastructure
-const frontendFiles = glob('web/**/*.{ts,tsx}');
-for (const file of frontendFiles) {
-  const content = read(file);
-  if (content.includes('SmartStack.Infrastructure')) {
-    ERROR('Architecture violation: ' + file);
-  }
-}
-```
-
----
-
-## SOURCES DE DONNÉES
-
-| Donnée | Source |
-|--------|--------|
-| Navigation entities | `src/SmartStack.Infrastructure/Persistence/Configurations/Navigation/` |
-| Translations | `NavigationTranslationConfiguration.cs` |
-| Permissions | `src/SmartStack.Application/Common/Authorization/Permissions.cs` |
-| i18n locales | `web/smartstack-web/src/i18n/locales/` |
-| Routes | `web/smartstack-web/src/App.tsx` |
-| UnderDevelopment | `web/smartstack-web/src/components/ui/UnderDevelopment.tsx` |
-
----
-
-## MAPPING NIVEAU → GÉNÉRATION
-
-| Niveau | DB Seed | Backend | Frontend | i18n |
-|--------|---------|---------|----------|------|
-| Context | ✅ | ❌ | ❌ | ✅ (nav) |
-| Application | ✅ | ❌ | ✅ (layout) | ✅ (nav) |
-| Module | ✅ | ✅ (complet) | ✅ (complet) | ✅ (complet) |
-| Section | ✅ | ✅ (optionnel) | ✅ (page ou placeholder) | ✅ (nav + section) |
-
-> **Note Section:** Toute section DOIT avoir une page. Si aucune page spécifique n'est demandée, créer automatiquement une page placeholder utilisant `UnderDevelopment`.
-
----
-
-## EXEMPLES COMPLETS
-
-### Exemple 1: Nouveau module Products
-
-```bash
-/application:create module business.sales products
-```
-
-Génère:
-- Navigation seed + 4 traductions
-- Permissions CRUD
-- Domain entity `Product`
-- Service `IProductService` + `ProductService`
-- DTOs
-- Controller (via /controller:create)
-- Page React + ListView + Hook préférences
-- 4 fichiers i18n
-- Routes
-- Migration
-
-### Exemple 2: Nouvelle application CRM
-
-```bash
-/application:create application business crm
-```
-
-Génère:
-- Navigation seed application + 4 traductions
-- Layout/Dashboard pour CRM
-- Mise à jour navigation.json (4 langues)
-
-### Exemple 3: Nouveau context ERP
-
-```bash
-/application:create context _ erp
-```
-
-Génère:
-- Navigation seed context + 4 traductions
-- Mise à jour navigation.json (4 langues)
-- Base pour futures applications
-
-### Exemple 4: Nouvelle section (avec page placeholder automatique)
-
-```bash
-/application:create section platform.administration.workflows analytics
-```
-
-Génère:
-- Navigation seed section + 4 traductions
-- Permissions (si applicable)
-- **Page placeholder** `WorkflowAnalyticsPage.tsx` utilisant `UnderDevelopment`
-- Traductions i18n pour la section (titre, description, underDevelopment)
-- Route dans `App.tsx`
-- Export dans `index.ts` du dossier pages
-
-**Fichiers créés:**
-```
-web/smartstack-web/src/pages/admin/communications/WorkflowAnalyticsPage.tsx
-web/smartstack-web/src/i18n/locales/{fr,en,de,it}/communications.json (màj)
-web/smartstack-web/src/App.tsx (màj)
-```