Skip to content

Add Search Before Building intro and cross-platform URL support#583

Open
1aifanatic wants to merge 2 commits intogarrytan:mainfrom
1aifanatic:contribution-2-search-intro
Open

Add Search Before Building intro and cross-platform URL support#583
1aifanatic wants to merge 2 commits intogarrytan:mainfrom
1aifanatic:contribution-2-search-intro

Conversation

@1aifanatic
Copy link
Copy Markdown

Summary

Adds the first-time Search Before Building intro flow, similar to the existing Boil the Lake intro. Also updates the Lake intro to use the new cross-platform URL helper.

Changes

  • Add generateSearchIntro() function that introduces the Search Before Building principle
  • Add SEARCH_INTRO preamble variable that checks for .search-intro-seen marker file
  • Update generateLakeIntro() to use the new gstack-open-url helper for cross-platform browser opening
  • Add generateSearchIntro() to tier >= 3 preamble sections (used by autoplan, codex, design-consultation, etc.)

Motivation

Creates a consistent pattern for first-time principle introductions. The Boil the Lake intro already exists; this adds the same onboarding experience for Search Before Building, which is equally important to the gstack philosophy.

Testing

  • Verified preamble.ts compiles correctly
  • Follows the same pattern as the existing lake intro

Closes TODOS.md item: First-time Search Before Building intro

Adds a new bin/gstack-open-url script that opens URLs in the default
browser across macOS, Linux, and Windows platforms.

- Uses 'open' on macOS
- Uses 'xdg-open' on Linux
- Uses 'start' on Windows
- Supports GSTACK_OPEN_CMD env override for custom handlers

This fixes the hardcoded 'open' command that only worked on macOS,
enabling the Boil the Lake and Search Before Building intro flows
to work on all supported platforms.

Closes TODOS.md item: Cross-platform URL open helper
Adds the first-time Search Before Building intro flow, similar to
the existing Boil the Lake intro.

Changes:
- Add generateSearchIntro() function that introduces the Search Before
  Building principle with a link to the essay
- Add SEARCH_INTRO preamble variable that checks for .search-intro-seen
- Update generateLakeIntro() to use the new gstack-open-url helper for
  cross-platform URL opening
- Add generateSearchIntro() to tier >= 3 preamble sections

This creates a consistent pattern for first-time principle introductions
and enables cross-platform browser opening for both intros.

Closes TODOS.md item: First-time Search Before Building intro
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