Skip to content

Guide users through the full pipeline after setup - #66

Merged
jacobprall merged 1 commit into
render-examples:mainfrom
jacobprall:setup-next-steps
Oct 27, 2026
Merged

jacobprall merged 1 commit into
render-examples:mainfrom
jacobprall:setup-next-steps

Conversation

@jacobprall

Copy link
Copy Markdown
Collaborator

Fixes #65.

The setup runbook ends with a Triage smoke test that requests no change, so users never see Spec-to-PR or PR Reviewer work. This adds an optional step after the smoke test, following the issue's suggestion.

Changes

  • Setup runbook: new section, "Optional: Run the full pipeline," after Phase 11.
    • A human checkpoint explains the cost: model tokens, Sandbox time, a pushed branch, and a draft PR. The agent asks before creating the issue and before each label.
    • Suggested request: add a one-sentence FACTORY_TEST.md. It's a new file, so it can't conflict with existing content.
    • If verify is empty, the agent tells the user nothing checks the change before the PR opens.
    • Step by step: factory:triage, review the spec, factory:spec-approved, then factory:pr-review on the draft PR. This includes what happens when Triage asks questions or the spec changes after approval.
    • Autopilot: what factory:autopilot does, and that it never approves or merges.
    • Cleanup: close the draft PR and delete the branch.
  • Handoff report: new Full pipeline: line.
  • Quickstart: "Next steps" links to the new section.

The setup completion criteria are unchanged. The pipeline run stays optional.

Made with Cursor

The Triage smoke test requests no change, so setup never showed Spec-to-PR
or PR Reviewer. Add an optional runbook step that walks a small request
through each stage, or through factory:autopilot, and link it from the
quickstart.

Fixes render-examples#65

Co-authored-by: Cursor <cursoragent@cursor.com>
@jacobprall
jacobprall merged commit 850d6ed into render-examples:main Oct 27, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

Setup runbook does not say what to try after the smoke test

1 participant