Skip to content

Commit f5a6efb

Browse files
marcusgollclaude
andcommitted
chore: release v6.4.0
Major Updates: - CLI Integration: 15 new commands added to spec-cli.py (39 total) - Living Documentation commands (generate-feature-claude, health-check-docs, etc.) - Project Management (init-project, roadmap, design-health) - Epic/Sprint management, Quality gates, Metrics tracking - Design System Integration: Complete workflow with automated quality checks - design-scout agent: Component reuse enforcement (85%+ target) - design-lint agent: Automated WCAG 2.1 AA compliance checking - Multi-screen mockup infrastructure with keyboard navigation - design-health-check.sh: 7 health checks for system monitoring - Infrastructure: Scheduler, fixture refresh, DORA metrics commands Files Changed: - spec-cli.py: +316 lines (19→39 commands, --json flag refactoring) - New agents: design-scout.md (574 lines), design-lint.md (462 lines) - New scripts: design-health-check.sh (298 lines) - New templates: Multi-screen mockup infrastructure - Updated: 10 phase command workflows, CHANGELOG.md, README.md - Added *.backup to .gitignore Release: v6.4.0 🤖 Generated with Claude Code (https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 717af41 commit f5a6efb

File tree

29 files changed

+8447
-6486
lines changed

29 files changed

+8447
-6486
lines changed

.claude/agents/implementation/frontend.md

Lines changed: 94 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1638,6 +1638,100 @@ git restore .
16381638
- Provide coverage delta (e.g., "+6%" means coverage increased by 6%)
16391639
- Log failures with enough detail for debugging
16401640

1641+
5. **Update living documentation** (if new components created):
1642+
1643+
**When you create new UI components** (shadcn/ui primitives or custom components):
1644+
- Automatically update `design/systems/ui-inventory.md`
1645+
- Document component name, props, usage examples
1646+
- Include accessibility features (WCAG 2.1 AA compliance)
1647+
- Add link to component file location
1648+
1649+
**UI Inventory Update Template:**
1650+
1651+
```markdown
1652+
### {ComponentName}
1653+
1654+
**Source**: {file_path}
1655+
**Type**: {shadcn/ui primitive | custom component}
1656+
**Props**: {key props list}
1657+
**States**: {default, hover, focus, disabled, loading, error}
1658+
**Accessibility**: {ARIA labels, keyboard navigation, screen reader support}
1659+
**Usage**:
1660+
```tsx
1661+
import { {ComponentName} } from '@/components/ui/{component-name}'
1662+
1663+
<{ComponentName} {prop}="{value}" />
1664+
```
1665+
1666+
**Examples**:
1667+
- {Example 1 description}: {file_path}:{line_number}
1668+
- {Example 2 description}: {file_path}:{line_number}
1669+
1670+
**Related Components**: {List related components from inventory}
1671+
```
1672+
1673+
**Auto-update process:**
1674+
1675+
```bash
1676+
# After creating new component in components/ui/button.tsx
1677+
# Append to ui-inventory.md
1678+
1679+
cat >> design/systems/ui-inventory.md <<'EOF'
1680+
1681+
### Button
1682+
1683+
**Source**: components/ui/button.tsx
1684+
**Type**: shadcn/ui primitive
1685+
**Props**: variant (default|destructive|outline|secondary|ghost|link), size (default|sm|lg|icon), asChild
1686+
**States**: default, hover, focus, disabled, loading
1687+
**Accessibility**: Semantic <button> element, keyboard accessible (Enter/Space), focus indicator visible
1688+
**Usage**:
1689+
```tsx
1690+
import { Button } from '@/components/ui/button'
1691+
1692+
<Button variant="default">Click me</Button>
1693+
<Button variant="outline" size="sm">Small</Button>
1694+
<Button disabled>Disabled</Button>
1695+
```
1696+
1697+
**Examples**:
1698+
- Primary CTA: app/components/LoginForm.tsx:45
1699+
- Secondary action: app/components/SettingsPage.tsx:89
1700+
1701+
**Related Components**: Link, IconButton
1702+
EOF
1703+
1704+
# Commit documentation update
1705+
git add design/systems/ui-inventory.md
1706+
git commit -m "docs: add Button component to ui-inventory
1707+
1708+
Component: Button (shadcn/ui primitive)
1709+
Features: 5 variants, 4 sizes, accessible
1710+
Location: components/ui/button.tsx"
1711+
```
1712+
1713+
**Living documentation principles:**
1714+
- Update inventory **immediately** after component creation (same commit or next)
1715+
- Include **real usage examples** from actual feature files
1716+
- Document **accessibility features** explicitly (ARIA, keyboard nav, focus)
1717+
- Link **related components** to encourage composition over duplication
1718+
- Keep inventory **fresh** (<24 hours lag between creation and documentation)
1719+
1720+
**Skip documentation if:**
1721+
- Component is a one-off (not reusable across features)
1722+
- Component is private to a single feature (in app/ not components/ui/)
1723+
- Component is a layout wrapper (Grid, Container, Stack - too generic)
1724+
1725+
**Component Reuse Enforcement:**
1726+
- Before creating new componentCheck ui-inventory.md first
1727+
- If similar component existsExtend it instead of duplicating
1728+
- If truly novelDocument in inventory for future reuse
1729+
1730+
**Metrics tracked:**
1731+
- Component reuse rate: 85%+ target
1732+
- Inventory freshness: <24 hours lag
1733+
- Documentation coverage: 100% of reusable components
1734+
16411735
## Git Workflow (MANDATORY)
16421736

16431737
**Every meaningful change MUST be committed for rollback safety.**

0 commit comments

Comments
 (0)