Notre avis

Ajoute une nouvelle propriété à la base de données d'agents en modifiant plusieurs fichiers du projet.

Points forts

Guide pas à pas pour éviter les oublis
Couvre la mise à jour des données, de l'affichage et des templates
S'intègre à un workflow existant avec vérification
Référence un schéma central pour la cohérence

Limites

Nécessite une structure de projet spécifique (React, fichiers JSON)
Ne gère pas la validation des valeurs saisies

Quand l'utiliser

Lorsque vous devez étendre les fonctionnalités de la grille de comparaison d'agents avec un nouveau champ.

Quand l'éviter

Si le projet n'utilise pas la même architecture ou si la modification ne concerne qu'un seul agent.

Exemples

Add contextWindow property

Add a new property called 'contextWindow' to track the context window size for each agent. Use 'Context Window' as the label, display type 'text', and place it in the 'features' group.

Add badge property for multimodality

Create a new badge property 'multimodal' under 'features' group to indicate if an agent supports multimodal inputs (yes/no/partial).

name: add-agent-property description: Add a new property to the AI agents database. Use when the user wants to add, create, or introduce a new column, property, field, or feature to track across all agents in the comparison matrix. Handles all four required steps - database updates, groups.json, table display, and GitHub issue templates.

Add Agent Property

Add a new property to the agents board by modifying four files in sequence.

Schema reference: See references/schema.md for data structures.

Workflow

1. Gather Property Details

Ask the user for:

Property key (camelCase, e.g., contextWindow)
Display label (short, e.g., "Context Window")
Tooltip description (1 sentence explaining the property)
Cell type: badge (yes/no/partial) or text (free-form)
Group: identity, packaging, or features

2. Update agents-detailed.json

Add the property to every agent in src/data/agents-detailed.json:

"propertyKey": {
  "value": null,
  "detail": null
}

Insert after the last feature property, before additionalInfo.

3. Update groups.json

Add the property key to the appropriate group's columns array in src/data/groups.json:

{
  "id": "features",
  "label": "Features",
  "columns": ["existingProp", "propertyKey"]
}

4. Update AgentTable.jsx

Add column definition to the columns array in src/components/AgentTable.jsx:

{ key: 'propertyKey', label: 'Label', sortable: true, cellType: 'badge', tooltip: 'Description' }

Insert at the position matching its group order.

5. Update useAgentsData.js

Add transformation in src/hooks/useAgentsData.js:

propertyKey: agent.propertyKey.value,
propertyKeyDetail: agent.propertyKey.detail,

6. Update FilterBar.jsx (for filterable properties)

If the property is in packaging or features group and has cellType: 'badge', add it to the featureOptions array in src/components/FilterBar.jsx:

{ key: 'propertyKey', label: 'Label' }

Insert in the appropriate section (Packaging or Features) following the existing order.

7. Update GitHub Issue Templates

01-update-agent.md - Add under Features section:

- [ ] **Property Label** (`propertyKey`)
  - New value: <!-- yes/no/partial/null -->
  - Detail:

02-add-new-agent.md - Add new section with property definition, value format, and examples.

Checklist

[ ] Property added to all agents in agents-detailed.json
[ ] Property key added to correct group in groups.json
[ ] Column definition added to AgentTable.jsx
[ ] Transformation added to useAgentsData.js
[ ] Filter option added to FilterBar.jsx (if badge in packaging/features)
[ ] Update template modified in .github/ISSUE_TEMPLATE/01-update-agent.md
[ ] New agent template modified in .github/ISSUE_TEMPLATE/02-add-new-agent.md

Ajouter une propriété d'agent

Recommandé pour