knowzcode 0.4.0 → 0.5.2

package/commands/fix.md

@@ -1,107 +1,107 @@
----
-description: "Execute the KnowzCode micro-fix workflow"
-argument-hint: "<target> <summary>"
----
-
-# KnowzCode Micro-Fix
-
-Execute a targeted micro-fix within the KnowzCode framework.
-
-**Usage**: `/kc:fix <target> <summary>`
-**Example**: `/kc:fix src/auth/login.ts "Fix null reference in password validation"`
-
----
-
-## Scope Guard
-
-**This command is for micro-fixes only.** Before proceeding, verify:
-
-| Criteria | Required |
-|----------|----------|
-| Change affects ≤1 file | ✓ |
-| Change is <50 lines | ✓ |
-| No ripple effects to other components | ✓ |
-| No new dependencies introduced | ✓ |
-| Existing tests cover the change area | ✓ |
-
-**If ANY criteria fails**: Stop and suggest `/kc:work` for full orchestration.
-
----
-
-## Workflow Steps
-
-### 1. Validate Scope
-- Confirm the fix meets micro-fix criteria above
-- If scope exceeds limits, redirect to `/kc:work`
-
-### 2. Load Context
-- Read the target file to understand current implementation
-- Identify existing test coverage for the affected code
-
-### 3. Implement Fix
-- Apply the minimal change required
-- Follow existing code patterns and style
-
-### 4. Verification Loop (MANDATORY)
-
-**⛔ DO NOT skip verification. DO NOT claim "done" without passing tests.**
-
-```
-REPEAT until all checks pass:
-  1. Run relevant tests:
-     - Unit tests covering the changed code
-     - Integration tests if the fix touches boundaries
-     - E2E tests if the fix affects user-facing behavior
-
-  2. If tests FAIL:
-     - Analyze failure
-     - Apply corrective fix
-     - RESTART verification from step 1
-
-  3. If tests PASS:
-     - Run static analysis / linter
-     - If issues found, fix and RESTART from step 1
-
-  4. All checks pass → Exit loop
-```
-
-**Test Selection Guidance:**
-| Fix Type | Required Tests |
-|----------|---------------|
-| Logic bug in function | Unit tests for that function |
-| API endpoint fix | Unit + Integration tests |
-| UI/UX fix | Unit + E2E tests |
-| Configuration fix | Integration tests |
-| Data handling fix | Unit + Integration tests |
-
-### 5. Log and Commit
-- Log MicroFix entry in `knowzcode/knowzcode_log.md`
-- Include verification evidence (which tests passed)
-- Commit with `fix:` prefix
-
----
-
-## Arguments
-
-- `target` (required): NodeID or file path that requires the micro-fix
-- `summary` (required): One-line description of the requested change
-
-## Example Usage
-
-```
-/kc:fix src/auth/login.ts "Fix null reference in password validation"
-/kc:fix NODE_AUTH_123 "Update error message formatting"
-```
-
-## Execution
-
-Delegate to the **microfix-specialist** agent via `Task()` with these parameters:
-- `subagent_type`: `"microfix-specialist"`
-- `prompt`: Task-specific context only (role definition is auto-loaded from `agents/microfix-specialist.md`):
-  > **Target**: {target file or NodeID}
-  > **Fix summary**: {summary}
-  > Validate scope, implement the minimal fix, run the verification loop, log the outcome, and commit.
-- `description`: `"Micro-fix: {summary}"`
-- `mode`: `"bypassPermissions"`
-
-> **Note:** Micro-fixes use subagent delegation only. Agent Teams overhead is not justified for single-file, <50 line fixes.
+---
+description: "Execute the KnowzCode micro-fix workflow"
+argument-hint: "<target> <summary>"
+---
+
+# KnowzCode Micro-Fix
+
+Execute a targeted micro-fix within the KnowzCode framework.
+
+**Usage**: `/kc:fix <target> <summary>`
+**Example**: `/kc:fix src/auth/login.ts "Fix null reference in password validation"`
+
+---
+
+## Scope Guard
+
+**This command is for micro-fixes only.** Before proceeding, verify:
+
+| Criteria | Required |
+|----------|----------|
+| Change affects ≤1 file | ✓ |
+| Change is <50 lines | ✓ |
+| No ripple effects to other components | ✓ |
+| No new dependencies introduced | ✓ |
+| Existing tests cover the change area | ✓ |
+
+**If ANY criteria fails**: Stop and suggest `/kc:work` for full orchestration.
+
+---
+
+## Workflow Steps
+
+### 1. Validate Scope
+- Confirm the fix meets micro-fix criteria above
+- If scope exceeds limits, redirect to `/kc:work`
+
+### 2. Load Context
+- Read the target file to understand current implementation
+- Identify existing test coverage for the affected code
+
+### 3. Implement Fix
+- Apply the minimal change required
+- Follow existing code patterns and style
+
+### 4. Verification Loop (MANDATORY)
+
+**⛔ DO NOT skip verification. DO NOT claim "done" without passing tests.**
+
+```
+REPEAT until all checks pass:
+  1. Run relevant tests:
+     - Unit tests covering the changed code
+     - Integration tests if the fix touches boundaries
+     - E2E tests if the fix affects user-facing behavior
+
+  2. If tests FAIL:
+     - Analyze failure
+     - Apply corrective fix
+     - RESTART verification from step 1
+
+  3. If tests PASS:
+     - Run static analysis / linter
+     - If issues found, fix and RESTART from step 1
+
+  4. All checks pass → Exit loop
+```
+
+**Test Selection Guidance:**
+| Fix Type | Required Tests |
+|----------|---------------|
+| Logic bug in function | Unit tests for that function |
+| API endpoint fix | Unit + Integration tests |
+| UI/UX fix | Unit + E2E tests |
+| Configuration fix | Integration tests |
+| Data handling fix | Unit + Integration tests |
+
+### 5. Log and Commit
+- Log MicroFix entry in `knowzcode/knowzcode_log.md`
+- Include verification evidence (which tests passed)
+- Commit with `fix:` prefix
+
+---
+
+## Arguments
+
+- `target` (required): NodeID or file path that requires the micro-fix
+- `summary` (required): One-line description of the requested change
+
+## Example Usage
+
+```
+/kc:fix src/auth/login.ts "Fix null reference in password validation"
+/kc:fix NODE_AUTH_123 "Update error message formatting"
+```
+
+## Execution
+
+Delegate to the **microfix-specialist** agent via `Task()` with these parameters:
+- `subagent_type`: `"microfix-specialist"`
+- `prompt`: Task-specific context only (role definition is auto-loaded from `agents/microfix-specialist.md`):
+  > **Target**: {target file or NodeID}
+  > **Fix summary**: {summary}
+  > Validate scope, implement the minimal fix, run the verification loop, log the outcome, and commit.
+- `description`: `"Micro-fix: {summary}"`
+- `mode`: `"bypassPermissions"`
+
+> **Note:** Micro-fixes use subagent delegation only. Agent Teams overhead is not justified for single-file, <50 line fixes.