@@ -102,6 +102,10 @@ When the project has informal markdown specs with Gherkin-ish structure (bullet-
The goal is feature files that a non-developer could read and confirm: "yes, that's the behaviour we want."
+## Editor tooling
+
+The Cucumber language server cannot discover gocuke step definitions. It expects explicit registration calls (Godog-style `ctx.Given("pattern", fn)`), not gocuke's runtime reflection. "Undefined step" warnings are false positives; disable the Cucumber language server for gocuke projects.
+
## Further reference
- **BDD practices (Discovery, Formulation, Automation)**: See [references/bdd-practices.md](references/bdd-practices.md)