159 lines
7.2 KiB
Markdown
159 lines
7.2 KiB
Markdown
---
|
||
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
|