docs: add hands-off orchestration example#2801
Open
meow2149 wants to merge 3 commits into
Open
Conversation
Signed-off-by: meow2149 <maojiuyuqi794@gmail.com> Co-authored-by: Cursor <cursoragent@cursor.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a new community documentation page demonstrating an artifact-first “hands-off orchestration” flow (specify → clarify → plan → checklist → tasks → analyze) with explicit stop conditions before issue creation or implementation, and links it into the docs navigation.
Changes:
- Add a new “Hands-Off Orchestration” community doc page with guardrails and copy/paste prompts.
- Link the new page from the Community TOC and the Community Walkthroughs index.
Show a summary per file
| File | Description |
|---|---|
| docs/toc.yml | Adds a new Community nav entry for the hands-off orchestration page. |
| docs/community/walkthroughs.md | Adds a bullet linking to the new hands-off orchestration doc from the walkthroughs index. |
| docs/community/hands-off-orchestration.md | Introduces a new documentation example describing the hands-off orchestration pattern and prompts. |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 3/3 changed files
- Comments generated: 4
Signed-off-by: meow2149 <maojiuyuqi794@gmail.com> Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
| /speckit.specify -> /speckit.clarify -> /speckit.checklist -> /speckit.plan -> /speckit.tasks -> /speckit.analyze | ||
| ``` | ||
|
|
||
| The key rule is that the agent stops after analysis unless the user explicitly asks it to continue. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Adds a website documentation example for an artifact-first hands-off orchestration pattern. The example follows the maintainer direction in #2789 to start with a docs example, and shows how to run specify, clarify, plan, checklist, tasks, and analyze before stopping unless the user explicitly opts into issue creation or implementation.
Fixes #2789
Testing
uv run specify --helpuv sync && uv run pytestAdditional validation:
git diff --checknpx -y markdownlint-cli2 "docs/community/hands-off-orchestration.md" "docs/community/walkthroughs.md"AI Disclosure
This PR was prepared with Cursor AI assistance. I reviewed the issue discussion, scoped the change to documentation, ran local validation, and created this draft PR for maintainer feedback.
Made with Cursor