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

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

1. Review the request and confirm scope.
2. Execute the command flow.
3. 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):

1. List all candidates with visual inspection or metadata check
2. Confirm correct asset with user before implementation
3. Document reasoning for selection

Layout Restoration Pattern

For "restore", "add back", or "bring back" requests:

1. FIRST: Research git history to find original implementation
   bashCopy

   git log --all --oneline -- <file>
   git show <commit>:<file>
   

2. Extract working implementation patterns
3. Apply to current codebase
4. 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]