linkweb-toolkit — marketplace Codex / Claude Code de Linkweb

Marketplace auto-hébergé regroupant les plugins Codex et Claude Code maintenus par Linkweb. Ajoute le marketplace une fois, installe les plugins dont tu as besoin individuellement.

Plugins inclus

Plugin	Cible	Autonomie	Description
adonisjs-ai-doctrine	AdonisJS v7	Autonome	Doctrine fail-closed pour les applications privées : Inertia v3 pour les nouvelles apps React, migration guidée v2 → v3, et stack mobile Tuyau + TanStack Query.
branch-guard	Tout repo git	Autonome	Skill auto-déclenché branch-guard : interdit le développement direct sur main, garde la branche cohérente avec le scope, et crée une branche métier depuis detached HEAD avant commit. Forge-agnostique.
commit-style	Tout repo git	Autonome	Skill commit-style + hook PreToolUse : Conventional Commits, sujet < 70 chars, body optionnel et compact, blocage des git commit bruts. Forge-agnostique.
forgejo-issue-findings	Issues Forgejo	Autonome	Crée des Issues de findings avec une clé stable ou résout une Issue par clé/URL avec le login tea du remote courant. Toute instance Forgejo compatible avec tea.
workflow	Workflow Linkweb (Forgejo)	Dépend d'agent-review et pr-review pour /pr, et d'adonisjs-ai-doctrine pour les créations AdonisJS	Slash commands pour scaffold AdonisJS, initialiser Git/Forgejo et ouvrir une PR via tea après Agent Review obligatoire.
release-flow	Tout repo git avec main/production	Autonome	Skill auto-déclenché qui inspecte la documentation, merge vers main, fast-forward production et gère les déploiements automatiques ou manuels confirmés.
adonisjs-doctrine-code-review	PR / diff AdonisJS v7	Dépend de adonisjs-ai-doctrine	Commande /adonisjs-review + sous-agent read-only pour revue doctrine, bugs, auth/scope, protection des données, rapport PR structuré, puis demande de confirmation avant publication.
agent-review	Branches / diffs locaux	Autonome	Entrée $agent-review (ou /agent-review) avec un sous-agent neutre unique, modèle adaptable à la demande, GPT-6 Astra/high par défaut et lecture seule.
pr-review	PR Forgejo	Dépend d'agent-review	Commande /pr-review et skill auto-déclenché pour merger après une demande explicite; nettoyage local après validation finale.
pilotage	Pilotage local	Dépend de agent-review selon l'étape	Commande /pilotage pour conduire cadrage, plan d'implémentation, missions, lots, revue, intégration et preuve d'usage en français courant.

Installation Codex

Le marketplace Codex vit dans .agents/plugins/marketplace.json. Depuis ce repo, Codex peut le détecter comme marketplace repo-scoped après redémarrage. Pour l'enregistrer explicitement depuis un clone local :

codex plugin marketplace add /chemin/vers/linkweb-ai-toolkit

Pour l'ajouter depuis le dépôt git :

codex plugin marketplace add https://git.linkweb.fr/linkweb-public/linkweb-ai-toolkit.git

Ensuite ouvre /plugins dans Codex, sélectionne Linkweb Toolkit, puis installe les plugins voulus.

Agents Codex

Les wrappers sous .codex/agents/ sont des rôles locaux du dépôt, générés depuis les contrats plugins/.../agents/. Codex ne charge pas ces wrappers depuis le cache d'un plugin installé : les agents personnalisés sont des fichiers autonomes, soit projet-scoped dans .codex/agents/, soit personnels dans CODEX_HOME/agents/.

Pour utiliser agent-reviewer depuis un autre dépôt après l'installation du plugin, exécute l'installateur distribué par le plugin :

node /chemin/vers/agent-review/scripts/install-codex-agent.mjs

Il installe un wrapper personnel autonome avec le contrat embarqué et le sandbox read-only, sans modèle ni effort figés. Le skill transmet le modèle demandé au lancement du sous-agent et utilise gpt-6-astra avec high par défaut. Redémarre la session Codex après l'installation. Le checkout de ce toolkit charge directement ses wrappers projet-local ; l'installateur n'est nécessaire que pour le scope personnel ou un autre dépôt.

Sans wrapper chargé, le chemin délégué de agent-review et le workflow /pr restent volontairement bloqués sans leur reviewer neutre, car une revue parente ne constitue pas un remplacement sûr ; seule une demande explicite de revue directe peut autoriser le parent.

Installation Claude Code

Dans Claude Code, ajoute le marketplace une fois :

/plugin marketplace add https://git.linkweb.fr/linkweb-public/linkweb-ai-toolkit.git

Cas 1 — tu utilises seulement la doctrine AdonisJS (général, pas Linkweb-spécifique)

/plugin install adonisjs-ai-doctrine@linkweb-toolkit

adonisjs-ai-doctrine est autonome.

Cas 1b — tu veux reviewer des PR AdonisJS

/plugin install adonisjs-ai-doctrine@linkweb-toolkit
/plugin install adonisjs-doctrine-code-review@linkweb-toolkit

Utilise ensuite /adonisjs-review, avec une URL de PR, une branche, une plage base...head, ou sans argument pour revoir le diff courant.

Cas 1c — tu veux reviewer une branche ou un diff local

/plugin install agent-review@linkweb-toolkit

Demande ensuite une revue du diff courant, d'une branche ou de main...feature/auth-hardening.

Cas 1c bis — tu veux reviewer une PR Forgejo

/plugin install agent-review@linkweb-toolkit
/plugin install pr-review@linkweb-toolkit

Utilise ensuite /pr-review #42 : la commande infère automatiquement une revue initiale, un rappel de statut ou un follow-up. Réserve /pr-review --fresh #42 aux nouvelles revues complètes explicitement souhaitées.

Cas 1e — tu veux piloter un travail local sans apprendre plusieurs commandes

/plugin install agent-review@linkweb-toolkit
/plugin install pilotage@linkweb-toolkit

Utilise ensuite /pilotage. La commande conduit les trois étapes cadrage, plan d'implémentation et implémentation, puis les missions, les lots, la revue, l'intégration et la preuve d'usage avec un retour court en français.

Cas 2 — tu travailles sur des projets Linkweb (Forgejo + VPS + AdonisJS)

Installe le pack complet :

/plugin install adonisjs-ai-doctrine@linkweb-toolkit
/plugin install branch-guard@linkweb-toolkit
/plugin install commit-style@linkweb-toolkit
/plugin install workflow@linkweb-toolkit
/plugin install forgejo-issue-findings@linkweb-toolkit
/plugin install release-flow@linkweb-toolkit
/plugin install agent-review@linkweb-toolkit
/plugin install pr-review@linkweb-toolkit
/plugin install pilotage@linkweb-toolkit

workflow hard-dépend d'agent-review et de pr-review pour /pr : le premier fournit la revue locale déléguée, le second le garde Forgejo post-création. Il hard-dépend aussi d'adonisjs-ai-doctrine pour les workflows de création de projet (Linkweb projects = AdonisJS, par convention) : /init-adonisjs et /new-project refusent net si la doctrine n'est pas installée.

Cas 3 — tu veux mettre un projet en production

Installe release-flow dans le projet concerné :

/plugin install release-flow@linkweb-toolkit

Le skill lit d'abord la documentation du projet, puis applique la promotion main → production et demande une confirmation pour une procédure manuelle.

Cas 4 — tu veux juste la discipline branche/commit sur un repo non-Linkweb

/plugin install branch-guard@linkweb-toolkit
/plugin install commit-style@linkweb-toolkit

Les deux skills sont indépendants et forge-agnostiques. Installe celui qui te parle, ou les deux.

Mise à jour

/plugin marketplace update

Met à jour la définition du marketplace ; les plugins installés sont ensuite resynchronisés.

Désinstallation

/plugin uninstall workflow
/plugin uninstall branch-guard
/plugin uninstall commit-style
/plugin uninstall forgejo-issue-findings
/plugin uninstall release-flow
/plugin uninstall adonisjs-doctrine-code-review
/plugin uninstall agent-review
/plugin uninstall pr-review
/plugin uninstall pilotage
/plugin uninstall adonisjs-ai-doctrine
/plugin marketplace remove linkweb-toolkit

Layout du repo

linkweb-ai-toolkit/
├── .agents/
│   └── plugins/marketplace.json  # marketplace Codex repo-scoped
├── .claude-plugin/
│   └── marketplace.json          # marketplace Claude umbrella
├── .codex/
│   └── agents/                   # wrappers Codex des sous-agents historiques
├── plugins/
│   ├── branch-guard/             # skill branch-guard (forge-agnostic)
│   │   ├── .codex-plugin/plugin.json
│   │   ├── .claude-plugin/plugin.json
│   │   ├── skills/
│   │   └── README.md
│   ├── commit-style/             # skill commit-style (forge-agnostic)
│   │   ├── .codex-plugin/plugin.json
│   │   ├── .claude-plugin/plugin.json
│   │   ├── skills/
│   │   └── README.md
│   ├── workflow/                 # scaffold + init Forgejo + PR avec Agent Review
│   │   ├── .codex-plugin/plugin.json
│   │   ├── .claude-plugin/plugin.json
│   │   ├── commands/  skills/  examples/
│   │   └── README.md
│   ├── release-flow/             # promotion main → production et déploiement documenté
│   │   ├── .codex-plugin/plugin.json
│   │   ├── .claude-plugin/plugin.json
│   │   ├── skills/
│   │   └── README.md
│   ├── adonisjs-ai-doctrine/     # doctrine AdonisJS v7 + migration Inertia v2 → v3
│   │   ├── .codex-plugin/plugin.json
│   │   ├── .claude-plugin/plugin.json
│   │   ├── skills/
│   │   └── README.md
│   ├── adonisjs-doctrine-code-review/ # reviewer PR/diff AdonisJS v7
│   │   ├── .codex-plugin/plugin.json
│   │   ├── .claude-plugin/plugin.json
│   │   ├── commands/  skills/  agents/
│   │   └── README.md
│   ├── agent-review/             # revue générique locale
│   │   ├── .codex-plugin/plugin.json
│   │   ├── .claude-plugin/plugin.json
│   │   ├── skills/  agents/
│   │   └── README.md
│   ├── pr-review/                # revue de PR Forgejo
│   │   ├── .codex-plugin/plugin.json
│   │   ├── .claude-plugin/plugin.json
│   │   ├── commands/  references/  scripts/
│   │   └── README.md
│   └── pilotage/                 # pilotage local cadrage/chantiers/lots
│       ├── .codex-plugin/plugin.json
│       ├── .claude-plugin/plugin.json
│       ├── commands/  skills/
│       └── README.md
└── README.md                     # ce fichier

Développement local

Surfaces générées

Les manifests Claude/Codex, la marketplace Codex et les wrappers .codex/agents/*.toml sont décrits dans scripts/generate-surfaces.ts.

npm run surfaces:check  # vérifie que les fichiers générés sont synchrones
npm run surfaces:write  # régénère les surfaces depuis le TypeScript

Les fichiers générés restent commités pour que Codex et Claude puissent installer le repo sans étape de build.

Codex :

codex plugin marketplace add /Users/olivier/Developer/linkweb-ai-toolkit

Puis installe ou réinstalle depuis /plugins.

Claude Code :

Pour tester un plugin sans passer par le marketplace :

claude --plugin-dir /Users/olivier/Developer/linkweb-ai-toolkit/plugins/branch-guard
claude --plugin-dir /Users/olivier/Developer/linkweb-ai-toolkit/plugins/commit-style
claude --plugin-dir /Users/olivier/Developer/linkweb-ai-toolkit/plugins/workflow
claude --plugin-dir /Users/olivier/Developer/linkweb-ai-toolkit/plugins/release-flow
claude --plugin-dir /Users/olivier/Developer/linkweb-ai-toolkit/plugins/adonisjs-ai-doctrine
claude --plugin-dir /Users/olivier/Developer/linkweb-ai-toolkit/plugins/adonisjs-doctrine-code-review
claude --plugin-dir /Users/olivier/Developer/linkweb-ai-toolkit/plugins/agent-review
claude --plugin-dir /Users/olivier/Developer/linkweb-ai-toolkit/plugins/pr-review
claude --plugin-dir /Users/olivier/Developer/linkweb-ai-toolkit/plugins/pilotage

Une fois validé, commit + push. Côté Codex, relance codex plugin marketplace upgrade linkweb-toolkit ou réinstalle depuis /plugins. Côté Claude Code, lance /plugin marketplace update.

Contribuer / dev

Chaque plugin est documenté dans son propre README.md et MAINTENANCE.md quand applicable.