fix-bug
LIBRARY-FIRST PROTOCOL (MANDATORY)
Before writing ANY code, you MUST check:
Step 1: Library Catalog
- Location:
.claude/library/catalog.json - If match >70%: REUSE or ADAPT
Step 2: Patterns Guide
- Location:
.claude/docs/inventories/LIBRARY-PATTERNS-GUIDE.md - If pattern exists: FOLLOW documented approach
Step 3: Existing Projects
- Location:
D:\Projects\* - If found: EXTRACT and adapt
Decision Matrix
| Match | Action |
|---|---|
| Library >90% | REUSE directly |
| Library 70-90% | ADAPT minimally |
| Pattern exists | FOLLOW pattern |
| In project | EXTRACT |
| No match | BUILD (add to library after) |
STANDARD OPERATING PROCEDURE
Purpose
- Primary action: Fix bug command
Trigger Conditions
- Command syntax: /fix-bug [args]
- Ensure prerequisites are met before execution.
Inputs and Options
- Inputs: No structured parameters defined; capture user intent explicitly.
Execution Phases
- Review the request and confirm scope.
- Execute the command flow.
- Summarize outcomes and next actions.
Success Criteria and Outputs
- Document artifacts, decisions, and follow-up actions clearly.
Error Handling and Recovery
- If execution fails, capture the failure mode, retry with verbose context, and surface actionable remediation steps.
Chaining and Coordination
Memory and Tagging
- Tag session outputs with who/when/why for traceability.
LEARNED PATTERNS (Session: 2026-01-07)
Asset Selection Protocol
When multiple similar assets exist (e.g., headshot.jpg vs headshot.png):
- List all candidates with visual inspection or metadata check
- Confirm correct asset with user before implementation
- Document reasoning for selection
Layout Restoration Pattern
For "restore", "add back", or "bring back" requests:
- FIRST: Research git history to find original implementation
git log --all --oneline -- <file> git show <commit>:<file> - Extract working implementation patterns
- Apply to current codebase
- AVOID: Trial-and-error positioning attempts without historical context
Positioning Decision Tree
- Hero sections with text + image -> Grid-based layout (lg:grid-cols-12)
- Simple overlays -> Absolute positioning
- If >3 positioning iterations needed -> STOP and research git history or ask for design reference
User Frustration Signals
Phrases like "this is getting sad", "stop", "reverse all changes" indicate:
- Trigger: Immediate rollback + strategy pivot required
- Response: Research historical solutions or ask for design reference
- Never continue iterating after frustration signals
Example Invocation
- /fix-bug example
Output Format
- Provide a concise summary, actions taken, artifacts generated, and recommended next steps.
- Always include an explicit confidence line: "Confidence: X.XX (ceiling: TYPE Y.YY)".
- Use ceilings — inference/report: 0.70, research: 0.85, observation: 0.95, definition: 0.95.
- Keep user-facing output in plain English; reserve VCL markers for the appendix only.
Confidence: 0.86 (ceiling: observation 0.95) - SOP rewritten to Prompt-Architect pattern based on legacy command content.
VCL COMPLIANCE APPENDIX (Internal Reference)
[[HON:teineigo]] [[MOR:root:PA]] [[COM:PromptArchitect]] [[CLS:ge_command]] [[EVD:-DI]] [[ASP:nesov.]] [[SPC:path:/commands]] [define|neutral] CONFIDENCE_CEILINGS := {inference:0.70, report:0.70, research:0.85, observation:0.95, definition:0.95} [conf:0.9] [state:confirmed] [direct|emphatic] L2_LANGUAGE := English; user-facing outputs exclude VCL markers. [conf:0.99] [state:confirmed] [commit|confident] FIX_BUG_VERILINGUA_VERIX_COMPLIANT [conf:0.88] [state:confirmed]