--- description: Mettre à jour le tableau AGENT COLLECTIONS en recherchant tous les dépôts de collections d’agents 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 d’agents sont découverts, ajoute-les ici ET au prompt de recherche en Phase 1. --- ## Format du tableau Le tableau README a ces colonnes : ```markdown | Name | ★ | | ``` - **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 d’agents** : 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é d’abord). --- ## Phase 0 : lire l’état actuel Lis ces fichiers : 1. `README.md` — le tableau `## 🤖 AGENT COLLECTIONS` (noter les étoiles et nombres d’agents 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 l’agent de recherche **Immédiatement**, lance un `development-workflows-research-agent` couvrant tous les dépôts. (L’agent de recherche existant est générique — il compte agents/skills/commandes/étoiles pour n’importe 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: k () > AGENTS: () > NOTES: > CHANGES: > CONFIDENCE: <0-1> > ``` --- ## Phase 2 : comparer et rapporter **Attends l’agent.** Compare ensuite les constats avec le tableau actuel et présente : ```text Agent Collections — Update Report ══════════════════════════════════ Changes Found: : ★ k → k | agents ... No Changes: : ✓ (all values match) ... Action Items: # | Type | Action | Status 1 | Star | Update ★ from Xk to Yk | NEW/RECURRING 2 | Count | Update agents from X to Y | NEW/RECURRING 3 | Sort | Move (rank changed) | NEW/RECURRING 4 | Add | New collection candidate: | 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 à l’utilisateur. Lis `changelog/agent-collections/changelog.md`, puis **ajoute** une nouvelle entrée. Si le fichier n’existe pas, crée-le avec une Status Legend puis la première entrée. ```markdown --- ## [] Agent Collections Update | # | Priority | Type | Action | Status | |---|----------|------|--------|--------| | 1 | HIGH/MED/LOW | | | | ``` Obtiens l’heure via `TZ=Asia/Karachi date "+%Y-%m-%d %I:%M %p PKT"`. Le statut doit être l’un 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 l’heure 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 à l’utilisateur : **(1) Execute all** | **(2) Execute specific** | **(3) Skip** Pendant l’exécution, modifie le tableau `## 🤖 AGENT COLLECTIONS` dans `README.md` : - Mettre à jour les étoiles et nombres d’agents par ligne - Maintenir l’ordre de tri : étoiles décroissantes (le plus élevé d’abord) - 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 à l’intérieur 2. **Ne jamais deviner** — utiliser uniquement les données de l’agent 3. **Ne pas auto-exécuter** — présenter le rapport d’abord, 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 d’abord 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