version: "1.0.1" 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