knowzcode 0.1.0 → 0.3.1

package/knowzcode/prompts/[LOOP_2A]__Implement_Change_Set.md

@@ -1,55 +1,55 @@
-# KnowzCode: [LOOP 2A] Authorize Implementation
-
-**WorkGroupID for Implementation:**
-[Orchestrator: Re-state the `WorkGroupID` that you have reviewed and are now approving for implementation. This confirms all associated specs are approved.]
-
-> **Automation Path:** Use `/kc-step phase=2A workgroup_id=<ID>` to activate the `builder` subagent. The command enforces the `environment-guard` skill and writes back tracker updates once the loop instructions are complete.
-
-**Remember:**
-- Cross-check code updates against the latest specs and refresh them if implementation diverges.
-- Record in-progress work and emerging tasks in `knowzcode/workgroups/<WorkGroupID>.md`, keeping every todo prefixed with `KnowzCode:`.
-
-**WorkGroupID:** `[wip-timestamp-to-implement]`
-
----
-
-## Your Mission
-You are authorized to begin the core development phase for the specified `WorkGroupID`. All associated specifications are approved.
-
-Your task is to autonomously execute the planning, committing, implementation, and initial verification cycle. Your work on this prompt begins at **Step 4** of the `knowzcode_loop.md` and is considered complete only after **Step 6A** has passed successfully.
-
-**NOTE:** Your implementation will be independently audited for completeness in Loop 2B after you report success here.
-
-**Reference:** Your actions are governed by `knowzcode_loop.md`, executing the sequence from **Step 4 (ARC-Principle-Based Planning)** through to the completion of **Step 6A (Implementation & Initial Verification)**.
-
----
-
-### Execution Protocol
-
-1.  **Plan & Commit (Step 4):**
-    *   Develop your internal implementation plan for the entire Change Set.
-    *   **CRITICAL CHECKPOINT:** After developing your plan, evaluate its complexity. If the plan is exceptionally complex or high-risk, you **MUST PAUSE** now and present the plan for Orchestrator review as per Step 4.2 of the loop. If the plan is straightforward, proceed.
-    *   Perform the **Pre-Implementation Commit** as per Step 4.3.
-
-2.  **Implement (Step 5):**
-    *   Execute your plan, creating and modifying all necessary code to fulfill the specs for the *entire* Change Set.
-
-3.  **Verify (Step 6A):**
-    *   Conduct a full initial verification of the *entire* Change Set, following the iterative "fix and re-verify" cycle as detailed in `knowzcode_loop.md`.
-
-### Reporting
-
-*   **On Success:** Once the entire Change Set has passed all verification steps defined in Step 6A, report your success and readiness for the audit.
-    *   **Success Report:**
-    > "Implementation and Initial Verification for `WorkGroupID: [ID]` (Steps 4-6A) is complete. All code has been written, and all self-conducted tests and ARC criteria have passed. The Change Set is now ready for the Loop 2B Implementation Completeness Audit. Awaiting the `[LOOP_2B]__Verify_Implementation.md` command."
-
-*   **On Blocker:** If you pause at the planning checkpoint, or encounter an unresolvable issue, report the specific blocker.
-    *   **Blocker Report:**
-    > "Execution paused for `WorkGroupID: [ID]`. [Clearly describe the blocker...]"
-
-### Final State & Next Prompt
-
-*   Upon successful completion, you will **PAUSE**.
-*   The next command from the Orchestrator for this `WorkGroupID` will be **`[LOOP_2B]__Verify_Implementation.md`**.
-
----
+# KnowzCode: [LOOP 2A] Authorize Implementation
+
+**WorkGroupID for Implementation:**
+[Orchestrator: Re-state the `WorkGroupID` that you have reviewed and are now approving for implementation. This confirms all associated specs are approved.]
+
+> **Automation Path:** Use `/kc-step phase=2A workgroup_id=<ID>` to activate the `builder` subagent. The command enforces the `environment-guard` skill and writes back tracker updates once the loop instructions are complete.
+
+**Remember:**
+- Cross-check code updates against the latest specs and refresh them if implementation diverges.
+- Record in-progress work and emerging tasks in `knowzcode/workgroups/<WorkGroupID>.md`, keeping every todo prefixed with `KnowzCode:`.
+
+**WorkGroupID:** `[wip-timestamp-to-implement]`
+
+---
+
+## Your Mission
+You are authorized to begin the core development phase for the specified `WorkGroupID`. All associated specifications are approved.
+
+Your task is to autonomously execute the planning, committing, implementation, and initial verification cycle. Your work on this prompt begins at **Step 4** of the `knowzcode_loop.md` and is considered complete only after **Step 6A** has passed successfully.
+
+**NOTE:** Your implementation will be independently audited for completeness in Loop 2B after you report success here.
+
+**Reference:** Your actions are governed by `knowzcode_loop.md`, executing the sequence from **Step 4 (ARC-Principle-Based Planning)** through to the completion of **Step 6A (Implementation & Initial Verification)**.
+
+---
+
+### Execution Protocol
+
+1.  **Plan & Commit (Step 4):**
+    *   Develop your internal implementation plan for the entire Change Set.
+    *   **CRITICAL CHECKPOINT:** After developing your plan, evaluate its complexity. If the plan is exceptionally complex or high-risk, you **MUST PAUSE** now and present the plan for Orchestrator review as per Step 4.2 of the loop. If the plan is straightforward, proceed.
+    *   Perform the **Pre-Implementation Commit** as per Step 4.3.
+
+2.  **Implement (Step 5):**
+    *   Execute your plan, creating and modifying all necessary code to fulfill the specs for the *entire* Change Set.
+
+3.  **Verify (Step 6A):**
+    *   Conduct a full initial verification of the *entire* Change Set, following the iterative "fix and re-verify" cycle as detailed in `knowzcode_loop.md`.
+
+### Reporting
+
+*   **On Success:** Once the entire Change Set has passed all verification steps defined in Step 6A, report your success and readiness for the audit.
+    *   **Success Report:**
+    > "Implementation and Initial Verification for `WorkGroupID: [ID]` (Steps 4-6A) is complete. All code has been written, and all self-conducted tests and ARC criteria have passed. The Change Set is now ready for the Loop 2B Implementation Completeness Audit. Awaiting the `[LOOP_2B]__Verify_Implementation.md` command."
+
+*   **On Blocker:** If you pause at the planning checkpoint, or encounter an unresolvable issue, report the specific blocker.
+    *   **Blocker Report:**
+    > "Execution paused for `WorkGroupID: [ID]`. [Clearly describe the blocker...]"
+
+### Final State & Next Prompt
+
+*   Upon successful completion, you will **PAUSE**.
+*   The next command from the Orchestrator for this `WorkGroupID` will be **`[LOOP_2B]__Verify_Implementation.md`**.
+
+---

package/knowzcode/prompts/[LOOP_2B]__Verify_Implementation.md

@@ -1,72 +1,72 @@
-# KnowzCode: [LOOP 2B] Verify Implementation Completeness
-
-**WorkGroupID for Audit:**
-[Orchestrator: Re-state the `WorkGroupID` that has completed Loop 2A and requires an implementation audit.]
-
-> **Automation Path:** Trigger `/kc-step phase=2B workgroup_id=<ID>` or `/kc-audit audit=implementation workgroup_id=<ID>` to run the `reviewer` subagent in read-only mode. It utilizes `spec-quality-check`, `tracker-scan`, and `log-entry-builder` skills to compute the completion percentage.
-
-**Remember:**
-- Flag any spec discrepancies you uncover and update the relevant files in `knowzcode/specs/`.
-- Add follow-up todos to `knowzcode/workgroups/<WorkGroupID>.md` (each entry prefixed `KnowzCode:`) so unresolved work is obvious.
-
-**WorkGroupID:** `[wip-timestamp-to-audit]`
-
----
-
-## Your Mission
-This is a **READ-ONLY** quality gate to audit the completeness of the implementation for the given `WorkGroupID`. You will compare the work done against the approved specifications and report an objective completion percentage.
-
-**CRITICAL RULE: You MUST NOT modify any files. This is a verification step, not a correction step.**
-
-**Reference:** Your actions are governed by `knowzcode_loop.md`, executing the audit defined in **Step 6B**.
-
----
-
-### Execution Protocol
-
-#### Phase 0: Reconnaissance (READ-ONLY)
-1.  **Identify Audit Scope:** Get all `NodeID`s associated with the `WorkGroupID` from `knowzcode_tracker.md`.
-2.  **List Artifacts:** List all source code files that were created or modified for this `WorkGroupID`.
-3.  **Map Built Features:** Briefly map what was built (e.g., components, functions, features, tests).
-
-#### Phase 1: Specification-to-Code Audit
-1.  **Load Specs:** For each `NodeID` in your scope, load its approved specification from `specs/`.
-2.  **Verify Spec-to-Code:** For each spec, systematically verify that every requirement, function, and error handling case listed in the spec has been implemented in the code.
-3.  **Verify Code-to-Spec:** Check for any "orphan" code—features or functions that were implemented but are not described in any specification.
-4.  **Calculate Completion:** Based on your findings, calculate an objective, quantitative **completion percentage**. (e.g., "8 of 10 requirements implemented = 80% complete").
-
-#### Phase 2: Synthesize Findings & Report
-*   Compile a single, comprehensive audit report.
-
-### Audit Report Structure
-
-Your report **must** include the following sections:
-> **WorkGroupID:** `[ID]`
-> **Overall Implementation Completion:** [Calculated Percentage]%
->
-> **1. Fully Implemented Requirements:**
-> *   [List of spec requirements that are 100% complete]
->
-> **2. Partially Implemented Requirements:**
-> *   [Requirement X]: Implemented basic case, but missing error handling for [condition].
-> *   [Requirement Y]: Feature exists, but is missing [specific part].
->
-> **3. Not Implemented Requirements:**
-> *   [List of spec requirements that were not implemented at all]
->
-> **4. Orphan Code (Not in Specs):**
-> *   [Function `calculate_extra_value()` in `file.py` has no corresponding spec requirement.]
->
-> **5. Risk Assessment:**
-> *   [Brief assessment of the risk of proceeding with the current implementation state. e.g., "Low risk, missing features are non-critical." or "High risk, core security function is incomplete."]
->
-> **Awaiting Orchestrator decision.**
-
-### Orchestrator Decision Points
-Based on your report, the Orchestrator will choose one of the following paths:
-*   **(A) Complete Gaps:** Return to implementation (Step 5) to address the identified gaps.
-*   **(B) Accept & Proceed:** Accept the current implementation as-is and proceed to Loop 3 for finalization.
-*   **(C) Modify Specs:** Update the specifications to match the "as-built" code, formally accepting the deviations.
-*   **(D) Cancel:** Cancel the WorkGroupID and potentially revert the changes.
-
----
+# KnowzCode: [LOOP 2B] Verify Implementation Completeness
+
+**WorkGroupID for Audit:**
+[Orchestrator: Re-state the `WorkGroupID` that has completed Loop 2A and requires an implementation audit.]
+
+> **Automation Path:** Trigger `/kc-step phase=2B workgroup_id=<ID>` or `/kc-audit audit=implementation workgroup_id=<ID>` to run the `reviewer` subagent in read-only mode. It utilizes `spec-quality-check`, `tracker-scan`, and `log-entry-builder` skills to compute the completion percentage.
+
+**Remember:**
+- Flag any spec discrepancies you uncover and update the relevant files in `knowzcode/specs/`.
+- Add follow-up todos to `knowzcode/workgroups/<WorkGroupID>.md` (each entry prefixed `KnowzCode:`) so unresolved work is obvious.
+
+**WorkGroupID:** `[wip-timestamp-to-audit]`
+
+---
+
+## Your Mission
+This is a **READ-ONLY** quality gate to audit the completeness of the implementation for the given `WorkGroupID`. You will compare the work done against the approved specifications and report an objective completion percentage.
+
+**CRITICAL RULE: You MUST NOT modify any files. This is a verification step, not a correction step.**
+
+**Reference:** Your actions are governed by `knowzcode_loop.md`, executing the audit defined in **Step 6B**.
+
+---
+
+### Execution Protocol
+
+#### Phase 0: Reconnaissance (READ-ONLY)
+1.  **Identify Audit Scope:** Get all `NodeID`s associated with the `WorkGroupID` from `knowzcode_tracker.md`.
+2.  **List Artifacts:** List all source code files that were created or modified for this `WorkGroupID`.
+3.  **Map Built Features:** Briefly map what was built (e.g., components, functions, features, tests).
+
+#### Phase 1: Specification-to-Code Audit
+1.  **Load Specs:** For each `NodeID` in your scope, load its approved specification from `specs/`.
+2.  **Verify Spec-to-Code:** For each spec, systematically verify that every requirement, function, and error handling case listed in the spec has been implemented in the code.
+3.  **Verify Code-to-Spec:** Check for any "orphan" code—features or functions that were implemented but are not described in any specification.
+4.  **Calculate Completion:** Based on your findings, calculate an objective, quantitative **completion percentage**. (e.g., "8 of 10 requirements implemented = 80% complete").
+
+#### Phase 2: Synthesize Findings & Report
+*   Compile a single, comprehensive audit report.
+
+### Audit Report Structure
+
+Your report **must** include the following sections:
+> **WorkGroupID:** `[ID]`
+> **Overall Implementation Completion:** [Calculated Percentage]%
+>
+> **1. Fully Implemented Requirements:**
+> *   [List of spec requirements that are 100% complete]
+>
+> **2. Partially Implemented Requirements:**
+> *   [Requirement X]: Implemented basic case, but missing error handling for [condition].
+> *   [Requirement Y]: Feature exists, but is missing [specific part].
+>
+> **3. Not Implemented Requirements:**
+> *   [List of spec requirements that were not implemented at all]
+>
+> **4. Orphan Code (Not in Specs):**
+> *   [Function `calculate_extra_value()` in `file.py` has no corresponding spec requirement.]
+>
+> **5. Risk Assessment:**
+> *   [Brief assessment of the risk of proceeding with the current implementation state. e.g., "Low risk, missing features are non-critical." or "High risk, core security function is incomplete."]
+>
+> **Awaiting Orchestrator decision.**
+
+### Orchestrator Decision Points
+Based on your report, the Orchestrator will choose one of the following paths:
+*   **(A) Complete Gaps:** Return to implementation (Step 5) to address the identified gaps.
+*   **(B) Accept & Proceed:** Accept the current implementation as-is and proceed to Loop 3 for finalization.
+*   **(C) Modify Specs:** Update the specifications to match the "as-built" code, formally accepting the deviations.
+*   **(D) Cancel:** Cancel the WorkGroupID and potentially revert the changes.
+
+---

package/knowzcode/prompts/[LOOP_3]__Finalize_And_Commit.md

@@ -1,67 +1,67 @@
-# KnowzCode: [LOOP 3] Finalize & Commit Change Set
-
-**WorkGroupID for Finalization:**
-[Orchestrator: Re-state the `WorkGroupID` that has passed implementation and verification, authorizing its finalization and commit.]
-
-> **Automation Path:** Execute `/kc-step phase=3 workgroup_id=<ID>` to hand off to the `closer` subagent. It chains `tracker-update`, `log-entry-builder`, and `architecture-diff` skills to wrap up the loop.
-
-**Remember:**
-- Finalize every spec in `knowzcode/specs/` to reflect the as-built system.
-- Close or add remaining todos in `knowzcode/workgroups/<WorkGroupID>.md`, ensuring all entries keep the `KnowzCode:` prefix.
-
-**WorkGroupID:** `[wip-timestamp-to-finalize]`
-
----
-
-## Your Mission
-The implementation and verification for the specified `WorkGroupID` is complete. You are now authorized to execute the final phase of the KnowzCode loop: documentation, logging, and committing.
-
-**CRITICAL RULE: The implementation phase is complete. Your work in this phase is strictly limited to updating KnowzCode's own project and specification files (`.md` files) to reflect the finished work. You MUST NOT write or modify any more application source code (e.g., `.js`, `.py`, `.html` files).**
-
-**Reference:** Your actions are governed by `knowzcode_loop.md`, executing the sequence from **Step 7 through Step 10**.
-
----
-
-### Execution Protocol
-
-1.  **Finalize Specifications (Step 7):**
-    *   For **each** `NodeID` in the `WorkGroupID`, update its spec file in `specs/` to the "as-built" state, ensuring it perfectly reflects the verified code.
-
-2.  **Check Architecture (Step 8):**
-    *   Conduct the Flowchart Consistency Check. If you find a simple discrepancy, fix `knowzcode_architecture.md` directly. If it's complex, document it in the log.
-
-3.  **Log Operation (Step 9):**
-    *   Create the single, comprehensive `ARC-Completion` log entry in `knowzcode_log.md`. Ensure it includes the flowchart check outcome, any unforeseen ripple effects, and project overview updates. Use an environment-sourced timestamp.
-
-4.  **Update Tracker, Schedule Debt, & Check Project Overview (Step 10):**
-    *   **Update Tracker:** In `knowzcode_tracker.md`, mark all nodes in the `WorkGroupID` as `[VERIFIED]` and clear their `WorkGroupID`.
-    *   **Schedule Debt:** Perform the "Technical Debt Scheduling" step. For any nodes with documented debt, create new `REFACTOR_` tasks in the tracker.
-    *   **Update Project Overview:** Check if this Change Set impacts `knowzcode_project.md`:
-        - New major features → Update "Key Features" section
-        - New libraries/tools → Update "Technology Stack" table
-        - Architecture changes → Update "Architecture Decisions"
-        - Scope expansion → Update "Scope & Key Features"
-    *   **Final Commit:** Stage ALL changes using `git add -A` (this includes source code from implementation AND knowzcode/ files), then commit with a descriptive `feat:` message.
-
-### Final Report
-
-*   Once all steps above are complete, provide a final confirmation report.
-
-**Example Response Format:**
-> "Finalization for `WorkGroupID: [ID]` is complete.
->
-> *   All specifications have been updated to the 'as-built' state.
-> *   The architecture flowchart has been checked and updated.
-> *   A complete `ARC-Completion` entry has been logged.
-> *   The tracker is updated, and all nodes are now `[VERIFIED]`.
-> *   **Project Overview Updates:** [None | Updated sections: Technology Stack, Key Features]
-> *   The final `feat:` commit has been made to version control.
-> *   **New Refactor Tasks Created:** [List any REFACTOR_ nodes created, or 'None'].
->
-> This Change Set is now fully complete and documented. Awaiting next `PrimaryGoal` via a new Work Session."
-
-### Final State
-
-*   Upon successful completion, the KnowzCode loop for this `WorkGroupID` is **finished**. You will return to an idle state.
-
----
+# KnowzCode: [LOOP 3] Finalize & Commit Change Set
+
+**WorkGroupID for Finalization:**
+[Orchestrator: Re-state the `WorkGroupID` that has passed implementation and verification, authorizing its finalization and commit.]
+
+> **Automation Path:** Execute `/kc-step phase=3 workgroup_id=<ID>` to hand off to the `closer` subagent. It chains `tracker-update`, `log-entry-builder`, and `architecture-diff` skills to wrap up the loop.
+
+**Remember:**
+- Finalize every spec in `knowzcode/specs/` to reflect the as-built system.
+- Close or add remaining todos in `knowzcode/workgroups/<WorkGroupID>.md`, ensuring all entries keep the `KnowzCode:` prefix.
+
+**WorkGroupID:** `[wip-timestamp-to-finalize]`
+
+---
+
+## Your Mission
+The implementation and verification for the specified `WorkGroupID` is complete. You are now authorized to execute the final phase of the KnowzCode loop: documentation, logging, and committing.
+
+**CRITICAL RULE: The implementation phase is complete. Your work in this phase is strictly limited to updating KnowzCode's own project and specification files (`.md` files) to reflect the finished work. You MUST NOT write or modify any more application source code (e.g., `.js`, `.py`, `.html` files).**
+
+**Reference:** Your actions are governed by `knowzcode_loop.md`, executing the sequence from **Step 7 through Step 10**.
+
+---
+
+### Execution Protocol
+
+1.  **Finalize Specifications (Step 7):**
+    *   For **each** `NodeID` in the `WorkGroupID`, update its spec file in `specs/` to the "as-built" state, ensuring it perfectly reflects the verified code.
+
+2.  **Check Architecture (Step 8):**
+    *   Conduct the Flowchart Consistency Check. If you find a simple discrepancy, fix `knowzcode_architecture.md` directly. If it's complex, document it in the log.
+
+3.  **Log Operation (Step 9):**
+    *   Create the single, comprehensive `ARC-Completion` log entry in `knowzcode_log.md`. Ensure it includes the flowchart check outcome, any unforeseen ripple effects, and project overview updates. Use an environment-sourced timestamp.
+
+4.  **Update Tracker, Schedule Debt, & Check Project Overview (Step 10):**
+    *   **Update Tracker:** In `knowzcode_tracker.md`, mark all nodes in the `WorkGroupID` as `[VERIFIED]` and clear their `WorkGroupID`.
+    *   **Schedule Debt:** Perform the "Technical Debt Scheduling" step. For any nodes with documented debt, create new `REFACTOR_` tasks in the tracker.
+    *   **Update Project Overview:** Check if this Change Set impacts `knowzcode_project.md`:
+        - New major features → Update "Key Features" section
+        - New libraries/tools → Update "Technology Stack" table
+        - Architecture changes → Update "Architecture Decisions"
+        - Scope expansion → Update "Scope & Key Features"
+    *   **Final Commit:** Stage ALL changes using `git add -A` (this includes source code from implementation AND knowzcode/ files), then commit with a descriptive `feat:` message.
+
+### Final Report
+
+*   Once all steps above are complete, provide a final confirmation report.
+
+**Example Response Format:**
+> "Finalization for `WorkGroupID: [ID]` is complete.
+>
+> *   All specifications have been updated to the 'as-built' state.
+> *   The architecture flowchart has been checked and updated.
+> *   A complete `ARC-Completion` entry has been logged.
+> *   The tracker is updated, and all nodes are now `[VERIFIED]`.
+> *   **Project Overview Updates:** [None | Updated sections: Technology Stack, Key Features]
+> *   The final `feat:` commit has been made to version control.
+> *   **New Refactor Tasks Created:** [List any REFACTOR_ nodes created, or 'None'].
+>
+> This Change Set is now fully complete and documented. Awaiting next `PrimaryGoal` via a new Work Session."
+
+### Final State
+
+*   Upon successful completion, the KnowzCode loop for this `WorkGroupID` is **finished**. You will return to an idle state.
+
+---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knowzcode",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "description": "Platform-agnostic AI development methodology with TDD, quality gates, and structured workflows",
   "type": "module",
   "bin": {

package/skills/alias-resolver.json

@@ -1,6 +1,6 @@
 {
   "name": "alias-resolver",
-  "version": "1.0.0",
+  "version": "0.3.1",
   "description": "Resolves friendly natural-language aliases to KnowzCode canonical values (phase, audit, plan, workgroup_type).",
   "parameters": [
     {"name": "domain", "type": "string", "required": true},

package/skills/architecture-diff.json

@@ -1,6 +1,6 @@
 {
   "name": "architecture-diff",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "description": "Highlights differences between specs and the Mermaid flowchart in knowzcode_architecture.md.",
   "parameters": [],
   "actions": [

package/skills/check-installation-status.json

@@ -1,6 +1,6 @@
 {
   "name": "check-installation-status",
-  "version": "2.0.0",
+  "version": "0.3.1",
   "description": "Checks if KnowzCode is initialized in the current project and reports current status",
 
   "parameters": [],

package/skills/continue.md

@@ -51,12 +51,34 @@ Read `knowzcode/workgroups/{WorkGroupID}.md` to determine:
 - Primary goal
 - Change Set
 - Outstanding todos
+- **Autonomous Mode**: If the WorkGroup file contains `**Autonomous Mode**: Active`, restore `AUTONOMOUS_MODE = true` and announce: `> **Autonomous Mode: RESTORED** — continuing with auto-approved gates.`
+- **Orchestration Config**: If `knowzcode/knowzcode_orchestration.md` exists, parse and restore `MAX_BUILDERS`, `SCOUT_MODE`, `MCP_AGENTS_ENABLED`, `DEFAULT_SPECIALISTS` (same logic as work.md Step 2.4). Defaults apply if file is absent.
 
 ### Step 3: Resume at Current Phase
 
 Read `knowzcode/knowzcode_loop.md` and resume the workflow at the detected phase.
 
-Create tasks only for the **remaining** phases (not completed ones):
+#### Parallel Mode Detection
+
+If the WorkGroup file contains a `## Current Stage` section (instead of `Current Phase`):
+- This is a **parallel-mode WorkGroup**
+- Read the per-NodeID phase table to determine what's in progress
+- Resume by recreating the team and spawning agents appropriate for the current stage:
+  - **Stage 0/1**: Spawn analyst + architect. If `SCOUT_MODE != "none"` and context is stale, re-spawn scout(s) per SCOUT_MODE.
+  - **Stage 2**: Spawn builder(s) per the dependency map + reviewer if any NodeIDs are past implementation
+  - **Stage 3**: Spawn closer
+- Builders and reviewer persist through gap loops (don't respawn per iteration)
+- Announce: `**Resuming Parallel Teams** — Stage {N}: {description}`
+
+If resuming mid-Stage-2 (e.g., builder was implementing, reviewer had started auditing):
+- Read the per-NodeID status table to determine which NodeIDs need builders and which need reviewer
+- Carry forward existing context by reading the WorkGroup file
+
+#### Sequential Mode Detection
+
+If the WorkGroup file contains `Current Phase:` (standard format):
+- This is a **sequential-mode WorkGroup**
+- Create tasks only for the **remaining** phases (not completed ones):
 
 | Detected Phase | Remaining Work |
 |----------------|----------------|
@@ -66,10 +88,9 @@ Create tasks only for the **remaining** phases (not completed ones):
 | 2B | Audit + finalization |
 | 3 | Finalization only |
 
-**Detect execution mode** — check if you have Agent Teams capabilities (spawn/create teammate tools, requires `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`):
+**Set up execution mode** — check `~/.claude/settings.json` and `.claude/settings.json` for `"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"` in the `env` block. If found, Agent Teams is available — create a team named `kc-{wgid}` and activate delegate mode (you coordinate only, never write code directly). Read `knowzcode/claude_code_execution.md` for team conventions. For each remaining phase, spawn one teammate with the spawn prompt from the corresponding phase section of `/kc:work`, create a task, wait for completion, present quality gate, shut down teammate. Shut down all teammates when done or on cancel.
 
-- **If Agent Teams is available**: Read `knowzcode/claude_code_execution.md` for team conventions. Activate delegate mode — you coordinate only, never write code directly. For each remaining phase, spawn one teammate with the spawn prompt defined in the corresponding phase section of `/kc:work`, create a task, wait for completion, present quality gate, shut down teammate before the next phase. Shut down all teammates when done or on cancel.
-- **If Agent Teams is NOT available**: Use `Task()` calls to delegate each remaining phase to the named agent (subagent fallback).
+If Agent Teams is not available, announce `**Execution Mode: Subagent Delegation** — Agent Teams not available (add "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" to the env block in settings.json, then restart Claude Code)` and use `Task()` calls to delegate each remaining phase to the named agent.
 
 Follow the same phase delegation patterns (spawn prompts, quality gates, gap loop) as `/kc:work`.
 

package/skills/environment-guard.json

@@ -1,6 +1,6 @@
 {
   "name": "environment-guard",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "description": "Verifies that knowzcode/environment_context.md no longer contains placeholder brackets.",
   "parameters": [],
   "actions": [

package/skills/generate-workgroup-id.json

@@ -1,6 +1,6 @@
 {
   "name": "generate-workgroup-id",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Generates a WorkGroupID following the KnowzCode convention [type]-[slug]-YYYYMMDD-HHMMSS. The slug is a 2-4 word descriptor extracted from the goal.",
   "parameters": [
     {

package/skills/install-knowzcode.json

@@ -1,6 +1,6 @@
 {
   "name": "install-knowzcode",
-  "version": "2.0.0",
+  "version": "0.3.1",
   "description": "Initializes KnowzCode directory structure and required files in the current project",
 
   "parameters": [

package/skills/load-core-context.json

@@ -1,6 +1,6 @@
 {
   "name": "load-core-context",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "description": "Loads the KnowzCode project overview, architecture, tracker, log header, and automation manifest for downstream steps.",
   "parameters": [],
   "actions": [

package/skills/log-entry-builder.json

@@ -1,6 +1,6 @@
 {
   "name": "log-entry-builder",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "description": "Appends structured entries to knowzcode/knowzcode_log.md with KnowzCode formatting.",
   "parameters": [
     {"name": "entry_type", "type": "string", "required": true},

package/skills/spec-quality-check.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-quality-check",
-  "version": "2.0.0",
+  "version": "0.3.1",
   "description": "Validates KnowzCode spec files for mandatory sections. Supports new 4-section format and legacy numbered format.",
   "parameters": [
     {"name": "node_id", "type": "string", "required": true}

package/skills/spec-template.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-template",
-  "version": "2.0.0",
+  "version": "0.3.1",
   "description": "Seeds or repairs KnowzCode spec files with the lean 4-section template.",
   "parameters": [
     {"name": "node_id", "type": "string", "required": true},

package/skills/spec-validator.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-validator",
-  "version": "2.0.0",
+  "version": "0.3.1",
   "description": "Validates NodeID specification completeness and quality. Supports new 4-section format (preferred) and legacy numbered sections (deprecated).",
   "parameters": [
     {

package/skills/tracker-scan.json

@@ -1,6 +1,6 @@
 {
   "name": "tracker-scan",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "description": "Extracts NodeID statuses and WorkGroup assignments from the KnowzCode tracker.",
   "parameters": [],
   "actions": [

package/skills/tracker-update.json

@@ -1,6 +1,6 @@
 {
   "name": "tracker-update",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "description": "Applies validated updates to knowzcode/knowzcode_tracker.md while preserving table structure.",
   "parameters": [
     {

package/skills/validate-installation.json

@@ -1,6 +1,6 @@
 {
   "name": "validate-installation",
-  "version": "2.0.0",
+  "version": "0.3.1",
   "description": "Validates that KnowzCode installation completed successfully with required directories and files",
 
   "parameters": [],