Commit Graph

15 Commits

Author SHA1 Message Date
Jeremy Dawes 608fdd4300 feat(dev-tools): rewrite ux-audit, add ux-extract and ux-compare
Three-skill UX trilogy: extract captures patterns from reference apps,
compare synthesises design decisions across extracts, audit measures
a build against the bar.

ux-audit rewrite
- Single exhaustive mode (drops quick/standard/thorough — unused ladders)
- Thread-first flow testing, with element inventory as completeness check
- Coverage arithmetic: tested / inventoried, published in the report
- Persona required (argument, .jez/personas/, or one-question prompt)
- Chrome MCP required for authenticated apps, fail loud if not connected
- Viewport pinned 1440x900 at start, >2000px noted as harness-breaking
- 8-scenario battery: First Contact, Interrupted Workflow, Wrong Turn
  Recovery, Returning User, Keyboard Only, Heavy Data, Destructive
  Confidence, Second User
- Sub-agent screenshot review per thread
- Fix-and-verify loop closes findings in the same session
- Optional cross-reference to ux-extract libraries

ux-extract (new)
- Inverse of audit — asks "what is the bar?"
- Exhaustively captures screenshots (every state), verbatim copy,
  interaction prose, keyboard patterns, responsive treatments, motion
  GIFs, and Notable Absences
- Dedup phase collapses repeated patterns
- Output: docs/ux-extracts/<app>/pattern-library.md + screenshots/
- Ethics section on ToS, robots.txt, rate-limiting, authorised access

ux-compare (new)
- No browser — pure markdown synthesis across 2+ pattern libraries
- Walks category by category: convergence, divergence, unique, absent
- Opinionated recommendations (safe default / consider / skip / fill gap)
- Cites source libraries instead of re-embedding screenshots
- Honest about stale libraries and coverage gaps

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-19 12:28:16 +10:00
Jeremy Dawes 61bdd74da8 feat: major app-docs upgrade + showcase mockup patterns
app-docs rewritten with:
- Exhaustive depth level (150+ screenshots, publishable HTML suite)
- Per-page documentation template with What You'll See / What You Can Do / How To
- Supporting sections: getting started, navigation guide, keyboard shortcuts, troubleshooting, admin guide
- HTML output option with TOC sidebar and print CSS
- Workflow diagrams and annotated screenshot patterns
- Quality bar: "a new user can complete any task by following the guide"
- Mockup and diagram techniques alongside screenshots

product-showcase: added mockup + screenshot mix guidance with CSS phone
frame for mobile screenshots, guidance on when to use real screenshots
vs simplified mockups for different sections.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-20 15:52:59 +11:00
Jeremy Dawes c6cf54b32e feat(ux-audit): add exhaustive mode — test every interactive element
New fourth depth level: exhaustive (4-8+ hours)
- Inventories every interactive element on every page (buttons, links,
  inputs, selects, toggles, tabs, accordions, modals, dropdowns, etc.)
- Clicks/interacts with every one, screenshots each state
- Tests every form with valid, invalid, and empty data
- Tests every filter value, sort option, tab, combination
- Dark mode + light mode for every page and dialog
- Three viewport widths for every page and dialog
- Keyboard navigation through every page
- Context menus, edge states, concurrent tabs, every error path
- Per-page element inventory with pass/fail tracking
- Writes findings incrementally to report (doesn't hold in memory)

Depth progression: quick (5 min) → standard (30 min) → thorough (3 hrs) → exhaustive (8+ hrs)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-20 01:07:46 +11:00
Jeremy Dawes cc605fc7e6 feat: add stripe-payments skill + fix argument hints across all commands
stripe-payments: Checkout Sessions, Payment Intents, subscriptions,
webhooks (with constructEventAsync for Workers), customer portal,
pricing pages. Decision table for which API to use. Cloudflare Workers
gotchas. No MCP server needed.

Argument hint cleanup: removed [url] and [file-path] from hints —
replaced with meaningful choices (depth levels, modes, purposes).
The URL/file is auto-detected, the hint shows what the user decides.

product-showcase: added depth levels (quick/standard/thorough).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 22:47:25 +11:00
Jeremy Dawes 312943e509 feat: kill dev-session, make roadmap the execution engine
BREAKING: dev-session skill removed. Its useful bits are now in roadmap.

Roadmap skill now has four modes:
- plan: generate the roadmap (was the only mode before)
- start: begin executing from phase 1, don't stop until done or stuck
- resume: pick up from the last session, keep going
- status: show progress across phases

Execution rules: commit at phase boundaries, deploy after each phase,
quick audit between phases, thorough audit + onboarding-ux + project-docs
after the final phase. Only stop for blockers that need human input.

Progress tracked directly in ROADMAP.md with checked tasks and completed
phase markers — no separate SESSION.md needed.

dev-session was a 200K-era survival tool. At 1M context, the roadmap
itself is the session state.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 14:13:24 +11:00
Jeremy Dawes 8cb92d183f feat: add roadmap skill — comprehensive phased delivery plans for entire apps
Produces a ROADMAP.md detailed enough that "build phase N" is a complete
instruction for Claude Code. Includes: vision, stack decisions, complete
data model upfront, 4-8 phases with task checklists grouped by layer,
schema evolution map, API surface map, build order table, and
"deliberately not building" scope control.

Designed for all-day autonomous execution — each phase is independently
deployable with a definition of done. Pairs with deep-research (input)
and fork-discipline/ux-audit/onboarding-ux (post-phase checks).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 13:00:30 +11:00
Jeremy Dawes c3ab785ca2 feat: add cloudflare-api skill + improve deep-research argument hints
cloudflare-api: Hit the Cloudflare REST API directly for operations that
wrangler and MCP can't handle well. Covers bulk DNS, custom hostnames,
email routing, cache purge, WAF rules, redirect rules, zone settings,
Worker routes, and GraphQL analytics. Produces curl commands or scripts.
Not a docs mirror — workflow recipes for real operations.

deep-research: Updated argument hints to explain what focused/wide/deep
actually mean inline, so you don't have to remember.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 12:54:22 +11:00
Jeremy Dawes 880c4228c4 feat: add fork-discipline skill — audit core/client boundary in multi-client projects
Three modes:
- audit: map the boundary, find violations (hardcoded client checks,
  config replacement, scattered client code, missing extension points,
  migration conflicts), produce a health score and report
- document: generate FORK.md documenting the boundary and how to add clients
- refactor: concrete steps to move client code out of core, replace client
  checks with feature flags, implement config merge, add extension points

Includes the "right time to run" guide: don't refactor at 1 client,
audit at 2, full refactor at 3+.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 11:04:43 +11:00
Jeremy Dawes b2355ac49e feat: add onboarding-ux skill — audit and generate in-app user guidance
Audits a web app for onboarding gaps (empty states, missing guidance,
feature discoverability, contextual help), then generates the actual
content and code to fix them:

- Empty state components with copy and CTAs
- Welcome banner or onboarding checklist
- Feature tour configuration (react-joyride pattern)
- Tooltip content map for every complex field
- Contextual hints (dismissable, shown once)
- Onboarding-quality seed data
- Help/FAQ page content

Pairs with ux-audit: audit finds problems, onboarding-ux builds solutions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 08:05:21 +11:00
Jeremy Dawes 397e8cbcfb feat: replace knowledge-cortex with basalt plugin + add deep-research skill
BREAKING: knowledge-cortex plugin removed. Replace with basalt plugin.
- /basalt:basalt-cortex replaces /knowledge-cortex:cortex-mine and cortex-query
- Basalt format: Obsidian-compatible markdown with YAML frontmatter (not JSONL)
- Multi-source: Gmail, Google Chat, Slack, Drive, local files, MCP, web, calendar
- Pattern-based teaching (no shipped scripts)
- References: basalt-format.md, source-patterns.md, prefilter-patterns.md, sync-patterns.md

NEW: deep-research skill in dev-tools
- Deep research and discovery before building something new
- Three depths: focused (30 min), wide (1-2 hours), deep (3-6 hours)
- Local exploration, competitor analysis, ecosystem signals, future-casting
- Produces comprehensive research brief to .jez/artifacts/

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 00:32:08 +11:00
Jeremy Dawes 7f1f77baa3 feat: add slash commands for all 51 skills + fix compatibility fields
Created 45 command files with descriptive argument-hints so every skill
has a /plugin:skill-name shortcut. Added compatibility: claude-code-only
to 17 skills that require Bash/filesystem/browser (d1-migration, db-seed,
project-docs, git-workflow, landing-page, shadcn-ui, tailwind-theme-builder,
ai-image-generator, color-palette, favicon-gen, icon-set-generator, etc).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 21:24:58 +11:00
Jeremy Dawes 368f4b80c6 fix: update ux-audit command hint to show depth options
argument-hint now shows [quick|standard|thorough] [url] instead of just [url]

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 14:54:12 +11:00
Jeremy Dawes 6bef392988 feat(dev-tools): add team-update skill, enhance ux-audit dogfooding, expand permission presets
Team Update skill:
- Playbook pattern: first run discovers tools + saves config, subsequent runs execute from playbook
- Adapts to any MCP setup (chat, issues, tasks, knowledge) with graceful degradation
- Slash command /team-update with modes: update, check, standup, feedback, plan
- Reference files: playbook format, discovery patterns, message composition, feedback triage

UX Audit enhancements:
- Rewritten Mode 1 as dogfooding workflow with user persona adoption
- Added emotional friction tracking (trust, anxiety, certainty)
- Added flow efficiency metrics (click count, decision points, dead ends)
- Added resilience testing (mid-form nav, back button, refresh, double-click)
- Added "big questions" (would I come back? could I teach someone in 2 minutes?)
- Updated report template with flow score table and resilience results

Permission presets expansion (605 → 1141 lines):
- New presets: Java/JVM, .NET, Elixir, Swift, Static Sites, Hosting Platforms,
  Tunneling, SaaS CLIs, Document Processing, CI, Editors/IDE
- Expanded existing: macOS (+screencapture, osascript, caffeinate), Universal Base
  (+seq, bc, column, ping, perl, yes, whois), JS/TS (+corepack, tsup, swc, nx),
  Python (+pdm, hatch, pre-commit), Database (+pg_dump, turso, pscale),
  Mobile (+flutter, dart, fastlane)
- 138 WebFetch domains organised by category matching Bash presets
- Data-driven additions from scanning 179 project settings files

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 08:01:17 +11:00
Jeremy Dawes b6eba750de feat: add slash commands for tanstack-start, session, release, ux-audit
/tanstack-start — build a full-stack TanStack Start app
/session [start|checkpoint|wrap|resume] — manage dev sessions
/release [version] — prepare and publish GitHub releases
/ux-audit [url] — run UX walkthrough and QA sweep

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-26 23:18:27 +11:00
Jeremy Dawes 36ee5a104c Replace project-kickoff + context-manager with /project-health command
- Add commands/project-health.md as slash command (/project-health)
- Remove skills/project-kickoff/ (merged into project-health)
- Remove skills/context-manager/ (merged into project-health)
- Update plugin.json description
- project-health skill retains all reference files from both old skills

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 13:31:53 +11:00