ADHD-friendly output for Windsurf

ADHD-friendly output rules for Windsurf. One file. Always on. No slash command.

What this does

Windsurf buries answers behind preamble. adhd-mode fixes this with one file that Windsurf reads automatically.

⚡

Action-first

First line = something you can do now.

🔢

Numbered steps

Multi-step tasks become numbered lists.

🔁

Anti-decay

Rules persist across turns with re-injection.

📐

Scope by shape

Quick / Medium / Large, not fabricated time.

Install for Windsurf

Windsurf
mkdir -p .windsurf/rules
curl -o .windsurf/rules/adhd-mode.md https://raw.githubusercontent.com/DevAnimecx/adhd-mode/main/rules/windsurf/rules/adhd-mode.md

File at rules/windsurf/rules/adhd-mode.md. Restart Windsurf after installing.

Before / After

⚠ Before
Great question! Let me take a look... [47 lines] ...Hope this helps!
✓ After
Run npm install jsonwebtoken, then edit src/auth.ts:42.

1. Open file
2. Replace function
3. Run tests

Next: paste failures.

How Windsurf loads the rules

Windsurf uses .windsurf/rules/*.md with trigger: always_on. Legacy .windsurfrules also works.

FAQ

How do I set up ADHD rules in Windsurf?

Place a .md file in .windsurf/rules/ with trigger: always_on.

.windsurfrules vs .windsurf/rules/?

Legacy vs modern format. adhd-mode ships both.

Does Windsurf read AGENTS.md?

Experimental. Use .windsurf/rules/ for strongest guarantee.

Ready to fix Windsurf's output?

One file. 30 seconds.