build-feature

LIBRARY-FIRST PROTOCOL (MANDATORY)

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: Build feature command

Trigger Conditions

• Command syntax: /build-feature [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

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

Feature Restoration vs New Feature

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

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

2. Extract working implementation patterns from historical commits
3. Apply proven patterns to current codebase
4. AVOID: Reinventing solutions that previously worked

1. Check if similar patterns exist in codebase
2. Follow established conventions (grid layouts, component structure)
3. Iterate with user feedback

Layout Implementation Strategy

• Hero sections with text + image -> Grid-based layout (lg:grid-cols-12)
• Card layouts -> Consistent spacing and responsive breakpoints
• If >3 positioning iterations needed -> STOP and research existing patterns or ask for design reference

User Frustration Signals

• Trigger: Immediate rollback + strategy pivot required
• Response: Research historical solutions or ask for design reference
• Never continue iterating after frustration signals

Example Invocation

• /build-feature 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.

VCL COMPLIANCE APPENDIX (Internal Reference)