fw

Clear session caches — by project, command, age, or everything

Debug workflow — diagnose root cause, explain failing code, propose solutions (never modifies code)

Delegate a task to a sub-agent (Codex, Claude, Gemini)

Research-driven design workflow — analyze requirements, explore the codebase, research best practices, and produce a detailed plan of action (never modifies code)

Generate focused documentation for any topic — research the codebase, explain findings with clarity, and produce a standalone markdown document with mermaid diagrams

Elite software architect for the flywheel-plugin system. Specialises in evaluating implementation approaches, producing ADRs, defining file maps, and identifying architectural risks — all specific to the currently open codebase. Invoked during planning and design phases. Use PROACTIVELY when planning how to implement a feature, designing service boundaries, evaluating competing approaches, or producing a technical implementation plan from a brief.

Senior code reviewer for the flywheel-plugin system. Reviews pull requests and staged changes with the eye of a principal engineer — catching bugs, design flaws, security issues, maintainability problems, and missing edge cases. Posts inline comments on exact lines of code with severity, issue, impact, and fix. Use PROACTIVELY when reviewing any PR, staged diff, or code change before it merges.

Systematic root-cause analyst for the flywheel-plugin system. Does not guess — traces, proves, and diagnoses. Every diagnosis comes with evidence, a causal chain, and a targeted fix. Use PROACTIVELY when encountering any runtime error, test failure, unexpected behaviour, regression, performance anomaly, or intermittent bug. Never modifies code — only diagnoses and proposes.

Elite frontend designer for the flywheel-plugin system. Specialises in building distinctive, production-grade UI components, pages, and applications with exceptional aesthetic quality — avoiding generic "AI slop" entirely. Invoked by /fw:fe-design whenever a frontend interface, component, or visual experience needs to be built. Use PROACTIVELY when the task involves any user-facing UI work: landing pages, dashboards, forms, interactive components, design systems, or full applications.

Precision migration engineer for the flywheel-plugin system. Specialises in framework upgrades, dependency bumps, API changes, and language modernisation — with breaking change detection, batched execution, and rollback safety as first-class concerns. Use PROACTIVELY when upgrading any dependency, migrating between frameworks, changing APIs, or modernising syntax at scale. Never makes changes without a tested rollback plan.

Auto-enriches research phases with official library documentation via Context7 MCP. Resolves named technologies to library IDs, queries version-specific docs, and injects findings before WebSearch or Gemini dispatch — ensuring agents work with up-to-date syntax, APIs, and patterns rather than stale or generic web results.

Activates structured iterative reasoning via the sequential-thinking MCP before complex analysis phases. Claude reasons step-by-step — revising thoughts, exploring branches, and synthesising conclusions — before producing output or delegating to a sub-agent. Automatically skipped for light/small/low complexity tasks.

Provides mermaid diagram generation for any command that benefits from a visual representation. Picks the appropriate diagram type from the content signals, emits valid mermaid syntax, and self-skips when visualization would add no value. Activated by /fw:visualize directly, and on-demand by /fw:summarize, /fw:document, /fw:design, /fw:debug, /fw:implement, and /fw:reflect.