Skip to content
Open
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
67 changes: 67 additions & 0 deletions docs/community/hands-off-orchestration.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
# Hands-Off Orchestration Example

This example shows how to ask an AI coding agent to run a hands-off, artifact-first Spec Kit flow without moving into issue creation or implementation by default.

Use this pattern when you want a repeatable planning pass that produces reviewed artifacts first:

```text
/speckit.specify -> /speckit.clarify -> /speckit.plan -> /speckit.checklist -> /speckit.tasks -> /speckit.analyze
Comment thread
meow2149 marked this conversation as resolved.
Outdated
```

The key rule is that the agent stops after analysis unless the user explicitly asks it to continue.
Comment thread
meow2149 marked this conversation as resolved.

## Guardrails

- Generate and review artifacts before creating issues or writing code.
- Ask the user when a product decision is required.
- Loop back to the earlier stage when a later stage finds stale, incomplete, or inconsistent artifacts.
Comment thread
mnriem marked this conversation as resolved.
Outdated
- Do not run `/speckit.taskstoissues` unless the user explicitly requests issue creation.
- Do not run `/speckit.implement` unless the user explicitly requests implementation.
Comment thread
mnriem marked this conversation as resolved.

## Example Agent Prompt

Copy this prompt into your agent after initializing a Spec Kit project:

```text
Run an artifact-first Spec Kit orchestration flow for the following feature:

<describe the feature here>

Follow this sequence:

1. Run /speckit.specify for the requested feature.
2. Run /speckit.clarify to identify ambiguity. If a real product decision is required, stop and ask me before continuing.
3. Run /speckit.plan after the specification is clear enough to plan.
4. Run /speckit.checklist and fix requirement-quality gaps by looping back to /speckit.clarify or /speckit.specify as needed.
5. Run /speckit.tasks after the plan and checklist are consistent.
6. Run /speckit.analyze to check cross-artifact consistency.
Comment thread
mnriem marked this conversation as resolved.
7. Stop after analysis and report the generated artifacts, open questions, and recommended next step.

Do not create GitHub issues unless I explicitly ask for issue creation.
Do not implement tasks unless I explicitly ask for implementation.
```

## Optional Follow-Up Prompts

After reviewing the generated artifacts, continue with one of these explicit prompts:

```text
Create GitHub issues from the generated tasks, but do not implement them.
Comment thread
mnriem marked this conversation as resolved.
Outdated
```

```text
Implement the generated tasks now.
Comment thread
mnriem marked this conversation as resolved.
Outdated
```

Keeping issue creation and implementation as separate follow-up prompts makes the default flow safe for planning, design review, and handoff scenarios.

## When To Use This Pattern

Use this pattern when:

- A team lead wants implementation-ready artifacts before assigning work.
- A project wants consistent specs, plans, and tasks for every feature request.
- The feature has enough ambiguity that clarification and checklist passes are useful.
- You want automation to prepare work, but not silently create issues or write code.

For smaller experiments, the shorter workflow in the [Quick Start Guide](../quickstart.md) may be enough.
2 changes: 2 additions & 0 deletions docs/community/walkthroughs.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,8 @@

See Spec-Driven Development in action across different scenarios with these community-contributed walkthroughs:

- **[Hands-off orchestration example](hands-off-orchestration.md)** — Shows an artifact-first flow that runs specify, clarify, plan, checklist, tasks, and analyze, then stops before issue creation or implementation unless the user explicitly opts in.
Comment thread
mnriem marked this conversation as resolved.
Outdated

- **[Greenfield .NET CLI tool](https://github.com/mnriem/spec-kit-dotnet-cli-demo)** — Builds a Timezone Utility as a .NET single-binary CLI tool from a blank directory, covering the full spec-kit workflow: constitution, specify, plan, tasks, and multi-pass implement using GitHub Copilot agents.

- **[Greenfield Spring Boot + React platform](https://github.com/mnriem/spec-kit-spring-react-demo)** — Builds an LLM performance analytics platform (REST API, graphs, iteration tracking) from scratch using Spring Boot, embedded React, PostgreSQL, and Docker Compose, with a clarify step and a cross-artifact consistency analysis pass included.
Expand Down
2 changes: 2 additions & 0 deletions docs/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -60,5 +60,7 @@
href: community/presets.md
- name: Walkthroughs
href: community/walkthroughs.md
- name: Hands-Off Orchestration
href: community/hands-off-orchestration.md
- name: Friends
href: community/friends.md