@su-record/vibe 2.8.51 → 2.8.53

package/skills/capability-loop/templates/capability-spec.md

@@ -1,118 +1,118 @@
-# Capability Spec: {{CAPABILITY_NAME}}
-
-**Date**: {{DATE}}
-**Origin**: {{FAILURE_ANALYSIS_FILE}}
-**Category**: {{TOOL | GUARDRAIL | ABSTRACTION | DOCUMENTATION | FEEDBACK}}
-**Priority**: {{P1 | P2 | P3}}
-
----
-
-## Problem Statement
-
-**Failure this solves**: {{FAILURE_DESCRIPTION}}
-
-**Without this capability:**
-{{WITHOUT_CAPABILITY_DESCRIPTION}}
-
-**With this capability:**
-{{WITH_CAPABILITY_DESCRIPTION}}
-
----
-
-## Specification
-
-### What It Does
-
-{{CAPABILITY_DESCRIPTION_DETAILED}}
-
-### Inputs
-
-| Input | Type | Source | Required |
-|-------|------|--------|----------|
-| {{INPUT_1}} | {{TYPE_1}} | {{SOURCE_1}} | {{YES/NO}} |
-| {{INPUT_2}} | {{TYPE_2}} | {{SOURCE_2}} | {{YES/NO}} |
-
-### Outputs
-
-| Output | Type | Format | Notes |
-|--------|------|--------|-------|
-| {{OUTPUT_1}} | {{TYPE_1}} | {{FORMAT_1}} | {{NOTES_1}} |
-
-### Behavior
-
-1. {{BEHAVIOR_STEP_1}}
-2. {{BEHAVIOR_STEP_2}}
-3. {{BEHAVIOR_STEP_3}}
-
-### Error Cases
-
-| Condition | Behavior |
-|-----------|----------|
-| {{ERROR_CASE_1}} | {{ERROR_BEHAVIOR_1}} |
-| {{ERROR_CASE_2}} | {{ERROR_BEHAVIOR_2}} |
-
----
-
-## Implementation Plan
-
-### Files to Create
-
-- `{{NEW_FILE_1}}` — {{PURPOSE_1}}
-- `{{NEW_FILE_2}}` — {{PURPOSE_2}}
-
-### Files to Modify
-
-- `{{MODIFIED_FILE_1}}` — {{CHANGE_DESCRIPTION_1}}
-
-### Integration Points
-
-- Triggers on: {{TRIGGER_CONDITION}}
-- Called by: {{CALLER}}
-- Calls into: {{DEPENDENCIES}}
-
----
-
-## Acceptance Criteria
-
-- [ ] {{ACCEPTANCE_CRITERION_1}}
-- [ ] {{ACCEPTANCE_CRITERION_2}}
-- [ ] {{ACCEPTANCE_CRITERION_3}}
-- [ ] Original failure scenario no longer occurs
-- [ ] Existing functionality unaffected (regression tests pass)
-
----
-
-## Verification Plan
-
-**Test to add**: `{{TEST_FILE}}` — `{{TEST_DESCRIPTION}}`
-
-**Manual verification steps:**
-1. {{VERIFY_STEP_1}}
-2. {{VERIFY_STEP_2}}
-
----
-
-## Persistence
-
-After building, record in `.claude/vibe/capabilities-log.md`:
-
-```markdown
-## {{DATE}} — {{CAPABILITY_NAME}}
-
-**Failure**: {{FAILURE_SHORT}}
-**Missing**: {{MISSING_CAPABILITY_SHORT}}
-**Built**: {{WHAT_WAS_BUILT}}
-**Files**: {{FILES_LIST}}
-**Prevents**: {{FAILURE_CLASS}}
-```
-
-Save to memory:
-```
-save_memory("capability-{{CAPABILITY_NAME}}", {
-  "failure": "{{FAILURE_SHORT}}",
-  "diagnosis": "{{MISSING_CAPABILITY_SHORT}}",
-  "category": "{{CATEGORY}}",
-  "solution": "{{WHAT_WAS_BUILT}}",
-  "files_changed": [{{FILES_LIST}}]
-})
-```
+# Capability Spec: {{CAPABILITY_NAME}}
+
+**Date**: {{DATE}}
+**Origin**: {{FAILURE_ANALYSIS_FILE}}
+**Category**: {{TOOL | GUARDRAIL | ABSTRACTION | DOCUMENTATION | FEEDBACK}}
+**Priority**: {{P1 | P2 | P3}}
+
+---
+
+## Problem Statement
+
+**Failure this solves**: {{FAILURE_DESCRIPTION}}
+
+**Without this capability:**
+{{WITHOUT_CAPABILITY_DESCRIPTION}}
+
+**With this capability:**
+{{WITH_CAPABILITY_DESCRIPTION}}
+
+---
+
+## Specification
+
+### What It Does
+
+{{CAPABILITY_DESCRIPTION_DETAILED}}
+
+### Inputs
+
+| Input | Type | Source | Required |
+|-------|------|--------|----------|
+| {{INPUT_1}} | {{TYPE_1}} | {{SOURCE_1}} | {{YES/NO}} |
+| {{INPUT_2}} | {{TYPE_2}} | {{SOURCE_2}} | {{YES/NO}} |
+
+### Outputs
+
+| Output | Type | Format | Notes |
+|--------|------|--------|-------|
+| {{OUTPUT_1}} | {{TYPE_1}} | {{FORMAT_1}} | {{NOTES_1}} |
+
+### Behavior
+
+1. {{BEHAVIOR_STEP_1}}
+2. {{BEHAVIOR_STEP_2}}
+3. {{BEHAVIOR_STEP_3}}
+
+### Error Cases
+
+| Condition | Behavior |
+|-----------|----------|
+| {{ERROR_CASE_1}} | {{ERROR_BEHAVIOR_1}} |
+| {{ERROR_CASE_2}} | {{ERROR_BEHAVIOR_2}} |
+
+---
+
+## Implementation Plan
+
+### Files to Create
+
+- `{{NEW_FILE_1}}` — {{PURPOSE_1}}
+- `{{NEW_FILE_2}}` — {{PURPOSE_2}}
+
+### Files to Modify
+
+- `{{MODIFIED_FILE_1}}` — {{CHANGE_DESCRIPTION_1}}
+
+### Integration Points
+
+- Triggers on: {{TRIGGER_CONDITION}}
+- Called by: {{CALLER}}
+- Calls into: {{DEPENDENCIES}}
+
+---
+
+## Acceptance Criteria
+
+- [ ] {{ACCEPTANCE_CRITERION_1}}
+- [ ] {{ACCEPTANCE_CRITERION_2}}
+- [ ] {{ACCEPTANCE_CRITERION_3}}
+- [ ] Original failure scenario no longer occurs
+- [ ] Existing functionality unaffected (regression tests pass)
+
+---
+
+## Verification Plan
+
+**Test to add**: `{{TEST_FILE}}` — `{{TEST_DESCRIPTION}}`
+
+**Manual verification steps:**
+1. {{VERIFY_STEP_1}}
+2. {{VERIFY_STEP_2}}
+
+---
+
+## Persistence
+
+After building, record in `.claude/vibe/capabilities-log.md`:
+
+```markdown
+## {{DATE}} — {{CAPABILITY_NAME}}
+
+**Failure**: {{FAILURE_SHORT}}
+**Missing**: {{MISSING_CAPABILITY_SHORT}}
+**Built**: {{WHAT_WAS_BUILT}}
+**Files**: {{FILES_LIST}}
+**Prevents**: {{FAILURE_CLASS}}
+```
+
+Save to memory:
+```
+save_memory("capability-{{CAPABILITY_NAME}}", {
+  "failure": "{{FAILURE_SHORT}}",
+  "diagnosis": "{{MISSING_CAPABILITY_SHORT}}",
+  "category": "{{CATEGORY}}",
+  "solution": "{{WHAT_WAS_BUILT}}",
+  "files_changed": [{{FILES_LIST}}]
+})
+```

package/skills/capability-loop/templates/failure-analysis.md

@@ -1,118 +1,118 @@
-# Failure Analysis: {{FAILURE_TITLE}}
-
-**Date**: {{DATE}}
-**Reporter**: {{REPORTER}}
-**Occurrence count**: {{OCCURRENCE_COUNT}}
-**First seen**: {{FIRST_SEEN_DATE}}
-
----
-
-## Failure Description
-
-**What happened:**
-{{FAILURE_DESCRIPTION}}
-
-**Expected behavior:**
-{{EXPECTED_BEHAVIOR}}
-
-**Actual behavior:**
-{{ACTUAL_BEHAVIOR}}
-
-**Reproduction steps:**
-1. {{STEP_1}}
-2. {{STEP_2}}
-3. {{STEP_3}}
-
----
-
-## Diagnosis
-
-Answer all five questions:
-
-### 1. Missing Tool?
-> Did the agent lack a command, API, or utility to accomplish the task?
-
-{{TOOL_DIAGNOSIS}}
-
-- Missing: {{MISSING_TOOL_OR_NONE}}
-- Where to build: {{TOOL_BUILD_LOCATION_OR_NA}}
-
-### 2. Missing Guardrail?
-> Should the agent have been prevented from doing this?
-
-{{GUARDRAIL_DIAGNOSIS}}
-
-- Missing: {{MISSING_GUARDRAIL_OR_NONE}}
-- Where to build: {{GUARDRAIL_BUILD_LOCATION_OR_NA}}
-
-### 3. Missing Abstraction?
-> Was the agent repeating work that should be shared code?
-
-{{ABSTRACTION_DIAGNOSIS}}
-
-- Missing: {{MISSING_ABSTRACTION_OR_NONE}}
-- Where to build: {{ABSTRACTION_BUILD_LOCATION_OR_NA}}
-
-### 4. Missing Documentation?
-> Did the agent lack knowledge that should be discoverable?
-
-{{DOCUMENTATION_DIAGNOSIS}}
-
-- Missing: {{MISSING_DOC_OR_NONE}}
-- Where to add: {{DOC_LOCATION_OR_NA}}
-
-### 5. Missing Feedback?
-> Did the agent not know it was doing the wrong thing?
-
-{{FEEDBACK_DIAGNOSIS}}
-
-- Missing: {{MISSING_FEEDBACK_OR_NONE}}
-- Where to add: {{FEEDBACK_LOCATION_OR_NA}}
-
----
-
-## Root Cause
-
-**Primary category**: {{TOOL | GUARDRAIL | ABSTRACTION | DOCUMENTATION | FEEDBACK}}
-
-**Root cause statement**: {{ROOT_CAUSE_ONE_SENTENCE}}
-
-**Contributing factors:**
-- {{FACTOR_1}}
-- {{FACTOR_2}}
-
----
-
-## Capability to Build
-
-**Capability name**: `{{CAPABILITY_NAME}}`
-
-**What to build**: {{CAPABILITY_DESCRIPTION}}
-
-**Build plan:**
-1. {{BUILD_STEP_1}}
-2. {{BUILD_STEP_2}}
-3. {{BUILD_STEP_3}}
-
-**Files to create/modify:**
-- `{{FILE_1}}` — {{FILE_1_PURPOSE}}
-- `{{FILE_2}}` — {{FILE_2_PURPOSE}}
-
----
-
-## Verification
-
-- [ ] Original failure reproduced before fix
-- [ ] New capability prevents the failure
-- [ ] Existing tests still pass
-- [ ] New test added that would catch this failure class
-
----
-
-## Prevents
-
-This capability prevents the following class of failures:
-
-> {{FAILURE_CLASS_DESCRIPTION}}
-
-Estimated recurrence if not built: {{HIGH | MEDIUM | LOW}}
+# Failure Analysis: {{FAILURE_TITLE}}
+
+**Date**: {{DATE}}
+**Reporter**: {{REPORTER}}
+**Occurrence count**: {{OCCURRENCE_COUNT}}
+**First seen**: {{FIRST_SEEN_DATE}}
+
+---
+
+## Failure Description
+
+**What happened:**
+{{FAILURE_DESCRIPTION}}
+
+**Expected behavior:**
+{{EXPECTED_BEHAVIOR}}
+
+**Actual behavior:**
+{{ACTUAL_BEHAVIOR}}
+
+**Reproduction steps:**
+1. {{STEP_1}}
+2. {{STEP_2}}
+3. {{STEP_3}}
+
+---
+
+## Diagnosis
+
+Answer all five questions:
+
+### 1. Missing Tool?
+> Did the agent lack a command, API, or utility to accomplish the task?
+
+{{TOOL_DIAGNOSIS}}
+
+- Missing: {{MISSING_TOOL_OR_NONE}}
+- Where to build: {{TOOL_BUILD_LOCATION_OR_NA}}
+
+### 2. Missing Guardrail?
+> Should the agent have been prevented from doing this?
+
+{{GUARDRAIL_DIAGNOSIS}}
+
+- Missing: {{MISSING_GUARDRAIL_OR_NONE}}
+- Where to build: {{GUARDRAIL_BUILD_LOCATION_OR_NA}}
+
+### 3. Missing Abstraction?
+> Was the agent repeating work that should be shared code?
+
+{{ABSTRACTION_DIAGNOSIS}}
+
+- Missing: {{MISSING_ABSTRACTION_OR_NONE}}
+- Where to build: {{ABSTRACTION_BUILD_LOCATION_OR_NA}}
+
+### 4. Missing Documentation?
+> Did the agent lack knowledge that should be discoverable?
+
+{{DOCUMENTATION_DIAGNOSIS}}
+
+- Missing: {{MISSING_DOC_OR_NONE}}
+- Where to add: {{DOC_LOCATION_OR_NA}}
+
+### 5. Missing Feedback?
+> Did the agent not know it was doing the wrong thing?
+
+{{FEEDBACK_DIAGNOSIS}}
+
+- Missing: {{MISSING_FEEDBACK_OR_NONE}}
+- Where to add: {{FEEDBACK_LOCATION_OR_NA}}
+
+---
+
+## Root Cause
+
+**Primary category**: {{TOOL | GUARDRAIL | ABSTRACTION | DOCUMENTATION | FEEDBACK}}
+
+**Root cause statement**: {{ROOT_CAUSE_ONE_SENTENCE}}
+
+**Contributing factors:**
+- {{FACTOR_1}}
+- {{FACTOR_2}}
+
+---
+
+## Capability to Build
+
+**Capability name**: `{{CAPABILITY_NAME}}`
+
+**What to build**: {{CAPABILITY_DESCRIPTION}}
+
+**Build plan:**
+1. {{BUILD_STEP_1}}
+2. {{BUILD_STEP_2}}
+3. {{BUILD_STEP_3}}
+
+**Files to create/modify:**
+- `{{FILE_1}}` — {{FILE_1_PURPOSE}}
+- `{{FILE_2}}` — {{FILE_2_PURPOSE}}
+
+---
+
+## Verification
+
+- [ ] Original failure reproduced before fix
+- [ ] New capability prevents the failure
+- [ ] Existing tests still pass
+- [ ] New test added that would catch this failure class
+
+---
+
+## Prevents
+
+This capability prevents the following class of failures:
+
+> {{FAILURE_CLASS_DESCRIPTION}}
+
+Estimated recurrence if not built: {{HIGH | MEDIUM | LOW}}