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	Fail-closed multi-agent skill pack pour les applications AdonisJS v7 privées. Force une structure déterministe et framework-native.
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.
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.
guardrails	Tout repo git	Autonome	Hook PreToolUse qui bloque tout git push mettant à jour main sur le remote. Plugin séparé pour pouvoir être désinstallé ponctuellement par les responsables de projet.
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	Skill de revue générique déléguant à un sous-agent neutre unique.
pr-review	PR Forgejo	Dépend d'agent-review	Commande /pr-review : revue directe dans la conversation, rapport et mutations Forgejo protégés par SHA.
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/. Un test d'installation Codex dans un environnement vierge (2026-07-30) confirme que l'installation d'un plugin copie ses composants déclarés dans le cache, mais n'installe pas ces wrappers et ne conserve pas leurs contrats d'agent. Ne les invoque donc pas depuis une installation de plugin seule.

Les skills restent le chemin distribué : commit-style applique directement sa convention quand commit-writer n'est pas disponible ; 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.

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 guardrails@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 es responsable de projet et veux pouvoir pousser sur main ponctuellement

Skip guardrails (ou désinstalle-le au moment du push) — et optionnellement skip branch-guard si tu veux pouvoir éditer directement sur main :

/plugin uninstall guardrails
# push sur main
/plugin install guardrails@linkweb-toolkit

C'est précisément pour ce cas d'usage que les garde-fous sont isolés dans leurs propres plugins.

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 guardrails
/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
│   ├── guardrails/               # hook anti-push-sur-main
│   │   ├── .codex-plugin/plugin.json
│   │   ├── .claude-plugin/plugin.json
│   │   ├── hooks/
│   │   └── README.md
│   ├── adonisjs-ai-doctrine/     # doctrine AdonisJS v7
│   │   ├── .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/guardrails
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.