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.
linkweb-branch-guard	Tout repo git	Autonome	Skill auto-déclenché branch-guard : interdit le développement direct sur main et garde la branche cohérente avec le scope (STAY / NEW BRANCH / RENAME). Forge-agnostique.
linkweb-commit-style	Tout repo git	Autonome	Skill auto-déclenché commit-style : Conventional Commits, sujet < 70 chars, body optionnel et compact. Forge-agnostique.
linkweb-fr-locale	Toutes sessions	Autonome	Hook SessionStart qui injecte une directive « réponds en français ». Optionnel ; à désinstaller pour les contextes anglo.
linkweb-workflow	Workflow Linkweb (Forgejo + VPS)	Hard-dep sur adonisjs-ai-doctrine	Slash commands pour scaffold AdonisJS, push dev (rsync + Docker sur VPS), push prod (PR via tea sur git.linkweb.fr).
linkweb-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.
linkweb-ui-verify	AdonisJS + Inertia React + Mantine	Autonome	Hook Stop qui demande à l'agent de lancer /verify-ui après une modif UI. Skill qui navigue les routes via le navigateur Codex/Claude disponible et applique 3 heuristiques (texte parasite, page brute, console errors). Stack opinionated.
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.
multi-pr-review	PR Forgejo / branches / diffs	Autonome	Commande /review-prs + coordinateurs isolés par cible pour reviewer une ou plusieurs PRs, publier un seul rapport via tea comment, puis proposer merge et nettoyage après confirmations.

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/claude-toolkit

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

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

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

Installation Claude Code

Dans Claude Code, ajoute le marketplace une fois :

/plugin marketplace add https://git.linkweb.fr/linkweb-public/claude-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 ou plusieurs PRs Forgejo

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

Utilise ensuite /review-prs #42, /review-prs #42 #43, ou /review-prs --follow-up #42.

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

Installe le pack complet :

/plugin install adonisjs-ai-doctrine@linkweb-toolkit
/plugin install linkweb-branch-guard@linkweb-toolkit
/plugin install linkweb-commit-style@linkweb-toolkit
/plugin install linkweb-fr-locale@linkweb-toolkit
/plugin install linkweb-workflow@linkweb-toolkit
/plugin install linkweb-guardrails@linkweb-toolkit
/plugin install linkweb-ui-verify@linkweb-toolkit

linkweb-workflow hard-dépend 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 linkweb-guardrails (ou désinstalle-le au moment du push) — et optionnellement skip linkweb-branch-guard si tu veux pouvoir éditer directement sur main :

/plugin uninstall linkweb-guardrails
# push sur main
/plugin install linkweb-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 linkweb-branch-guard@linkweb-toolkit
/plugin install linkweb-commit-style@linkweb-toolkit

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

Cas 5 — tu veux vérifier le rendu UI à la fin d'un tour d'agent

/plugin install linkweb-ui-verify@linkweb-toolkit

Au premier usage dans un projet Codex : copie examples/verify-ui.config.json.example vers .agents/verify-ui.config.json si tu as besoin d'overrides. Sans config, les routes sont auto-déduites. Pré-requis machine : Browser Codex disponible, ou fallback Claude in Chrome / Preview MCP.

Cas 6 — tu veux la directive « réponds en français » dans toutes tes sessions

/plugin install linkweb-fr-locale@linkweb-toolkit

Le hook SessionStart injecte une directive courte qui demande à Codex ou Claude de communiquer en français. À désinstaller si tu travailles en anglais.

Mise à jour

/plugin marketplace update

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

Désinstallation

/plugin uninstall linkweb-workflow
/plugin uninstall linkweb-branch-guard
/plugin uninstall linkweb-commit-style
/plugin uninstall linkweb-fr-locale
/plugin uninstall linkweb-guardrails
/plugin uninstall linkweb-ui-verify
/plugin uninstall adonisjs-doctrine-code-review
/plugin uninstall multi-pr-review
/plugin uninstall adonisjs-ai-doctrine
/plugin marketplace remove linkweb-toolkit

Layout du repo

claude-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/
│   ├── linkweb-branch-guard/     # skill branch-guard (forge-agnostic)
│   │   ├── .codex-plugin/plugin.json
│   │   ├── .claude-plugin/plugin.json
│   │   ├── skills/
│   │   └── README.md
│   ├── linkweb-commit-style/     # skill commit-style (forge-agnostic)
│   │   ├── .codex-plugin/plugin.json
│   │   ├── .claude-plugin/plugin.json
│   │   ├── skills/
│   │   └── README.md
│   ├── linkweb-fr-locale/        # hook SessionStart directive FR
│   │   ├── .codex-plugin/plugin.json
│   │   ├── .claude-plugin/plugin.json
│   │   ├── hooks/
│   │   └── README.md
│   ├── linkweb-workflow/         # scaffold + push dev/prod (Forgejo + VPS)
│   │   ├── .codex-plugin/plugin.json
│   │   ├── .claude-plugin/plugin.json
│   │   ├── commands/  skills/  examples/
│   │   └── README.md
│   ├── linkweb-guardrails/       # hook anti-push-sur-main
│   │   ├── .codex-plugin/plugin.json
│   │   ├── .claude-plugin/plugin.json
│   │   ├── hooks/
│   │   └── README.md
│   ├── linkweb-ui-verify/        # smoke test UI heuristique
│   │   ├── .codex-plugin/plugin.json
│   │   ├── .claude-plugin/plugin.json
│   │   ├── hooks/  skills/  commands/  examples/
│   │   └── 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
│   └── multi-pr-review/          # revue multi-agent PR/branches/diffs
│       ├── .codex-plugin/plugin.json
│       ├── .claude-plugin/plugin.json
│       ├── commands/  skills/  agents/
│       └── 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/claude-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/claude-toolkit/plugins/linkweb-branch-guard
claude --plugin-dir /Users/olivier/Developer/claude-toolkit/plugins/linkweb-commit-style
claude --plugin-dir /Users/olivier/Developer/claude-toolkit/plugins/linkweb-fr-locale
claude --plugin-dir /Users/olivier/Developer/claude-toolkit/plugins/linkweb-workflow
claude --plugin-dir /Users/olivier/Developer/claude-toolkit/plugins/linkweb-guardrails
claude --plugin-dir /Users/olivier/Developer/claude-toolkit/plugins/linkweb-ui-verify
claude --plugin-dir /Users/olivier/Developer/claude-toolkit/plugins/adonisjs-ai-doctrine
claude --plugin-dir /Users/olivier/Developer/claude-toolkit/plugins/adonisjs-doctrine-code-review
claude --plugin-dir /Users/olivier/Developer/claude-toolkit/plugins/multi-pr-review

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.