Files
claude-code-best-practice/fr/.claude/commands/workflows/agent-collections.md
T
2026-06-02 23:24:21 +02:00

7.2 KiB
Raw Blame History

description
description
Mettre à jour le tableau AGENT COLLECTIONS en recherchant tous les dépôts de collections dagents en parallèle

Workflow — Agent Collections

Mets à jour le tableau AGENT COLLECTIONS dans README.md en recherchant les dépôts listés en parallèle. Lance un agent de recherche, fusionne les résultats, présente les changements et mets le tableau à jour si approuvé.


Les dépôts

# Repo Owner
1 msitarzewski/agency-agents msitarzewski
2 VoltAgent/awesome-claude-code-subagents VoltAgent (curated awesome-list)

Lorsque de nouveaux dépôts de collections dagents sont découverts, ajoute-les ici ET au prompt de recherche en Phase 1.


Format du tableau

Le tableau README a ces colonnes :

| Name | ★ | <img src="!/tags/a.svg" height="14"> |
  • Name : [Short Name](github-url) — utilise le nom court reconnaissable du dépôt (par exemple msitarzewski/agency-agents, awesome-claude-code-subagents). Utilise le owner/repo complet uniquement si le nom seul est ambigu.
  • : nombre d’étoiles arrondi en k (par exemple 92k, 19k, 1.2k). Sous 1000, affiche le nombre exact.
  • Nombre dagents : seulement le nombre. Pour les awesome-lists où les agents sont des liens et non des fichiers, utilise la forme N+ (curated list).

Ordre de tri : trié par étoiles décroissantes (le plus élevé dabord).


Phase 0 : lire l’état actuel

Lis ces fichiers :

  1. README.md — le tableau ## 🤖 AGENT COLLECTIONS (noter les étoiles et nombres dagents actuels)
  2. changelog/agent-collections/changelog.md — entrées de changelog précédentes (peut ne pas encore exister — le créer à la première exécution)

Phase 1 : lancer lagent de recherche

Immédiatement, lance un development-workflows-research-agent couvrant tous les dépôts. (Lagent de recherche existant est générique — il compte agents/skills/commandes/étoiles pour nimporte quel dépôt.)

Research these Claude Code agent-collection repositories. Each is primarily a library of subagent definition files (.md files defining agents), NOT a full workflow methodology.

Repo 1: msitarzewski/agency-agents (https://github.com/msitarzewski/agency-agents) — agency-style subagent collection Repo 2: VoltAgent/awesome-claude-code-subagents (https://github.com/VoltAgent/awesome-claude-code-subagents) — curated awesome-list (links to external subagents, not all agents are stored as files in the repo)

For EACH repo, return:

  1. Stars — use GitHub API https://api.github.com/repos/{owner}/{repo}, read stargazers_count. Round to k.
  2. Agent count — count subagent definition .md files via the GitHub git tree API: https://api.github.com/repos/{owner}/{repo}/git/trees/HEAD?recursive=1 and grep paths under conventional agent directories.
    • For msitarzewski/agency-agents: agents typically live under agents/, .claude/agents/, or category subdirectories. Count .md files that look like subagent definitions (frontmatter with name: and description:). Exclude README/CHANGELOG/LICENSE/docs.
    • For VoltAgent/awesome-claude-code-subagents: count the listed agents in README.md (e.g., bullets / table rows linking to external repos). Mark explicitly as "curated list, not files in repo".
    • If a repo has both a curated index AND its own agent files, report both numbers and explain.
  3. Notable changes — any significant additions or removals in the last 30 days?

Return structured report per repo:

REPO: msitarzewski/agency-agents
STARS: <number>k (<exact>)
AGENTS: <count> (<file pattern used, e.g., ".md files under agents/ via git tree">)
NOTES: <anything unusual — flat layout vs categorized, README-only catalog, deprecated agents, curated-list disclaimer>
CHANGES: <changes or "No significant changes">
CONFIDENCE: <0-1>

Phase 2 : comparer et rapporter

Attends lagent. Compare ensuite les constats avec le tableau actuel et présente :

Agent Collections — Update Report
══════════════════════════════════

Changes Found:
  <repo>: ★ <old>k → <new>k | agents <old>→<new>
  ...

No Changes:
  <repo>: ✓ (all values match)
  ...

Action Items:
#  | Type   | Action                              | Status
1  | Star   | Update <repo> ★ from Xk to Yk       | NEW/RECURRING
2  | Count  | Update <repo> agents from X to Y    | NEW/RECURRING
3  | Sort   | Move <repo> (rank changed)          | NEW/RECURRING
4  | Add    | New collection candidate: <repo>     | NEW

Compare avec les entrées précédentes du changelog et marque les éléments NEW, RECURRING ou RESOLVED.


Phase 2.5 : ajouter au changelog

OBLIGATOIRE — toujours exécuter avant de présenter à lutilisateur.

Lis changelog/agent-collections/changelog.md, puis ajoute une nouvelle entrée. Si le fichier nexiste pas, crée-le avec une Status Legend puis la première entrée.

---

## [<YYYY-MM-DD HH:MM AM/PM PKT>] Agent Collections Update

| # | Priority | Type | Action | Status |
|---|----------|------|--------|--------|
| 1 | HIGH/MED/LOW | <type> | <action> | <status> |

Obtiens lheure via TZ=Asia/Karachi date "+%Y-%m-%d %I:%M %p PKT". Le statut doit être lun de :

  • COMPLETE (reason) | INVALID (reason) | ON HOLD (reason)

Toujours ajouter, ne jamais écraser.


Phase 2.6 : mettre à jour le badge Last Updated

OBLIGATOIRE — exécuter après la Phase 2.5.

Mets à jour le badge de la ligne 4 de README.md. Obtiens lheure via TZ=Asia/Karachi date "+%b %d, %Y %-I:%M %p PKT", encode-la pour URL et remplace la date dans le badge. Ne journalise PAS cela comme action item.


Phase 3 : exécuter

Demande à lutilisateur : (1) Execute all | (2) Execute specific | (3) Skip

Pendant lexécution, modifie le tableau ## 🤖 AGENT COLLECTIONS dans README.md :

  • Mettre à jour les étoiles et nombres dagents par ligne
  • Maintenir lordre de tri : étoiles décroissantes (le plus élevé dabord)
  • Respecter exactement le format existant (style des liens, suffixe k sur les étoiles)

Règles

  1. Un agent de recherche, tous les dépôts — message unique, sous-récupérations parallèles à lintérieur
  2. Ne jamais deviner — utiliser uniquement les données de lagent
  3. Ne pas auto-exécuter — présenter le rapport dabord, attendre approbation
  4. TOUJOURS ajouter au changelog et TOUJOURS mettre à jour le badge — obligatoire
  5. Trier par étoiles décroissantes — plus grand nombre d’étoiles dabord
  6. Arrondir les étoiles de façon cohérente — suffixe k (92k, 19k, 1.2k). Sous 1000, afficher le nombre exact
  7. Les awesome-lists sont différentes — pour les dépôts qui lient vers des agents externes (VoltAgent), le nombre est "items listed in README", pas les fichiers du dépôt ; toujours annoter (curated list)
  8. Comparer avec le changelog précédent — marquer les éléments NEW, RECURRING ou RESOLVED
  9. Réutiliser development-workflows-research-agent — ne PAS créer de nouvel agent