docs: align high-assurance workflow gates

Author: officialasishkumar

docs/quickstart.md

@@ -10,13 +10,13 @@ This guide will help you get started with Spec-Driven Development using Spec Kit
 > [!TIP]
 > **Context Awareness**: Spec Kit commands automatically detect the active feature based on your current Git branch (e.g., `001-feature-name`). To switch between different specifications, simply switch Git branches.
 
-For quick experiments, you can move directly from `specify` to `plan`, `tasks`, and `implement`. For production features or any work with meaningful ambiguity, treat `clarify`, `checklist`, and `analyze` as regular quality gates:
+For quick experiments, you can move directly from `/speckit.specify` to `/speckit.plan`, `/speckit.tasks`, and `/speckit.implement`. For production features or any work with meaningful ambiguity, treat `/speckit.clarify`, `/speckit.checklist`, and `/speckit.analyze` as regular quality gates:
 
 ```text
-/speckit.specify -> /speckit.clarify -> /speckit.plan -> /speckit.tasks -> /speckit.checklist -> /speckit.analyze -> /speckit.implement
+/speckit.specify -> /speckit.clarify -> /speckit.checklist -> /speckit.plan -> /speckit.tasks -> /speckit.implement -> /speckit.analyze
 ```
 
-Use `clarify` to reduce requirement ambiguity before planning, `checklist` to validate requirements quality before implementation, and `analyze` to check spec/plan/task consistency before implementation starts.
+Use `/speckit.clarify` to reduce requirement ambiguity before planning, `/speckit.checklist` to validate requirements quality before planning, and `/speckit.analyze` as a final consistency check after implementation.
 
 ### Step 1: Install Specify
 
@@ -67,14 +67,20 @@ uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAME
 /speckit.specify Build an application that can help me organize my photos in separate photo albums. Albums are grouped by date and can be re-organized by dragging and dropping on the main page. Albums are never in other nested albums. Within each album, photos are previewed in a tile-like interface.
 ```
 
-### Step 4: Refine the Spec
+### Step 4: Refine and Validate the Spec
 
 **In the chat**, use the `/speckit.clarify` slash command to identify and resolve ambiguities in your specification. You can provide specific focus areas as arguments.
 
 ```bash
 /speckit.clarify Focus on security and performance requirements.
 ```
 
+Then validate the requirements with `/speckit.checklist` before creating the technical plan:
+
+```bash
+/speckit.checklist
+```
+
 ### Step 5: Create a Technical Implementation Plan
 
 **In the chat**, use the `/speckit.plan` slash command to provide your tech stack and architecture choices.
@@ -83,30 +89,24 @@ uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAME
 /speckit.plan The application uses Vite with minimal number of libraries. Use vanilla HTML, CSS, and JavaScript as much as possible. Images are not uploaded anywhere and metadata is stored in a local SQLite database.
 ```
 
-### Step 6: Break Down, Analyze, and Implement
+### Step 6: Break Down, Implement, and Analyze
 
 **In the chat**, use the `/speckit.tasks` slash command to create an actionable task list.
 
 ```markdown
 /speckit.tasks
 ```
 
-Validate the requirements with `/speckit.checklist`:
-
-```bash
-/speckit.checklist
-```
-
-Validate cross-artifact consistency with `/speckit.analyze` before implementation:
+Use the `/speckit.implement` slash command to execute the plan.
 
 ```markdown
-/speckit.analyze
+/speckit.implement
 ```
 
-Then, use the `/speckit.implement` slash command to execute the plan.
+After implementation, use `/speckit.analyze` as a final consistency check:
 
 ```markdown
-/speckit.implement
+/speckit.analyze
 ```
 
 > [!TIP]
@@ -174,18 +174,18 @@ Generate an actionable task list using the `/speckit.tasks` command:
 /speckit.tasks
 ```
 
-### Step 7: Validate and Implement
+### Step 7: Implement and Analyze
 
-Have your coding agent audit the implementation plan using `/speckit.analyze`:
+Finally, implement the solution:
 
 ```bash
-/speckit.analyze
+/speckit.implement
 ```
 
-Finally, implement the solution:
+Then use `/speckit.analyze` as the final quality gate:
 
 ```bash
-/speckit.implement
+/speckit.analyze
 ```
 
 > [!TIP]