The outcome

Make future Windsurf sessions follow the project's real commands, boundaries, and review standards.

Step by step

A workflow you can repeat.

  1. 01

    Collect only enduring conventions: commands, architecture boundaries, style rules, and prohibited changes.

  2. 02

    Choose AGENTS.md for hierarchical repository guidance or a workspace Rule with the narrowest useful trigger.

  3. 03

    Write short, testable instructions and link to canonical examples instead of copying long documentation.

  4. 04

    Test the rule with a small planning task and inspect whether Cascade applies it in the intended files.

  5. 05

    Version shared rules with the repository and review them whenever tooling or architecture changes.

Working standard

What good use looks like.

  • Prefer specific checks to vague advice.
  • Scope rules narrowly.
  • Never place secrets in agent context.

Official references

Check the current product documentation.