---
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 | ★ | <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 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: <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 l’agent.** Compare ensuite les constats avec le tableau actuel et présente :

```text
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 à 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
---

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

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

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
