cad-workflow 1.1.0

package/config/install-config.yaml

@@ -0,0 +1,167 @@
+code: cad
+name: "CAD - Clean Agentic Dev Workflow"
+description: "Workflow de développement assisté par IA avec Clean Architecture Hexagonale et TDD"
+version: "1.0.0"
+
+welcome_message: |
+
+  ╔═══════════════════════════════════════════════════════════════╗
+  ║                                                               ║
+  ║   🚀 CAD - Clean Agentic Dev Workflow                         ║
+  ║                                                               ║
+  ║   Développement assisté par IA avec :                         ║
+  ║   • Clean Architecture Hexagonale                             ║
+  ║   • TDD (Test-Driven Development)                             ║
+  ║   • Agents spécialisés (dev, review)                          ║
+  ║   • Workflow en 7 phases avec validation                      ║
+  ║                                                               ║
+  ╚═══════════════════════════════════════════════════════════════╝
+
+project_name:
+  prompt: "Nom du projet ?"
+  default: "{directory_name}"
+  result: "{value}"
+
+stack:
+  prompt: "Quelle stack utilisez-vous ?"
+  default: "mobile"
+  result: "{value}"
+  single-select:
+    - value: "mobile"
+      label: "📱 Mobile - React Native Expo + Backend NestJS"
+      description: "App mobile iOS/Android avec API backend"
+      installs:
+        - "stacks/mobile"
+    - value: "web"
+      label: "🌐 Web - Angular/React + Backend NestJS"
+      description: "Application web frontend + API backend"
+      installs:
+        - "stacks/web"
+    - value: "backend-only"
+      label: "⚙️  Backend Only - NestJS"
+      description: "API backend uniquement"
+      installs:
+        - "stacks/backend-only"
+
+ticket_management:
+  prompt: "Comment gérez-vous vos tickets/stories ?"
+  default: "local"
+  result: "{value}"
+  single-select:
+    - value: "jira"
+      label: "🎫 Jira - Connecter à un board Jira"
+      description: "Récupération tickets, transitions auto, commentaires"
+      installs:
+        - "integrations/jira"
+      triggers_prompts:
+        - jira_url
+        - jira_email
+        - jira_token
+        - jira_project_key
+    - value: "local"
+      label: "📁 Local - Stories en fichiers markdown"
+      description: "Gérer les stories localement dans .cad/stories/"
+
+jira_url:
+  prompt: "URL de votre workspace Atlassian"
+  placeholder: "https://votre-workspace.atlassian.net"
+  validation: "^https://.+\\.atlassian\\.net$"
+  validation_error: "L'URL doit être au format https://xxx.atlassian.net"
+  result: "{value}"
+  conditional: "ticket_management == jira"
+
+jira_email:
+  prompt: "Email de votre compte Atlassian"
+  placeholder: "vous@example.com"
+  validation: "^[^@]+@[^@]+\\.[^@]+$"
+  validation_error: "Email invalide"
+  result: "{value}"
+  conditional: "ticket_management == jira"
+
+jira_token:
+  prompt: "API Token Jira"
+  type: "password"
+  help: "Créer sur https://id.atlassian.com/manage-profile/security/api-tokens"
+  result: "{value}"
+  conditional: "ticket_management == jira"
+  sensitive: true
+
+jira_project_key:
+  prompt: "Clé du projet Jira"
+  placeholder: "PROJ"
+  validation: "^[A-Z][A-Z0-9_]*$"
+  validation_error: "La clé doit être en majuscules (ex: PROJ, CAD, MYAPP)"
+  result: "{value}"
+  conditional: "ticket_management == jira"
+
+workflow_config:
+  min_coverage:
+    prompt: "Couverture de tests minimum (%)"
+    default: "80"
+    result: "{value}"
+  min_mutation_score:
+    prompt: "Score de mutation minimum (%)"
+    default: "75"
+    result: "{value}"
+
+directories:
+  - ".cad"
+  - ".claude/agents"
+  - ".claude/commands"
+  - ".claude/skills"
+  - "docs/architecture"
+  - "docs/adr"
+
+conditional_directories:
+  - path: ".cad/stories"
+    condition: "ticket_management == local"
+
+files_to_generate:
+  - template: ".cad/config.yaml.tpl"
+    output: ".cad/config.yaml"
+  - template: ".cad/workflow-status.yaml.tpl"
+    output: ".cad/workflow-status.yaml"
+
+sensitive_files:
+  - template: ".claude/settings.local.json.tpl"
+    output: ".claude/settings.local.json"
+    condition: "ticket_management == jira"
+    gitignore: true
+
+post_install_message_local: |
+
+  ╔═══════════════════════════════════════════════════════════════╗
+  ║  ✅ CAD WORKFLOW INSTALLÉ (MODE LOCAL)                        ║
+  ╠═══════════════════════════════════════════════════════════════╣
+  ║                                                               ║
+  ║  Stack    : {stack}                                           ║
+  ║  Tickets  : Local (.cad/stories/)                             ║
+  ║                                                               ║
+  ║  Commandes disponibles :                                      ║
+  ║                                                               ║
+  ║    /cad-workflow:cad [description]  - Créer une story         ║
+  ║    /cad-workflow:status             - Voir l'état             ║
+  ║                                                               ║
+  ║  💡 Passer en mode Jira : /cad-workflow:jira-setup            ║
+  ║                                                               ║
+  ╚═══════════════════════════════════════════════════════════════╝
+
+post_install_message_jira: |
+
+  ╔═══════════════════════════════════════════════════════════════╗
+  ║  ✅ CAD WORKFLOW INSTALLÉ (MODE JIRA)                         ║
+  ╠═══════════════════════════════════════════════════════════════╣
+  ║                                                               ║
+  ║  Stack       : {stack}                                        ║
+  ║  Projet Jira : {jira_project_key}                             ║
+  ║                                                               ║
+  ║  Commandes disponibles :                                      ║
+  ║                                                               ║
+  ║    /cad-workflow:cad list       - Voir les tickets To Do      ║
+  ║    /cad-workflow:cad PROJ-123   - Démarrer sur un ticket      ║
+  ║    /cad-workflow:status         - Voir l'état du workflow     ║
+  ║                                                               ║
+  ║  ⚠️  Credentials Jira sauvegardés dans :                       ║
+  ║     .claude/settings.local.json (non commité)                 ║
+  ║                                                               ║
+  ╚═══════════════════════════════════════════════════════════════╝

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "cad-workflow",
+  "version": "1.1.0",
+  "description": "Clean Agentic Dev - Workflow IA avec Clean Architecture Hexagonale et TDD",
+  "bin": {
+    "cad-workflow": "bin/wrapper.js"
+  },
+  "main": "bin/cli.js",
+  "files": [
+    "bin/",
+    "src/",
+    "config/",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "enquirer": "^2.4.1",
+    "fs-extra": "^11.0.0",
+    "js-yaml": "^4.1.0",
+    "mustache": "^4.2.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "claude-code",
+    "clean-architecture",
+    "hexagonal",
+    "tdd",
+    "ai-workflow",
+    "nestjs",
+    "react-native",
+    "expo",
+    "angular"
+  ],
+  "author": "Taha K",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tahakhelifi/cad-workflow.git"
+  }
+}

package/src/base/.cad/config.yaml.tpl

@@ -0,0 +1,25 @@
+# CAD Workflow Configuration
+# Généré par create-cad-workflow
+
+project_name: "{{project_name}}"
+stack: "{{stack}}"
+mode: "{{ticket_management}}"
+
+{{#jira_project_key}}
+jira:
+  project_key: "{{jira_project_key}}"
+  transitions:
+    start: "In Progress"
+    review: "Code Review"
+    done: "Done"
+  todo_statuses:
+    - "To Do"
+    - "Backlog"
+    - "Ready for Dev"
+{{/jira_project_key}}
+
+workflow:
+  require_tests: true
+  min_coverage: {{min_coverage}}
+  min_mutation_score: {{min_mutation_score}}
+  conventional_commits: true

package/src/base/.cad/workflow-status.yaml.tpl

@@ -0,0 +1,18 @@
+# CAD Workflow Status
+initialized: true
+initialized_at: "{{timestamp}}"
+mode: "{{ticket_management}}"
+stack: "{{stack}}"
+current_phase: idle
+{{#jira_project_key}}
+current_jira_ticket: null
+{{/jira_project_key}}
+{{^jira_project_key}}
+current_story: null
+last_story_number: 0
+{{/jira_project_key}}
+
+stats:
+  completed: 0
+  total_tests: 0
+  average_coverage: 0

package/src/base/.claude/settings.local.json.tpl

@@ -0,0 +1,8 @@
+{
+  "env": {
+    "JIRA_URL": "{{{jira_url}}}",
+    "JIRA_EMAIL": "{{{jira_email}}}",
+    "JIRA_API_TOKEN": "{{{jira_token}}}",
+    "JIRA_PROJECT_KEY": "{{{jira_project_key}}}"
+  }
+}

package/src/base/CLAUDE.md

@@ -0,0 +1,69 @@
+# CAD Workflow - Clean Agentic Dev
+
+Plugin de developpement assiste par IA avec Clean Architecture Hexagonale et TDD.
+
+## Commandes disponibles
+
+| Commande | Phase | Description |
+|----------|-------|-------------|
+| `/status` | - | Afficher le status actuel du workflow |
+| `/cad` | 1-7 | Workflow complet avec validation entre chaque phase |
+| `/comprendre` | 1 | Analyse et clarification du besoin |
+| `/concevoir` | 2 | Design et plan d'implementation |
+| `/implementer` | 3 | Implementation TDD (Red-Green-Refactor) |
+| `/review` | 4 | Review code + mutation tests |
+| `/e2e` | 5 | Tests end-to-end |
+| `/documenter` | 6 | Documentation et memoire |
+| `/commit` | 7 | Formatage, linting, commit conventionnel |
+
+Reprise : `/cad continue` - Reprend le workflow interrompu
+
+## Architecture Hexagonale
+
+Les projets suivent cette structure :
+
+```
+src/
+├── domain/           # Coeur metier - AUCUNE dependance externe
+│   ├── entities/     # Entites metier
+│   ├── value-objects/
+│   ├── ports/        # Interfaces (contrats)
+│   └── errors/       # Erreurs metier typees
+├── application/      # Cas d'utilisation
+│   ├── use-cases/    # 1 classe = 1 action metier
+│   ├── dtos/         # Data Transfer Objects
+│   └── mappers/      # Entity <-> DTO
+├── infrastructure/   # Implementations techniques
+│   ├── adapters/     # Implementation des ports
+│   ├── repositories/ # Acces donnees
+│   └── services/     # Services externes
+└── presentation/     # Interface (Controllers/Components)
+```
+
+**Regle absolue** : Les imports vont TOUJOURS vers le centre (domain). Domain n'importe JAMAIS d'infrastructure.
+
+## Conventions
+
+- **Commits** : Conventionnels (feat:, fix:, refactor:, test:, docs:)
+- **Coverage** : Minimum 80%
+- **Mutation score** : Minimum 75%
+- **TypeScript** : strict mode, pas de `any`
+- **Nommage** :
+  - Use cases : `VerbNounUseCase` (ex: `CreateUserUseCase`)
+  - Ports : `INounRepository`, `INounService`
+  - Adapters : `HttpNounAdapter`, `TypeOrmNounRepository`
+
+## Avant de coder
+
+1. Lire `/status` pour connaitre l'etat du workflow
+2. Utiliser la commande de phase appropriee
+3. Toujours suivre TDD : RED -> GREEN -> REFACTOR
+4. Consulter les skills avant d'implementer
+
+## Anti-patterns a eviter
+
+- Logique metier dans les controllers/components
+- Appels HTTP directs dans le domain
+- Tests qui testent l'implementation plutot que le comportement
+- Dependances du domain vers l'exterieur
+- Code sans tests