Skip to content

docs: require warm completion before starting the app - #468

Merged
janicduplessis merged 1 commit into
mainfrom
docs/warm-completion-467
Sep 7, 2026
Merged

docs: require warm completion before starting the app#468
janicduplessis merged 1 commit into
mainfrom
docs/warm-completion-467

Conversation

@janicduplessis

Copy link
Copy Markdown
Collaborator

Description

A shell tool can return a running-job ID while worktree warming is still copying dependencies. The guide's command order alone does not tell agents to wait before starting Metro or installing packages.

Solution

Make successful warm completion an explicit prerequisite for start, platform builds, and dependency installation. Explain how to handle yielded jobs in the version-matched agent and lifecycle guides; keep the static skill router and runtime behavior unchanged.

Test plan

  • Render stim guide agent and stim guide lifecycle options; verify both require warm to exit successfully and distinguish a running job from completion.
  • Extend the existing guide contract test to protect the completion requirement in both entry points.

Fixes #467

@janicduplessis

Copy link
Copy Markdown
Collaborator Author

Independent review is clear at c9630bc. Reviewer independently verified all 30 guide tests and both built guide entry points. All local repository checks passed: 3,617 tests and 66 e2e tests, plus formatting, lint, build, typecheck, runtime-floor and knip.

@janicduplessis
janicduplessis marked this pull request as ready for review September 7, 2026 01:39
@janicduplessis
janicduplessis merged commit 35a77e4 into main Sep 7, 2026
5 checks passed
@janicduplessis
janicduplessis deleted the docs/warm-completion-467 branch September 7, 2026 01:43
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.

Clarify that worktree warming must finish before starting the app

1 participant