| 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
