feat(knowledge): Phase 6 — retrieval integration

skills/continue-bugfix/SKILL.md

@@ -66,7 +66,7 @@ Invoke the `/workflow-migrate` skill and follow its instructions exactly — if
 
 ### Step 0.3: Knowledge Check
 
-Load **[knowledge-check.md](../workflow-shared/references/knowledge-check.md)** and follow its instructions as written.
+Load **[knowledge-check.md](../workflow-knowledge/references/knowledge-check.md)** and follow its instructions as written.
 
 → Proceed to **Step 1**.
 

skills/continue-cross-cutting/SKILL.md

@@ -66,7 +66,7 @@ Invoke the `/workflow-migrate` skill and follow its instructions exactly — if
 
 ### Step 0.3: Knowledge Check
 
-Load **[knowledge-check.md](../workflow-shared/references/knowledge-check.md)** and follow its instructions as written.
+Load **[knowledge-check.md](../workflow-knowledge/references/knowledge-check.md)** and follow its instructions as written.
 
 → Proceed to **Step 1**.
 

skills/continue-epic/SKILL.md

@@ -66,7 +66,7 @@ Invoke the `/workflow-migrate` skill and follow its instructions exactly — if
 
 ### Step 0.3: Knowledge Check
 
-Load **[knowledge-check.md](../workflow-shared/references/knowledge-check.md)** and follow its instructions as written.
+Load **[knowledge-check.md](../workflow-knowledge/references/knowledge-check.md)** and follow its instructions as written.
 
 → Proceed to **Step 1**.
 

skills/continue-feature/SKILL.md

@@ -66,7 +66,7 @@ Invoke the `/workflow-migrate` skill and follow its instructions exactly — if
 
 ### Step 0.3: Knowledge Check
 
-Load **[knowledge-check.md](../workflow-shared/references/knowledge-check.md)** and follow its instructions as written.
+Load **[knowledge-check.md](../workflow-knowledge/references/knowledge-check.md)** and follow its instructions as written.
 
 → Proceed to **Step 1**.
 

skills/continue-quickfix/SKILL.md

@@ -66,7 +66,7 @@ Invoke the `/workflow-migrate` skill and follow its instructions exactly — if
 
 ### Step 0.3: Knowledge Check
 
-Load **[knowledge-check.md](../workflow-shared/references/knowledge-check.md)** and follow its instructions as written.
+Load **[knowledge-check.md](../workflow-knowledge/references/knowledge-check.md)** and follow its instructions as written.
 
 → Proceed to **Step 1**.
 

skills/start-bugfix/SKILL.md

@@ -73,7 +73,7 @@ Invoke the `/workflow-migrate` skill and follow its instructions exactly — if
 > then hand off to investigation to diagnose the root cause.
 ```
 
-Load **[knowledge-check.md](../workflow-shared/references/knowledge-check.md)** and follow its instructions as written.
+Load **[knowledge-check.md](../workflow-knowledge/references/knowledge-check.md)** and follow its instructions as written.
 
 → Proceed to **Step 1**.
 

skills/start-cross-cutting/SKILL.md

@@ -75,7 +75,7 @@ Invoke the `/workflow-migrate` skill and follow its instructions exactly — if
 > pipeline ends at specification — no planning or implementation.
 ```
 
-Load **[knowledge-check.md](../workflow-shared/references/knowledge-check.md)** and follow its instructions as written.
+Load **[knowledge-check.md](../workflow-knowledge/references/knowledge-check.md)** and follow its instructions as written.
 
 → Proceed to **Step 1**.
 

skills/start-epic/SKILL.md

@@ -74,7 +74,7 @@ Invoke the `/workflow-migrate` skill and follow its instructions exactly — if
 > straight to discussion.
 ```
 
-Load **[knowledge-check.md](../workflow-shared/references/knowledge-check.md)** and follow its instructions as written.
+Load **[knowledge-check.md](../workflow-knowledge/references/knowledge-check.md)** and follow its instructions as written.
 
 → Proceed to **Step 1**.
 

skills/start-feature/SKILL.md

@@ -74,7 +74,7 @@ Invoke the `/workflow-migrate` skill and follow its instructions exactly — if
 > to discussion.
 ```
 
-Load **[knowledge-check.md](../workflow-shared/references/knowledge-check.md)** and follow its instructions as written.
+Load **[knowledge-check.md](../workflow-knowledge/references/knowledge-check.md)** and follow its instructions as written.
 
 → Proceed to **Step 1**.
 

skills/start-quickfix/SKILL.md

@@ -74,7 +74,7 @@ Invoke the `/workflow-migrate` skill and follow its instructions exactly — if
 > and plan into a single streamlined pass.
 ```
 
-Load **[knowledge-check.md](../workflow-shared/references/knowledge-check.md)** and follow its instructions as written.
+Load **[knowledge-check.md](../workflow-knowledge/references/knowledge-check.md)** and follow its instructions as written.
 
 → Proceed to **Step 1**.
 

skills/workflow-discussion-process/SKILL.md

@@ -126,7 +126,49 @@ Load **[discussion-guidelines.md](references/discussion-guidelines.md)** and fol
 
 ---
 
-## Step 3: Discussion Session
+## Step 3: Knowledge Usage
+
+> *Output the next fenced block as a code block:*
+
+```
+── Knowledge Usage ──────────────────────────────
+```
+
+> *Output the next fenced block as markdown (not a code block):*
+
+```
+> Loading the usage guide for the knowledge base so
+> proactive querying is available throughout the discussion.
+```
+
+Load **[knowledge-usage.md](../workflow-knowledge/references/knowledge-usage.md)** and follow its instructions as written.
+
+→ Proceed to **Step 4**.
+
+---
+
+## Step 4: Contextual Query
+
+> *Output the next fenced block as a code block:*
+
+```
+── Contextual Query ─────────────────────────────
+```
+
+> *Output the next fenced block as markdown (not a code block):*
+
+```
+> Checking the knowledge base for prior work that relates
+> to this discussion topic before the session begins.
+```
+
+Load **[contextual-query.md](../workflow-knowledge/references/contextual-query.md)** and follow its instructions as written.
+
+→ Proceed to **Step 5**.
+
+---
+
+## Step 5: Discussion Session
 
 > *Output the next fenced block as a code block:*
 
@@ -144,11 +186,13 @@ Load **[discussion-guidelines.md](references/discussion-guidelines.md)** and fol
 
 Load **[discussion-session.md](references/discussion-session.md)** and follow its instructions as written.
 
-→ Proceed to **Step 4**.
+*Knowledge-base nudge — before committing to a direction on a new subtopic, or when a decision might echo one made elsewhere, run a quick query. See **[knowledge-usage.md](../workflow-knowledge/references/knowledge-usage.md)**.*
+
+→ Proceed to **Step 6**.
 
 ---
 
-## Step 4: Final Gap Review
+## Step 6: Final Gap Review
 
 > *Output the next fenced block as a code block:*
 
@@ -165,11 +209,11 @@ Load **[discussion-session.md](references/discussion-session.md)** and follow it
 
 Load **[final-review.md](references/final-review.md)** and follow its instructions as written.
 
-→ Proceed to **Step 5**.
+→ Proceed to **Step 7**.
 
 ---
 
-## Step 5: Document Review
+## Step 7: Document Review
 
 > *Output the next fenced block as a code block:*
 
@@ -186,11 +230,11 @@ Load **[final-review.md](references/final-review.md)** and follow its instructio
 
 Load **[document-review.md](references/document-review.md)** and follow its instructions as written.
 
-→ Proceed to **Step 6**.
+→ Proceed to **Step 8**.
 
 ---
 
-## Step 6: Compliance Self-Check
+## Step 8: Compliance Self-Check
 
 > *Output the next fenced block as a code block:*
 
@@ -206,11 +250,11 @@ Load **[document-review.md](references/document-review.md)** and follow its inst
 
 Load **[compliance-check.md](../workflow-shared/references/compliance-check.md)** and follow its instructions as written.
 
-→ Proceed to **Step 7**.
+→ Proceed to **Step 9**.
 
 ---
 
-## Step 7: Conclude Discussion
+## Step 9: Conclude Discussion
 
 > *Output the next fenced block as a code block:*
 

skills/workflow-discussion-process/references/conclude-discussion.md

@@ -63,4 +63,4 @@ Invoke the workflow-bridge skill to enter plan mode with continuation instructio
 
 #### If `no`
 
-→ Return to **[the skill](../SKILL.md)** for **Step 3**.
+→ Return to **[the skill](../SKILL.md)** for **Step 5**.

skills/workflow-discussion-process/references/final-review.md

@@ -6,7 +6,7 @@
 
 A final review ensures the discussion is thorough before moving to specification. Even if review agents ran during the session, the discussion may have progressed significantly since the last one.
 
-This step runs once per "user signals done" entry. It dispatches a fresh review if needed, raises one finding via the shared protocol, then bounces back to the discussion session so the user can engage naturally. The next time the user signals done, Step 4 re-runs — eventually all findings are drained and the file transitions to `incorporated`, at which point Step 4 returns to the backbone to proceed toward conclusion.
+This step runs once per "user signals done" entry. It dispatches a fresh review if needed, raises one finding via the shared protocol, then bounces back to the discussion session so the user can engage naturally. The next time the user signals done, Step 6 re-runs — eventually all findings are drained and the file transitions to `incorporated`, at which point Step 6 returns to the backbone to proceed toward conclusion.
 
 The **never-dump rules apply in full**. Findings are raised one at a time via the shared surfacing protocol.
 
@@ -116,6 +116,6 @@ All findings have been raised (or the review came back with zero gaps). The fina
 
 #### If `status: acknowledged`
 
-Either a finding was just raised, or the announce menu was just shown and the user picked `later`. Control belongs to the conversation — return the user to the discussion session so they can engage naturally. The session loop's check-for-results will pick up subsequent findings at natural breaks. When the user signals done again, Step 4 re-runs and this flow resumes.
+Either a finding was just raised, or the announce menu was just shown and the user picked `later`. Control belongs to the conversation — return the user to the discussion session so they can engage naturally. The session loop's check-for-results will pick up subsequent findings at natural breaks. When the user signals done again, Step 6 re-runs and this flow resumes.
 
-→ Return to **[the skill](../SKILL.md)** for **Step 3**.
+→ Return to **[the skill](../SKILL.md)** for **Step 5**.

skills/workflow-implementation-process/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: workflow-implementation-process
 user-invocable: false
-allowed-tools: Bash(node .claude/skills/workflow-manifest/scripts/manifest.cjs)
+allowed-tools: Bash(node .claude/skills/workflow-manifest/scripts/manifest.cjs), Bash(node .claude/skills/workflow-knowledge/scripts/knowledge.cjs)
 ---
 
 # Implementation Process
@@ -195,7 +195,28 @@ Load **[linter-setup.md](references/linter-setup.md)** and follow its instructio
 
 ---
 
-## Step 6: Task Loop
+## Step 6: Knowledge Usage
+
+> *Output the next fenced block as a code block:*
+
+```
+── Knowledge Usage ──────────────────────────────
+```
+
+> *Output the next fenced block as markdown (not a code block):*
+
+```
+> Loading the usage guide for the knowledge base so
+> proactive querying is available while tasks execute.
+```
+
+Load **[knowledge-usage.md](../workflow-knowledge/references/knowledge-usage.md)** and follow its instructions as written.
+
+→ Proceed to **Step 7**.
+
+---
+
+## Step 7: Task Loop
 
 > *Output the next fenced block as a code block:*
 
@@ -213,21 +234,23 @@ Load **[linter-setup.md](references/linter-setup.md)** and follow its instructio
 
 Load **[task-loop.md](references/task-loop.md)** and follow its instructions as written.
 
+*Knowledge-base nudge — code is the source of truth for *what* exists; read it rather than query. Reach for the KB only when you need the *why* behind an existing pattern (rare). Never to fill spec gaps — those are blockers. See **[knowledge-usage.md](../workflow-knowledge/references/knowledge-usage.md)**.*
+
 After the loop completes:
 
 #### If the task loop exited early (user chose `stop`)
 
-→ Proceed to **Step 8**.
+→ Proceed to **Step 9**.
 
 #### Otherwise
 
-**CRITICAL**: This routing applies on **every** task loop completion — including after returning from Step 7 with analysis-created tasks. Step 6 and Step 7 form a mandatory cycle: tasks execute → analysis runs → new tasks may be created → tasks execute again → analysis runs again. Never skip Step 7 after a task loop completes.
+**CRITICAL**: This routing applies on **every** task loop completion — including after returning from Step 8 with analysis-created tasks. Step 7 and Step 8 form a mandatory cycle: tasks execute → analysis runs → new tasks may be created → tasks execute again → analysis runs again. Never skip Step 8 after a task loop completes.
 
-→ Proceed to **Step 7**.
+→ Proceed to **Step 8**.
 
 ---
 
-## Step 7: Analysis Loop
+## Step 8: Analysis Loop
 
 > *Output the next fenced block as a code block:*
 
@@ -247,15 +270,15 @@ Load **[analysis-loop.md](references/analysis-loop.md)** and follow its instruct
 
 #### If new tasks were created in the plan
 
-→ Return to **Step 6**.
+→ Return to **Step 7**.
 
 #### If no tasks were created
 
-→ Proceed to **Step 8**.
+→ Proceed to **Step 9**.
 
 ---
 
-## Step 8: Compliance Self-Check
+## Step 9: Compliance Self-Check
 
 > *Output the next fenced block as a code block:*
 
@@ -271,11 +294,11 @@ Load **[analysis-loop.md](references/analysis-loop.md)** and follow its instruct
 
 Load **[compliance-check.md](../workflow-shared/references/compliance-check.md)** and follow its instructions as written.
 
-→ Proceed to **Step 9**.
+→ Proceed to **Step 10**.
 
 ---
 
-## Step 9: Mark Implementation Complete
+## Step 10: Mark Implementation Complete
 
 > *Output the next fenced block as a code block:*
 

skills/workflow-implementation-process/references/analysis-loop.md

@@ -55,7 +55,7 @@ You MUST NOT choose on the user's behalf.
 
 **If `skip`:**
 
-→ Return to **[the skill](../SKILL.md)** for **Step 8**.
+→ Return to **[the skill](../SKILL.md)** for **Step 9**.
 
 ---
 
@@ -139,7 +139,7 @@ impl({work_unit}): analysis cycle {N} — findings
 
 #### If all three agents returned `STATUS: clean`
 
-→ Return to **[the skill](../SKILL.md)** for **Step 8**.
+→ Return to **[the skill](../SKILL.md)** for **Step 9**.
 
 #### Otherwise
 
@@ -161,7 +161,7 @@ impl({work_unit}): analysis cycle {N} — synthesis
 
 #### If `STATUS` is `clean`
 
-→ Return to **[the skill](../SKILL.md)** for **Step 8**.
+→ Return to **[the skill](../SKILL.md)** for **Step 9**.
 
 #### If `STATUS` is `tasks_proposed`
 
@@ -289,7 +289,7 @@ Commit the staging file updates:
 impl({work_unit}): analysis cycle {N} — tasks skipped
 ```
 
-→ Return to **[the skill](../SKILL.md)** for **Step 8**.
+→ Return to **[the skill](../SKILL.md)** for **Step 9**.
 
 ---
 

skills/workflow-implementation-process/references/conclude-implementation.md

@@ -19,7 +19,7 @@ Ready to mark implementation as completed?
 
 #### If `no`
 
-→ Return to **[the skill](../SKILL.md)** for **Step 6**.
+→ Return to **[the skill](../SKILL.md)** for **Step 7**.
 
 #### If `yes`
 

skills/workflow-implementation-process/references/task-loop.md

@@ -94,7 +94,7 @@ Task failed. How would you like to proceed?
 
 #### If `stop`
 
-→ Return to **[the skill](../SKILL.md)** for **Step 8**.
+→ Return to **[the skill](../SKILL.md)** for **Step 9**.
 
 ---