From c1034f1d9d0dc924ec0f0b515659e5a5f30c41cb Mon Sep 17 00:00:00 2001 From: Emi <140513018+emi-dm@users.noreply.github.com> Date: Mon, 23 Feb 2026 18:40:41 +0100 Subject: [PATCH] docs: Fix doc missing step (#1496) * docs: Fix doc missing step * docs: Update steps for generating technical plan and defining tasks --- docs/quickstart.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/docs/quickstart.md b/docs/quickstart.md index 4d3b863b..37d431db 100644 --- a/docs/quickstart.md +++ b/docs/quickstart.md @@ -81,6 +81,9 @@ Then, use the `/speckit.implement` slash command to execute the plan. /speckit.implement ``` +> [!TIP] +> **Phased Implementation**: For complex projects, implement in phases to avoid overwhelming the agent's context. Start with core functionality, validate it works, then add features incrementally. + ## Detailed Example: Building Taskify Here's a complete example of building a team productivity platform: @@ -135,7 +138,15 @@ Be specific about your tech stack and technical requirements: /speckit.plan We are going to generate this using .NET Aspire, using Postgres as the database. The frontend should use Blazor server with drag-and-drop task boards, real-time updates. There should be a REST API created with a projects API, tasks API, and a notifications API. ``` -### Step 6: Validate and Implement +### Step 6: Define Tasks + +Generate an actionable task list using the `/speckit.tasks` command: + +```bash +/speckit.tasks +``` + +### Step 7: Validate and Implement Have your AI agent audit the implementation plan using `/speckit.analyze`: @@ -149,6 +160,9 @@ Finally, implement the solution: /speckit.implement ``` +> [!TIP] +> **Phased Implementation**: For large projects like Taskify, consider implementing in phases (e.g., Phase 1: Basic project/task structure, Phase 2: Kanban functionality, Phase 3: Comments and assignments). This prevents context saturation and allows for validation at each stage. + ## Key Principles - **Be explicit** about what you're building and why