From 27b038f2510693300de7023c19f12b1468cf6d65 Mon Sep 17 00:00:00 2001 From: Paul Mulligan Date: Fri, 23 Oct 2026 12:59:40 -0400 Subject: [PATCH 1/6] chore(claude): remove the Aurelius React pack and the Maecenas marketing import The extension is not a React app framework and marketing runs from the Maecenas repo, yet 71 agents, 22 skills, 12 legacy commands, three dead positional-argument hooks, the agent guides, the starter templates, the React-pack and marketing helper scripts and the figma-to-react and react-development docs were all carried here (audit of 2026-10-13, #77). Only scripts/build-docs-site.mjs stays; brand-guidelines.json and the store assets are untouched. The brand-voice reference now points at the lint in Maecenas. Co-Authored-By: Claude Fable 5.1 --- .claude/AGENT-NAMING-GUIDE.md | 40 - .claude/CUSTOM-AGENTS-GUIDE.md | 166 ---- .claude/PLUGINS-REFERENCE.md | 134 --- .claude/agents/accessibility-auditor.md | 133 --- .claude/agents/agent-expert.md | 479 ---------- .claude/agents/ai-engineer.md | 100 -- .claude/agents/analytics-reporter.md | 180 ---- .claude/agents/api-tester.md | 190 ---- .claude/agents/app-store-optimizer.md | 156 --- .claude/agents/art-director.md | 154 --- .claude/agents/asset-cataloger.md | 120 --- .claude/agents/attribution-analyst.md | 134 --- .claude/agents/backend-architect.md | 91 -- .claude/agents/blog-writer.md | 126 --- .claude/agents/brand-compliance-checker.md | 129 --- .claude/agents/brand-guardian.md | 254 ----- .claude/agents/brand-strategist.md | 126 --- .claude/agents/budget-planner.md | 177 ---- .claude/agents/campaign-producer.md | 129 --- .claude/agents/command-expert.md | 423 --------- .claude/agents/competitive-analyst.md | 133 --- .claude/agents/content-creator.md | 175 ---- .claude/agents/content-strategist.md | 122 --- .claude/agents/conversion-optimizer.md | 133 --- .claude/agents/copywriter.md | 128 --- .claude/agents/customer-persona-builder.md | 138 --- .claude/agents/devops-automator.md | 100 -- .claude/agents/docusaurus-expert.md | 173 ---- .claude/agents/email-marketer.md | 132 --- .claude/agents/experiment-tracker.md | 130 --- .claude/agents/feedback-synthesizer.md | 139 --- .claude/agents/figma-react-converter.md | 196 ---- .claude/agents/finance-tracker.md | 269 ------ .claude/agents/frontend-developer.md | 90 -- .claude/agents/growth-hacker.md | 184 ---- .claude/agents/growth-marketer.md | 163 ---- .claude/agents/infrastructure-maintainer.md | 195 ---- .claude/agents/instagram-curator.md | 120 --- .claude/agents/joker.md | 26 - .claude/agents/legal-advisor.md | 53 -- .claude/agents/legal-compliance-checker.md | 235 ----- .claude/agents/lifecycle-email.md | 137 --- .claude/agents/market-researcher.md | 114 --- .../agents/marketing-analytics-reporter.md | 153 --- .claude/agents/marketing-ops.md | 141 --- .claude/agents/mobile-app-builder.md | 90 -- .claude/agents/paid-ads-specialist.md | 128 --- .claude/agents/performance-benchmarker.md | 253 ----- .claude/agents/positioning-messaging.md | 132 --- .claude/agents/pr-outreach.md | 137 --- .claude/agents/project-shipper.md | 155 --- .claude/agents/rapid-prototyper.md | 90 -- .claude/agents/reddit-community-builder.md | 163 ---- .claude/agents/retention-specialist.md | 138 --- .claude/agents/seo-content-writer.md | 129 --- .claude/agents/seo-specialist.md | 128 --- .claude/agents/social-media-manager.md | 133 --- .claude/agents/sprint-prioritizer.md | 102 -- .claude/agents/studio-coach.md | 125 --- .claude/agents/studio-producer.md | 168 ---- .claude/agents/support-responder.md | 162 ---- .claude/agents/test-results-analyzer.md | 249 ----- .claude/agents/tiktok-strategist.md | 116 --- .claude/agents/tool-evaluator.md | 180 ---- .claude/agents/trend-researcher.md | 98 -- .claude/agents/twitter-engager.md | 141 --- .claude/agents/ui-designer.md | 153 --- .claude/agents/ux-researcher.md | 186 ---- .claude/agents/video-script-writer.md | 133 --- .claude/agents/visual-qa-agent.md | 120 --- .claude/agents/visual-storyteller.md | 247 ----- .claude/agents/whimsy-injector.md | 124 --- .claude/agents/workflow-optimizer.md | 215 ----- .claude/commands/analyze-performance.md | 42 - .claude/commands/build-campaign.md | 161 ---- .claude/commands/build-email-sequence.md | 49 - .claude/commands/build-from-figma.md | 188 ---- .claude/commands/competitor-teardown.md | 42 - .claude/commands/create-blog-article.md | 431 --------- .claude/commands/lint.md | 54 -- .claude/commands/plan-content-calendar.md | 52 - .claude/commands/seo-audit.md | 58 -- .claude/commands/setup-brand.md | 49 - .claude/commands/test.md | 69 -- .claude/commands/write-content.md | 60 -- .claude/hooks/approval-gate-guard.sh | 35 - .claude/hooks/editorial-qa-reminder.sh | 30 - .claude/hooks/pre-commit-brand-guard.sh | 35 - .claude/skills/README.md | 89 -- .claude/skills/ad-copy-variants/SKILL.md | 120 --- .claude/skills/analytics-report/SKILL.md | 116 --- .claude/skills/brand-voice-lock/SKILL.md | 192 ---- .claude/skills/campaign-brief-intake/SKILL.md | 210 ----- .claude/skills/competitor-teardown/SKILL.md | 117 --- .claude/skills/content-calendar/SKILL.md | 119 --- .claude/skills/design-token-lock/SKILL.md | 266 ------ .claude/skills/editorial-qa/SKILL.md | 158 ---- .claude/skills/email-sequence/SKILL.md | 118 --- .claude/skills/figma-intake/SKILL.md | 212 ----- .../skills/figma-to-react-workflow/SKILL.md | 573 ----------- .claude/skills/landing-page-copy/SKILL.md | 116 --- .../skills/parallel-orchestration/SKILL.md | 133 --- .claude/skills/persona-research/SKILL.md | 119 --- .claude/skills/react-accessibility/SKILL.md | 892 ------------------ .../react-component-development/SKILL.md | 848 ----------------- .../react-performance-optimization/SKILL.md | 560 ----------- .../skills/react-testing-workflows/SKILL.md | 731 -------------- .claude/skills/seo-keyword-research/SKILL.md | 129 --- .../skills/social-content-batching/SKILL.md | 118 --- .claude/skills/tdd-from-figma/SKILL.md | 233 ----- .../skills/visual-qa-verification/SKILL.md | 311 ------ docs/brand-setup/brand-voice.md | 2 +- docs/figma-to-react/README.md | 152 --- docs/react-development/README.md | 172 ---- scripts/README.md | 53 -- scripts/analytics-reporter/archive-report.sh | 76 -- .../analytics-reporter/check-data-sources.sh | 65 -- scripts/analytics-reporter/format-report.sh | 71 -- scripts/api-tester/check-endpoints.sh | 92 -- scripts/api-tester/generate-summary.sh | 136 --- scripts/api-tester/save-results.sh | 93 -- scripts/brand-voice-lint.js | 279 ------ scripts/check-accessibility.sh | 113 --- scripts/check-bundle-size.sh | 121 --- scripts/check-types.sh | 84 -- scripts/create-app.js | 130 --- scripts/cross-browser-test.sh | 107 --- scripts/docusaurus-expert/check-build.sh | 65 -- scripts/docusaurus-expert/preview-link.sh | 149 --- .../docusaurus-expert/validate-markdown.sh | 102 -- scripts/fix-agent-frontmatter.py | 184 ---- scripts/frontend-developer/build-report.sh | 75 -- scripts/frontend-developer/check-build.sh | 26 - scripts/frontend-developer/lint-and-format.sh | 56 -- scripts/lint-and-format.sh | 122 --- .../performance-benchmarker/check-tools.sh | 87 -- .../compare-results.sh | 121 --- .../save-benchmarks.sh | 88 -- scripts/readability-score.js | 219 ----- scripts/run-tests.sh | 113 --- scripts/seo-check.js | 220 ----- scripts/setup-playwright.sh | 85 -- scripts/setup-project.sh | 182 ---- .../archive-and-trend.sh | 72 -- .../test-results-analyzer/create-run-dir.sh | 20 - .../test-results-analyzer/validate-report.sh | 52 - scripts/test-writer-fixer/commit-coverage.sh | 71 -- scripts/test-writer-fixer/save-coverage.sh | 74 -- .../validate-test-command.sh | 40 - scripts/validate-content-calendar.js | 196 ---- scripts/verify-tokens.sh | 139 --- .../brand/brand-guidelines.template.json | 82 -- .../calendar/content-calendar.template.json | 30 - .../campaign/campaign-brief.template.json | 67 -- templates/content/blog-post.template.md | 38 - templates/content/press-release.template.md | 41 - templates/email/email-sequence.template.json | 32 - templates/nextjs/next.config.ts | 13 - templates/shared/.storybook/main.ts | 16 - templates/shared/.storybook/preview.ts | 15 - templates/shared/eslint.config.js | 38 - templates/shared/prettier.config.js | 12 - templates/shared/tailwind.config.ts | 33 - templates/shared/tsconfig.json | 26 - templates/shared/vitest.config.ts | 35 - templates/vite/vite.config.ts | 23 - 166 files changed, 1 insertion(+), 23854 deletions(-) delete mode 100644 .claude/AGENT-NAMING-GUIDE.md delete mode 100644 .claude/CUSTOM-AGENTS-GUIDE.md delete mode 100644 .claude/PLUGINS-REFERENCE.md delete mode 100644 .claude/agents/accessibility-auditor.md delete mode 100644 .claude/agents/agent-expert.md delete mode 100644 .claude/agents/ai-engineer.md delete mode 100644 .claude/agents/analytics-reporter.md delete mode 100644 .claude/agents/api-tester.md delete mode 100644 .claude/agents/app-store-optimizer.md delete mode 100644 .claude/agents/art-director.md delete mode 100644 .claude/agents/asset-cataloger.md delete mode 100644 .claude/agents/attribution-analyst.md delete mode 100644 .claude/agents/backend-architect.md delete mode 100644 .claude/agents/blog-writer.md delete mode 100644 .claude/agents/brand-compliance-checker.md delete mode 100644 .claude/agents/brand-guardian.md delete mode 100644 .claude/agents/brand-strategist.md delete mode 100644 .claude/agents/budget-planner.md delete mode 100644 .claude/agents/campaign-producer.md delete mode 100644 .claude/agents/command-expert.md delete mode 100644 .claude/agents/competitive-analyst.md delete mode 100644 .claude/agents/content-creator.md delete mode 100644 .claude/agents/content-strategist.md delete mode 100644 .claude/agents/conversion-optimizer.md delete mode 100644 .claude/agents/copywriter.md delete mode 100644 .claude/agents/customer-persona-builder.md delete mode 100644 .claude/agents/devops-automator.md delete mode 100644 .claude/agents/docusaurus-expert.md delete mode 100644 .claude/agents/email-marketer.md delete mode 100644 .claude/agents/experiment-tracker.md delete mode 100644 .claude/agents/feedback-synthesizer.md delete mode 100644 .claude/agents/figma-react-converter.md delete mode 100644 .claude/agents/finance-tracker.md delete mode 100644 .claude/agents/frontend-developer.md delete mode 100644 .claude/agents/growth-hacker.md delete mode 100644 .claude/agents/growth-marketer.md delete mode 100644 .claude/agents/infrastructure-maintainer.md delete mode 100644 .claude/agents/instagram-curator.md delete mode 100644 .claude/agents/joker.md delete mode 100644 .claude/agents/legal-advisor.md delete mode 100644 .claude/agents/legal-compliance-checker.md delete mode 100644 .claude/agents/lifecycle-email.md delete mode 100644 .claude/agents/market-researcher.md delete mode 100644 .claude/agents/marketing-analytics-reporter.md delete mode 100644 .claude/agents/marketing-ops.md delete mode 100644 .claude/agents/mobile-app-builder.md delete mode 100644 .claude/agents/paid-ads-specialist.md delete mode 100644 .claude/agents/performance-benchmarker.md delete mode 100644 .claude/agents/positioning-messaging.md delete mode 100644 .claude/agents/pr-outreach.md delete mode 100644 .claude/agents/project-shipper.md delete mode 100644 .claude/agents/rapid-prototyper.md delete mode 100644 .claude/agents/reddit-community-builder.md delete mode 100644 .claude/agents/retention-specialist.md delete mode 100644 .claude/agents/seo-content-writer.md delete mode 100644 .claude/agents/seo-specialist.md delete mode 100644 .claude/agents/social-media-manager.md delete mode 100644 .claude/agents/sprint-prioritizer.md delete mode 100644 .claude/agents/studio-coach.md delete mode 100644 .claude/agents/studio-producer.md delete mode 100644 .claude/agents/support-responder.md delete mode 100644 .claude/agents/test-results-analyzer.md delete mode 100644 .claude/agents/tiktok-strategist.md delete mode 100644 .claude/agents/tool-evaluator.md delete mode 100644 .claude/agents/trend-researcher.md delete mode 100644 .claude/agents/twitter-engager.md delete mode 100644 .claude/agents/ui-designer.md delete mode 100644 .claude/agents/ux-researcher.md delete mode 100644 .claude/agents/video-script-writer.md delete mode 100644 .claude/agents/visual-qa-agent.md delete mode 100644 .claude/agents/visual-storyteller.md delete mode 100644 .claude/agents/whimsy-injector.md delete mode 100644 .claude/agents/workflow-optimizer.md delete mode 100644 .claude/commands/analyze-performance.md delete mode 100644 .claude/commands/build-campaign.md delete mode 100644 .claude/commands/build-email-sequence.md delete mode 100644 .claude/commands/build-from-figma.md delete mode 100644 .claude/commands/competitor-teardown.md delete mode 100644 .claude/commands/create-blog-article.md delete mode 100644 .claude/commands/lint.md delete mode 100644 .claude/commands/plan-content-calendar.md delete mode 100644 .claude/commands/seo-audit.md delete mode 100644 .claude/commands/setup-brand.md delete mode 100644 .claude/commands/test.md delete mode 100644 .claude/commands/write-content.md delete mode 100644 .claude/hooks/approval-gate-guard.sh delete mode 100644 .claude/hooks/editorial-qa-reminder.sh delete mode 100644 .claude/hooks/pre-commit-brand-guard.sh delete mode 100644 .claude/skills/README.md delete mode 100644 .claude/skills/ad-copy-variants/SKILL.md delete mode 100644 .claude/skills/analytics-report/SKILL.md delete mode 100644 .claude/skills/brand-voice-lock/SKILL.md delete mode 100644 .claude/skills/campaign-brief-intake/SKILL.md delete mode 100644 .claude/skills/competitor-teardown/SKILL.md delete mode 100644 .claude/skills/content-calendar/SKILL.md delete mode 100644 .claude/skills/design-token-lock/SKILL.md delete mode 100644 .claude/skills/editorial-qa/SKILL.md delete mode 100644 .claude/skills/email-sequence/SKILL.md delete mode 100644 .claude/skills/figma-intake/SKILL.md delete mode 100644 .claude/skills/figma-to-react-workflow/SKILL.md delete mode 100644 .claude/skills/landing-page-copy/SKILL.md delete mode 100644 .claude/skills/parallel-orchestration/SKILL.md delete mode 100644 .claude/skills/persona-research/SKILL.md delete mode 100644 .claude/skills/react-accessibility/SKILL.md delete mode 100644 .claude/skills/react-component-development/SKILL.md delete mode 100644 .claude/skills/react-performance-optimization/SKILL.md delete mode 100644 .claude/skills/react-testing-workflows/SKILL.md delete mode 100644 .claude/skills/seo-keyword-research/SKILL.md delete mode 100644 .claude/skills/social-content-batching/SKILL.md delete mode 100644 .claude/skills/tdd-from-figma/SKILL.md delete mode 100644 .claude/skills/visual-qa-verification/SKILL.md delete mode 100644 docs/figma-to-react/README.md delete mode 100644 docs/react-development/README.md delete mode 100644 scripts/README.md delete mode 100644 scripts/analytics-reporter/archive-report.sh delete mode 100644 scripts/analytics-reporter/check-data-sources.sh delete mode 100644 scripts/analytics-reporter/format-report.sh delete mode 100644 scripts/api-tester/check-endpoints.sh delete mode 100644 scripts/api-tester/generate-summary.sh delete mode 100644 scripts/api-tester/save-results.sh delete mode 100644 scripts/brand-voice-lint.js delete mode 100644 scripts/check-accessibility.sh delete mode 100644 scripts/check-bundle-size.sh delete mode 100644 scripts/check-types.sh delete mode 100644 scripts/create-app.js delete mode 100644 scripts/cross-browser-test.sh delete mode 100644 scripts/docusaurus-expert/check-build.sh delete mode 100644 scripts/docusaurus-expert/preview-link.sh delete mode 100644 scripts/docusaurus-expert/validate-markdown.sh delete mode 100644 scripts/fix-agent-frontmatter.py delete mode 100644 scripts/frontend-developer/build-report.sh delete mode 100644 scripts/frontend-developer/check-build.sh delete mode 100644 scripts/frontend-developer/lint-and-format.sh delete mode 100644 scripts/lint-and-format.sh delete mode 100644 scripts/performance-benchmarker/check-tools.sh delete mode 100644 scripts/performance-benchmarker/compare-results.sh delete mode 100644 scripts/performance-benchmarker/save-benchmarks.sh delete mode 100644 scripts/readability-score.js delete mode 100644 scripts/run-tests.sh delete mode 100644 scripts/seo-check.js delete mode 100644 scripts/setup-playwright.sh delete mode 100644 scripts/setup-project.sh delete mode 100644 scripts/test-results-analyzer/archive-and-trend.sh delete mode 100644 scripts/test-results-analyzer/create-run-dir.sh delete mode 100644 scripts/test-results-analyzer/validate-report.sh delete mode 100644 scripts/test-writer-fixer/commit-coverage.sh delete mode 100644 scripts/test-writer-fixer/save-coverage.sh delete mode 100644 scripts/test-writer-fixer/validate-test-command.sh delete mode 100644 scripts/validate-content-calendar.js delete mode 100644 scripts/verify-tokens.sh delete mode 100644 templates/brand/brand-guidelines.template.json delete mode 100644 templates/calendar/content-calendar.template.json delete mode 100644 templates/campaign/campaign-brief.template.json delete mode 100644 templates/content/blog-post.template.md delete mode 100644 templates/content/press-release.template.md delete mode 100644 templates/email/email-sequence.template.json delete mode 100644 templates/nextjs/next.config.ts delete mode 100644 templates/shared/.storybook/main.ts delete mode 100644 templates/shared/.storybook/preview.ts delete mode 100644 templates/shared/eslint.config.js delete mode 100644 templates/shared/prettier.config.js delete mode 100644 templates/shared/tailwind.config.ts delete mode 100644 templates/shared/tsconfig.json delete mode 100644 templates/shared/vitest.config.ts delete mode 100644 templates/vite/vite.config.ts diff --git a/.claude/AGENT-NAMING-GUIDE.md b/.claude/AGENT-NAMING-GUIDE.md deleted file mode 100644 index 8e1f528..0000000 --- a/.claude/AGENT-NAMING-GUIDE.md +++ /dev/null @@ -1,40 +0,0 @@ -# Agent Naming Guide - -**Last Updated:** 2026-03-11 - -## Naming Convention - -All 44 agents use unique, hyphenated names (e.g., `frontend-developer`, `figma-react-converter`). There are no naming conflicts in the current agent set. - -Agent files live in `.claude/agents/` as `.md`. - -## How Agents Are Selected - -Claude Code automatically selects agents based on task context. You do not need to specify which agent to use unless you want to override the default selection. - -**Examples:** - -| Your Request | Agent Selected | -|-------------|---------------| -| "Build a login form component" | frontend-developer | -| "Write tests for the useAuth hook" | test-writer-fixer | -| "Convert this Figma design to React" | figma-react-converter | -| "Check this page for accessibility" | accessibility-auditor | -| "Optimize the bundle size" | performance-benchmarker | -| "Set up the CI pipeline" | devops-automator | -| "Design the component API" | backend-architect | - -## Explicit Selection - -To force a specific agent, name it in your request: - -``` -User: "Use the visual-qa-agent to compare these screenshots" -User: "Have the docusaurus-expert set up the docs site" -``` - -## Agent Categories - -Agents are grouped into 12 categories: Engineering, Design, Design-to-Code, Testing & QA, Product, Marketing, Project Management, Operations, Documentation, Meta, and Bonus. - -See `.claude/CUSTOM-AGENTS-GUIDE.md` for the full catalog with descriptions. diff --git a/.claude/CUSTOM-AGENTS-GUIDE.md b/.claude/CUSTOM-AGENTS-GUIDE.md deleted file mode 100644 index ecc780e..0000000 --- a/.claude/CUSTOM-AGENTS-GUIDE.md +++ /dev/null @@ -1,166 +0,0 @@ -# Custom Agents Guide - -**Last Updated:** 2026-03-11 -**Total Agents:** 44 -**Location:** `.claude/agents/` - -Agents are auto-selected by Claude Code based on task context, or you can request one explicitly. - ---- - -## Engineering - -| Agent | Purpose | When to Use | -|-------|---------|-------------| -| frontend-developer | React component implementation, styling, and client-side logic | Building UI components, pages, Tailwind styling, client-side state | -| backend-architect | API design, server architecture, and data modeling | Designing REST/GraphQL APIs, database schemas, server-side patterns | -| ai-engineer | AI/ML integration, prompt engineering, and model pipelines | Adding AI features, LLM integrations, embeddings, inference workflows | -| devops-automator | CI/CD pipelines, Docker, deployment automation | Setting up GitHub Actions, containerization, deployment scripts | -| mobile-app-builder | React Native and mobile-first development | Building cross-platform mobile apps, responsive mobile experiences | -| rapid-prototyper | Quick proof-of-concept implementations | Validating ideas fast, throwaway prototypes, spike solutions | -| test-writer-fixer | Write tests, run them, fix failures iteratively | Unit tests, integration tests, increasing coverage, fixing flaky tests | - -## Design - -| Agent | Purpose | When to Use | -|-------|---------|-------------| -| ui-designer | UI component design, layout systems, visual hierarchy | Designing component libraries, page layouts, design system tokens | -| ux-researcher | User experience research, usability analysis | User flow analysis, heuristic evaluation, accessibility reviews | -| brand-guardian | Brand consistency enforcement across assets | Ensuring colors, typography, tone, and imagery match brand guidelines | -| visual-storyteller | Data visualization and narrative-driven UI | Charts, dashboards, infographics, storytelling through design | -| whimsy-injector | Micro-interactions, animations, delightful UI details | Adding loading animations, transitions, easter eggs, playful touches | - -## Design-to-Code - -| Agent | Purpose | When to Use | -|-------|---------|-------------| -| figma-react-converter | Figma-to-React conversion pipeline orchestration | Converting Figma designs into React components with Tailwind CSS | -| asset-cataloger | Image/asset semantic mapping and validation | Mapping hash-named exports to meaningful names, validating asset usage | - -## Testing & QA - -| Agent | Purpose | When to Use | -|-------|---------|-------------| -| api-tester | API endpoint testing and validation | Testing REST/GraphQL endpoints, response schemas, error handling | -| performance-benchmarker | Performance profiling and optimization | Bundle size analysis, Lighthouse audits, runtime profiling | -| test-results-analyzer | Test suite analysis and trend reporting | Analyzing CI test results, identifying flaky tests, coverage trends | -| tool-evaluator | Evaluate libraries, frameworks, and tools | Comparing NPM packages, assessing dependencies, tech stack decisions | -| workflow-optimizer | Development process improvement | Streamlining build pipelines, reducing dev friction, automation gaps | -| visual-qa-agent | Visual regression testing and cross-browser verification | Comparing rendered output against Figma designs, screenshot diffing | -| accessibility-auditor | WCAG 2.1 AA compliance auditing | Color contrast, ARIA labels, keyboard navigation, Lighthouse a11y | - -## Product - -| Agent | Purpose | When to Use | -|-------|---------|-------------| -| sprint-prioritizer | Backlog prioritization and sprint planning | Ordering features by impact, planning sprints, scope management | -| feedback-synthesizer | User feedback analysis and insight extraction | Aggregating survey data, support tickets, feature requests | -| trend-researcher | Market and technology trend analysis | Researching competitors, emerging tech, industry benchmarks | - -## Marketing - -| Agent | Purpose | When to Use | -|-------|---------|-------------| -| content-creator | Marketing copy, blog posts, and content strategy | Writing landing pages, blog content, email campaigns | -| growth-hacker | Growth experiments and conversion optimization | A/B test ideas, funnel analysis, user acquisition strategies | -| app-store-optimizer | App store listing optimization (ASO) | Writing app descriptions, keyword research, screenshot strategy | -| instagram-curator | Instagram content strategy and visual planning | Post scheduling, hashtag strategy, visual grid planning | -| reddit-community-builder | Reddit engagement and community growth | Subreddit strategy, authentic engagement, community building | -| tiktok-strategist | TikTok content strategy and trends | Video content ideas, trending sounds, audience targeting | -| twitter-engager | Twitter/X engagement and thought leadership | Tweet threads, engagement strategy, audience growth | - -## Project Management - -| Agent | Purpose | When to Use | -|-------|---------|-------------| -| studio-producer | End-to-end project production management | Coordinating multi-phase projects, resource allocation, timelines | -| project-shipper | Getting projects from 90% to shipped | Final polish, launch checklists, shipping blockers, release prep | -| experiment-tracker | A/B test and experiment tracking | Logging experiments, tracking results, statistical significance | - -## Operations - -| Agent | Purpose | When to Use | -|-------|---------|-------------| -| analytics-reporter | Metrics dashboards and data reporting | Building analytics views, KPI tracking, report generation | -| finance-tracker | Financial tracking and budget management | Cost tracking, subscription management, budget forecasting | -| infrastructure-maintainer | Server and infrastructure maintenance | Monitoring, uptime, dependency updates, security patches | -| legal-compliance-checker | Legal and regulatory compliance review | Privacy policies, GDPR, terms of service, license compliance | -| support-responder | Customer support response drafting | Drafting support replies, FAQ creation, escalation handling | - -## Documentation - -| Agent | Purpose | When to Use | -|-------|---------|-------------| -| docusaurus-expert | Docusaurus documentation site creation | Building docs sites, MDX content, versioned documentation | - -## Meta - -| Agent | Purpose | When to Use | -|-------|---------|-------------| -| agent-expert | Agent creation and configuration guidance | Creating new agents, optimizing agent prompts, agent architecture | -| command-expert | Claude Code command and configuration help | Slash commands, settings, hooks, plugin configuration | - -## Bonus - -| Agent | Purpose | When to Use | -|-------|---------|-------------| -| joker | Comic relief and creative brainstorming | When you need a laugh or creative lateral thinking | -| studio-coach | Development coaching and mentorship | Code review mentoring, learning paths, skill development | - ---- - -## How Agents Work - -Agents are invoked through Claude Code's Task tool. They are automatically selected based on task context: - -``` -User: "Help me optimize this component's rendering" -Claude: [Uses performance-benchmarker agent] - -User: "Convert this Figma design to React" -Claude: [Uses figma-react-converter agent] - -User: "Write tests for the auth hook" -Claude: [Uses test-writer-fixer agent] -``` - -You can also request a specific agent: -``` -User: "Use the accessibility-auditor agent to check this page" -``` - ---- - -## Agent + Skill Integration - -Agents work alongside the 6 custom skills in `.claude/skills/`: - -| Agent | Complementary Skill | -|-------|-------------------| -| figma-react-converter | figma-to-react-workflow | -| frontend-developer | react-component-development | -| test-writer-fixer | react-testing-workflows | -| performance-benchmarker | react-performance-optimization | -| accessibility-auditor | react-accessibility | -| visual-qa-agent | visual-qa-verification | - -**Skills Documentation:** `.claude/skills/README.md` - ---- - -## Quick Reference - -| Task | Best Agent | -|------|-----------| -| Build a React component | frontend-developer | -| Convert Figma to React | figma-react-converter | -| Write unit tests | test-writer-fixer | -| Optimize bundle size | performance-benchmarker | -| WCAG compliance audit | accessibility-auditor | -| Visual regression check | visual-qa-agent | -| Map exported assets | asset-cataloger | -| Design a component | ui-designer | -| Set up CI/CD | devops-automator | -| API endpoint testing | api-tester | -| Create documentation site | docusaurus-expert | -| Ship a release | project-shipper | diff --git a/.claude/PLUGINS-REFERENCE.md b/.claude/PLUGINS-REFERENCE.md deleted file mode 100644 index 07cb5b1..0000000 --- a/.claude/PLUGINS-REFERENCE.md +++ /dev/null @@ -1,134 +0,0 @@ -# Claude Code Plugins Reference - -**Last Updated:** 2026-03-11 -**Installed Plugins:** 4 user plugins + 1 local plugin - ---- - -## episodic-memory - -Semantic search and persistent memory across Claude Code sessions. - -**What it does:** -- Archives conversations automatically -- Provides semantic search over past sessions -- Maintains context across the 30-day conversation deletion window - -**Commands:** -```bash -/search-conversations [query] # Search previous conversations -/remember [context] # Store important context -``` - -**Technical notes:** -- Uses SQLite with vector search -- Archives stored in `~/.config/superpowers/conversations-archive` - ---- - -## commit-commands - -Git workflow automation with structured commits and PR helpers. - -**Commands:** - -| Command | What it Does | -|---------|-------------| -| `/commit` | Analyzes staged changes, suggests a structured commit message, creates the commit | -| `/commit-push-pr` | Commits, pushes to remote, and opens a GitHub PR in one step | -| `/clean_gone` | Removes local branches already deleted on remote | - -**Commit message conventions:** -``` -feat: Add new component or feature -fix: Bug fix -refactor: Code restructuring without behavior change -test: Adding or updating tests -docs: Documentation changes -style: Formatting, linting (no logic change) -chore: Build process, dependencies -``` - ---- - -## github (gh CLI) - -GitHub integration for repos, PRs, issues, and actions. - -**Prerequisites:** GitHub CLI (`gh`) installed and authenticated (`gh auth login`). - -**Common commands:** -```bash -gh repo list # List repositories -gh pr create --title "Title" --body "Description" # Create PR -gh pr list # List open PRs -gh pr view 123 # View PR details -gh issue create --title "Bug" --body "Details" # Create issue -gh issue list # List issues -gh run list # List CI workflow runs -gh run view 12345 # View workflow run details -``` - ---- - -## superpowers - -Advanced development workflows and best practices enforcement. - -**Capabilities:** -- Brainstorming and ideation workflows -- Code review with confidence-rated findings -- Systematic debugging approaches -- Test-driven development guidance -- Implementation planning and plan verification - -**Usage:** Activated automatically based on task context, or through `/` commands. - ---- - -## ai-taskmaster (Local) - -Task management and development planning. - -**What it does:** -- Project task tracking and prioritization -- Development milestone planning -- Task dependency management - -**Note:** Local plugin, not published to registry. - ---- - -## Security - -- Never commit GitHub PATs or API keys -- Store secrets in environment variables or a credential manager -- Rotate tokens every 90 days -- Use fine-grained tokens with minimal scopes -- Check `.claude/settings.local.json` for configured permissions - ---- - -## Quick Commands Cheat Sheet - -```bash -# Memory -/search-conversations [query] # Search past sessions -/remember [context] # Save context - -# Git -/commit # Structured commit -/commit-push-pr # Commit + push + PR -/clean_gone # Clean merged branches - -# GitHub -gh pr create # Create pull request -gh pr list # List PRs -gh issue create # Create issue -gh auth status # Check auth - -# Plugins -/plugin list # List installed plugins -/plugin install # Install plugin -/plugin uninstall # Remove plugin -``` diff --git a/.claude/agents/accessibility-auditor.md b/.claude/agents/accessibility-auditor.md deleted file mode 100644 index 19fb067..0000000 --- a/.claude/agents/accessibility-auditor.md +++ /dev/null @@ -1,133 +0,0 @@ ---- -name: accessibility-auditor -description: WCAG 2.1 AA compliance auditor for web applications. Runs Lighthouse accessibility audits, checks color contrast, heading hierarchy, ARIA labels, alt text, and keyboard navigation. -tools: Read, Write, Bash, Grep, Glob, TodoWrite, TaskOutput, AskUserQuestion, mcp__chrome-devtools__navigate_page, mcp__chrome-devtools__take_screenshot, mcp__chrome-devtools__lighthouse_audit, mcp__chrome-devtools__evaluate_script, mcp__chrome-devtools__list_pages, mcp__chrome-devtools__new_page, mcp__chrome-devtools__select_page, mcp__chrome-devtools__press_key -model: opus -permissionMode: bypassPermissions ---- - -You are a WCAG 2.1 AA accessibility compliance specialist for web applications. You audit apps for accessibility violations using both automated tools and manual code review. - -## Primary Responsibilities - -### 1. Automated Accessibility Audit (Lighthouse) - -Run Lighthouse accessibility audits on every page: -- Navigate to page via Chrome DevTools MCP -- Run `lighthouse_audit` with category: "accessibility" -- Capture score and individual audit results -- Record failures with element selectors - -**Target score:** 95+ on every page - -### 2. Color Contrast Validation - -**Check all text/background combinations:** -- Normal text: Must meet WCAG AA (4.5:1) -- Large text (>=18px or >=14px bold): Must meet 3:1 -- Button text on button backgrounds -- Link colors on backgrounds - -**Extract from design tokens / Tailwind config and validate programmatically.** - -### 3. Heading Hierarchy Audit - -**Per-page heading structure:** -- Exactly one h1 per page -- No skipped levels (h1 → h3 without h2) -- Headings in logical order -- Navigation should NOT use heading elements for menu items - -### 4. Image Alt Text Audit - -**Scan all components for image alt text:** -- Every `` and `` must have an `alt` attribute -- Alt text must be descriptive (not "image", "photo", "img_123") -- Decorative images should use `alt=""` -- Background images: Check for alternative text content - -### 5. Keyboard Navigation Audit - -**Test via Chrome DevTools MCP:** -- Tab through the entire page -- Verify all interactive elements are reachable -- Check focus indicators are visible -- Verify skip-to-content link exists -- Test dropdown/mobile menu keyboard access -- Verify modal/dialog focus trapping (if any) - -### 6. ARIA & Semantic HTML Audit - -**Landmark roles:** -- `
` or `role="banner"` present -- `