crazyht-ai-process-setup

Un workflow IA de développement prêt à l'emploi : des agents et des skills (revue de code, traitement de bug/US, specs, plateforme…) projetés dans vos repos pour GitHub Copilot, Claude Code et Codex — écrits une fois, déclinés pour les trois outils.

Un seul jeu d'agents et de conventions, cohérent entre les outils et entre les repos. Vous éditez la source ; le package projette .github/agents/, .claude/, .codex/, les skills, AGENTS.md et les configs MCP.

Installation

# ponctuel, sans installer globalement
npx crazyht-ai-process-setup <commande>

# ou en devDependency d'un repo (recommandé pour la mise à jour via Renovate)
npm i -D crazyht-ai-process-setup

Node ≥ 20 requis.

Démarrage rapide — équiper un repo

Depuis la racine du repo à équiper :

npx crazyht-ai-process init-repo --types app --tools copilot,claude --stacks dotnet,react

• --types app,ops : type(s) de repo (applicatif, infra/ops) — cumulables.
• --tools copilot,claude,codex : clients IA à projeter (seuls ceux-ci sont écrits et vérifiés).
• --stacks dotnet,react : technologies (filtre les agents/skills non pertinents). Auto-détecté si omis.

Cela écrit les agents, les skills, AGENTS.md, les configs MCP, un squelette de mémoire d'équipe (.ai/memory/) et un guide d'usage (.ai/guide-usage.md — quel agent pour quelle tâche). Ouvrez ensuite le repo dans VS Code (Copilot), Claude Code ou Codex : les agents sont disponibles.

| Commande | Rôle | |---|---| | init-repo --types … --tools … | Première mise en place (écrit .ai-process.json + projette) | | apply | Régénère les fichiers projetés selon .ai-process.json | | check | Vérifie que les fichiers projetés n'ont pas dérivé (à mettre en CI) |

Les fichiers projetés sont générés : on ne les édite pas à la main. Toute évolution se fait dans le repo source du package, puis apply.

Cas d'usage

Côté développeur

| Je veux… | Agent (invoque-le par son nom dans ton outil) | |---|---| | Relire mon diff avant d'ouvrir la MR | self-review (corrige les conventions, bugs évidents, tests) | | Traiter un bug (depuis un ticket ou une cause) | jira-triage → bug-fix (reproduit, délègue le fix en TDD) | | Implémenter une User Story | us-implement (plan validé, puis implémentation en tranches TDD) |

Côté architecte / lead

| Je veux… | Agent | |---|---| | Une revue de code formelle d'une MR | architect-review (back, front, sécurité, archi, intégration, plateforme) | | Auditer un repo entier | repo-audit (rapport scoré + issues proposées) | | Chasser les bugs d'un module | bug-hunter (fan-out + contre-vérification) | | Écrire une spec technique/fonctionnelle | spec-writer | | Brainstormer une évolution | brainstorm (3 angles + synthèse) | | Rédiger des User Stories | us-writer (format INVEST, critères testables) |

Côté plateforme / DevOps (repos --types ops)

| Je veux… | Agent | |---|---| | Modifier un déploiement Helm/ArgoCD | ops-change (rendu validé, MR uniquement) | | Modifier la chaîne CI | ci-change |

Les agents suivent une doctrine commune : en cas de doute, ils posent une question (avec options, avantages/inconvénients et recommandation) au lieu de décider seuls ; les actions sortantes (MR, tickets) attendent votre validation.

Deux façons de l'utiliser

| Mode | Commande | Pour qui | |---|---|---| | Repo synchronisé | init-repo / apply / check (+ Renovate) | Les équipes : fichiers committés, à jour automatiquement, CI anti-dérive | | Local autonome | install … --full | Ceux qui veulent les agents/skills sans rien committer ni synchroniser |

Mode local autonome (--full)

Installe le jeu complet d'agents + skills dans votre profil utilisateur — disponible dans tous vos repos, rien n'est committé, aucune synchronisation :

# tout le set applicatif .NET en local
npx crazyht-ai-process-setup install --personas dev --tools claude,copilot --full --stacks dotnet

# architecte : ajoute les agents d'audit multi-repos
npx crazyht-ai-process-setup install --personas architecte --tools claude --full

• --full écrit dans ~/.claude/agents, ~/.copilot/agents, ~/.codex/agents (+ skills). Pas de .ai-process.json, pas de fichiers dans vos repos.
• Sans --full, install ne pose que le store de mémoire perso + le hook (et, pour l'architecte, les agents d'audit multi-repos).
• Idempotent ; n'écrit que dans votre profil (jamais déployé par une CI). Les choix sont mémorisés : relancer install sans argument les rejoue (mise à jour).
• memory-init / memory-reset gèrent le store de mémoire personnelle.

Le compromis : en mode local autonome, la mise à jour est manuelle (relancer install). En mode repo synchronisé, Renovate s'en charge. À vous de choisir selon que vous voulez la gouvernance d'équipe ou l'autonomie.

Mise à jour

Le repo cible déclare le package en devDependency. Avec Renovate (postUpgradeTasks → npx crazyht-ai-process apply), chaque montée de version arrive en MR contenant le bump et les fichiers régénérés. Le job CI check garantit qu'aucune copie n'a été éditée à la main.

Sous le capot

Le package embarque sa source de projection (payload/) : définitions d'agents, skills, tables de correspondance (capacités→outils, classes de modèle, stacks), templates de mémoire et configs MCP. La commande projette le sous-ensemble pertinent selon types/tools/stacks.

Licence et contributions : voir le dépôt source.