Use Spec Kitty in Windsurf
Tier: supported. Workflow mechanism. Citation (accessed 2026-05-21): https://docs.windsurf.com/windsurf/cascade/workflows
Prerequisites
- Spec Kitty CLI installed. See Install Spec Kitty.
- Project initialized for this harness:
spec-kitty init --ai windsurf - Windsurf installed and signed in. Follow the Windsurf workflow docs for installation and configuration.
Where Spec Kitty installs files
Per the supported-harnesses matrix, Windsurf uses the workflow mechanism (Cascade workflows). Spec Kitty installs:
- Directory:
.windsurf/workflows/ - Files:
spec-kitty.specify.md,spec-kitty.plan.md,spec-kitty.tasks.md,spec-kitty.implement.md,spec-kitty.review.md,spec-kitty.accept.md,spec-kitty.merge.md,spec-kitty.dashboard.md,spec-kitty.status.md,spec-kitty.charter.md,spec-kitty.analyze.md,spec-kitty.research.md.
Canonical invocation
Inside Windsurf Cascade, the workflow files are surfaced as slash commands:
/spec-kitty.specify "<one-line mission description>"
/spec-kitty.plan
/spec-kitty.tasks
/spec-kitty.implement WP01
Cascade's workflow-discovery rules may evolve. If /spec-kitty.* does not autocomplete, consult https://docs.windsurf.com/windsurf/cascade/workflows for the current invocation syntax.
Worked example
- Open your project in Windsurf.
- In the Cascade chat, type:
/spec-kitty.specify "a hello world page" - Spec Kitty's interview prompts appear — answer them inline.
- When asked for a kebab-case slug, supply something short, e.g.
hello-world-page. - The mission spec lands at
kitty-specs/hello-world-page-<mid8>/spec.md.
Troubleshooting
/spec-kitty.*workflows do not appear. Runspec-kitty agent config syncfrom the repo root. This rewrites.windsurf/workflows/from the canonical source templates. Restart Windsurf.Profile not loading. In Cascade chat, run:
/ad-hoc-profile-load researcher-robbieUse the profile id from the work-package frontmatter.
Where to learn more about Windsurf
Authoritative documentation: https://docs.windsurf.com/windsurf/cascade/workflows (accessed 2026-05-21).