Skip to content

Comments

docs: Fix doc missing step#1496

Merged
mnriem merged 3 commits intogithub:mainfrom
emi-dm:fix-doc-phases
Feb 23, 2026
Merged

docs: Fix doc missing step#1496
mnriem merged 3 commits intogithub:mainfrom
emi-dm:fix-doc-phases

Conversation

@emi-dm
Copy link
Contributor

@emi-dm emi-dm commented Jan 20, 2026

This pull request updates the docs/quickstart.md documentation to improve guidance for users implementing projects with the tool. The main changes clarify the workflow by introducing a new task definition step, and provide tips on phased implementation for complex projects.

Workflow improvements:

  • Added a missing step for generating an actionable task list using the /speckit.tasks command, clarifying the process between checklist validation and technical planning.
  • Updated step headings and order to reflect the new workflow: defining tasks precedes generating the technical plan, and validation/implementation is now a later step.

Guidance on phased implementation:

  • Added a tip recommending phased implementation for complex projects to avoid overwhelming the agent's context, both in the general workflow and in the Taskify example.

Copilot AI review requested due to automatic review settings January 20, 2026 11:00
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request updates the quickstart documentation to add a missing workflow step and provide guidance on phased implementation for complex projects. The changes aim to clarify the development process by explicitly separating task definition from technical planning.

Changes:

  • Added two tips recommending phased implementation to avoid overwhelming the agent's context
  • Introduced a new Step 5 in the detailed example for generating tasks with /speckit.tasks
  • Renumbered subsequent steps in the detailed example (former Step 5→6, former Step 6→7)

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@dancer1325
Copy link

dancer1325 commented Feb 15, 2026

  • +1 confirm that the step (/speckit.tasks) is missing in the
## Detailed Example: Building Taskify

Error running the steps explained directly here
image

  • +1 to add step7 here ALSO (defined as 7 steps in README.md == avoid misleading)

@mnriem mnriem merged commit c1034f1 into github:main Feb 23, 2026
8 checks passed
@emi-dm emi-dm deleted the fix-doc-phases branch February 23, 2026 17:42
brianluby pushed a commit to brianluby/spec-kit that referenced this pull request Feb 24, 2026
* docs: Fix doc missing step

* docs: Update steps for generating technical plan and defining tasks
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.

3 participants