Skip to content

Derive default module path in init_project and simplify /surla start - #261

Merged
raphael merged 2 commits into
mainfrom
s4-zero-prompt-init
Nov 20, 2026
Merged

raphael merged 2 commits into
mainfrom
s4-zero-prompt-init

Conversation

@raphael

@raphael raphael commented Nov 20, 2026

Copy link
Copy Markdown
Member

When a developer invoked /surla in an empty folder, the bundled /surla skill instructed the guide to pass "the user's module path" and init_project declared module_path as a required field. As a result, the guide paused before initializing or opening the browser page and asked the user for a Go module path alongside upfront product-discovery questions in chat, turning first-use onboarding into setup work.

Resulting behavior

  • Optional module_path derivation in init_project: InitProjectPayload.module_path is now optional (MinLength(3) retained when supplied so empty strings remain structurally invalid). Omitting module_path derives example.com/<service> from the target folder name (lowercased ASCII letters and non-leading digits up to 48 characters, appending svc—clamped to 48 characters—for main, Go keywords, vN module-version suffixes, or reserved module path names, and falling back to example.com/app when no ASCII letter is present). Passing dir: "." or omitting both module_path and dir initializes the bound workspace folder in place; passing an explicit module_path preserves existing validation and child-directory defaults.
  • Single-question start and Change Card ambiguities in /surla: skills/surla/SKILL.md now instructs the guide to attach and open the browser page first, ask at most one plain question ("What would you like to build?") when the user invoked /surla without a goal, call init_project with dir: "." immediately once a goal is given (omitting module_path unless the user supplied one), and put open product questions (such as target users, policy thresholds, or edge cases) into the Change Card's ambiguities with concrete options so the user decides on Agree instead of answering checklists in chat.
  • Updated user docs and UX study rubric: README.md, docs/HOW_IT_WORKS.md, and docs/REFERENCE.md describe the simplified /surla onboarding flow and optional module_path contract, and .agents/skills/surla-ux-review/ updates the default participant persona and moderator rubric so future studies exercise terse /surla starts and flag unnecessary upfront questioning or derivable plumbing toil even when documented.

Verification

Verified with Goa and UI bundle consistency checks (goa gen, node ui/checkpoint/build.mjs --check, TypeScript typecheck, go vet), table-driven init_project unit and HTTP/MCP boundary suites covering omitted module_path derivation across workspace and child folders, keyword/main/numeric folder names, blank and short module_path rejections, cmd/surla setup/stdio suites, and documentation link checks.

@raphael
raphael merged commit 9720ef1 into main Nov 20, 2026
25 checks passed
@raphael
raphael deleted the s4-zero-prompt-init branch November 20, 2026 01:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant