fraim-framework 2.0.65 → 2.0.67

package/dist/registry/templates/customer-development/triage-log-template.md

@@ -0,0 +1,278 @@
+# Customer Insight Triage - [Date]
+
+## Summary
+**Customers Analyzed**: [N] customers  
+**Analysis Files**: 
+- [customer1]-interview-analysis.md
+- [customer2]-interview-analysis.md
+
+**Execution Results**:
+- ✅ Created [N] new issues
+- ✅ Updated [N] existing issues  
+- ℹ️ Identified [N] already-built features
+- ⚠️ Flagged [N] items for discovery
+
+---
+
+## Customer → Issue Mapping
+
+### Customer: [Customer 1 Name] ([Company])
+**Analysis**: docs/customer-development/[customer1]-interview-analysis.md  
+**Fit Score**: [X/10]  
+**Issues Filed**:
+- #[new-issue-1] - [Title] (NEW - Priority: Critical)
+- #[existing-issue-1] - [Title] (UPDATED - Added customer context)
+- Built: [Feature] (NO ISSUE - Already exists)
+
+**Key Insights**:
+1. Pain Point: [X] → Issue #[number]
+2. Pain Point: [Y] → Issue #[number]  
+3. Feature Request: [Z] → Already built
+
+---
+
+### Customer: [Customer 2 Name] ([Company])
+**Analysis**: docs/customer-development/[customer2]-interview-analysis.md  
+**Fit Score**: [X/10]  
+**Issues Filed**:
+[Same format as above]
+
+---
+
+## Issue → Customer Mapping
+
+### Issue #[number]: [Title]
+**Priority**: Critical  
+**Status**: New issue created  
+**Customers Requesting**: [N]
+- [Customer 1] ([Company], Fit: [X/10])
+- [Customer 2] ([Company], Fit: [X/10])
+
+**Customer Quotes**:
+> "[Quote 1]" — Customer 1
+
+> "[Quote 2]" — Customer 2
+
+**GitHub Issue**: https://github.com/[org]/[repo]/issues/[number]
+
+---
+
+### Issue #[number]: [Another Issue Title]
+[Same format]
+
+---
+
+## Pattern Analysis
+
+### Cross-Customer Themes
+1. **[Theme Name]** ([N] customers)
+   - Customers: [Customer 1] ([Company]), [Customer 2] ([Company])
+   - Issues: #[number], #[number]
+   - Priority: Critical
+   - Segment: [Market segment]
+   - Pattern: [Description of common need/pain point]
+
+2. **[Another Theme]** ([N] customers)
+   [Same format]
+
+### Segment-Specific Patterns
+**[Segment Name] Segment**:
+- [Pattern or need specific to this segment]
+- [Another pattern]
+- Representative customers: [Names]
+- Issues: #[numbers]
+
+---
+
+## Follow-up Actions Required
+
+### Customer Follow-ups
+- [ ] **Demo existing features** to [Customer 1], [Customer 2]
+  - Feature: [X] addresses their need for [Y]
+  - Schedule by: [Date]
+  - Contact: [Email/method]
+
+- [ ] **Schedule discovery call** with [Customer 3]
+  - Topic: [Vague pain point] needs clarification
+  - Schedule by: [Date]
+  - Questions to ask: [List]
+
+### Product Follow-ups
+- [ ] **Prioritize Issue #[number]** for next sprint
+  - Reason: Critical priority, [N] customers waiting
+  - Estimated effort: [If known]
+  
+- [ ] **Research Issue #[number]**
+  - Needs: Technical feasibility assessment
+  - Assign to: [Team/person]
+
+- [ ] **Update documentation** for [Feature]
+  - Reason: Customers don't know it exists
+  - Add to: Onboarding, help docs
+
+---
+
+## Metrics
+
+### Triage Efficiency
+- **Insights extracted**: [N]
+- **Issues created**: [N]
+- **Issues updated**: [N]
+- **Deduplication rate**: [X%] ([N] insights consolidated into [M] issues)
+- **Time saved**: ~[X] hours vs manual triage (estimated)
+
+### Customer Coverage
+- **Total customers**: [N]
+- **High-fit customers (8+)**: [N] ([Percentage]%)
+- **Issues per customer**: [X average]
+- **Customers with built features**: [N]
+- **Customers needing follow-up**: [N]
+
+### Priority Distribution
+- **Critical**: [N] issues ([X%])
+- **High**: [N] issues ([X%])
+- **Medium**: [N] issues ([X%])
+- **Low**: [N] issues ([X%])
+
+### Customer Segments Represented
+- **[Segment 1]**: [N] customers, [M] issues
+- **[Segment 2]**: [N] customers, [M] issues
+
+---
+
+## Deduplication Log
+
+### Consolidated Issues
+1. **Issue #[number]: [Title]**
+   - **Merged insights**:
+     - [Customer 1]: "[Pain point description]"
+     - [Customer 2]: "[Similar pain point]"
+     - [Customer 3]: "[Variation of same pain]"
+   - **Rationale**: Same core need, different expressions
+   - **Result**: Single critical priority issue
+
+2. **Issue #[number]: [Another Title]**
+   [Same format]
+
+### Issues Kept Separate
+1. **Issue #[number] vs Issue #[number]**
+   - **Reason**: Different use cases despite similar language
+   - **Issue A**: [Specific use case]
+   - **Issue B**: [Different specific use case]
+
+---
+
+## Features Already Built (No Issues Created)
+
+### 1. [Feature Name]
+**Customer(s) Requesting**: [Customer 1], [Customer 2]  
+**Pain Point**: [What they described]  
+**Existing Solution**: [What we already built]  
+**Code Location**: [File paths or feature area]  
+
+**Recommendation**: 
+- Add to customer demo/onboarding materials
+- Update product documentation
+- Create demo video or walkthrough
+
+**Follow-up Note for Customers**:
+> "Regarding your need for [X], we actually have [existing feature] that addresses this. Here's how it works..."
+
+---
+
+### 2. [Another Built Feature]
+[Same format]
+
+---
+
+## Needs Discovery (Research Issues)
+
+### 1. [Vague Pain Point or Request]
+**Customer**: [Name] ([Company])  
+**Quote**: "[What they said]"  
+**Issue**: Too vague to implement directly / Needs technical feasibility / Conflicting requirements  
+**Research Issue Created**: #[number] (labeled `needs:discovery`)  
+
+**Next Steps**:
+- Schedule 30-min follow-up call with customer
+- Questions to ask: [List]
+- Technical assessment needed: [Description]
+- Timeline: Complete discovery by [Date]
+
+---
+
+## Strategic Insights
+
+### Validated Assumptions
+✅ **[Assumption from strategy doc]**
+- Evidence: [N] customers mentioned [X]
+- Quotes: [Brief supporting quotes]
+- Issues: #[numbers]
+
+✅ **[Another assumption]**
+[Same format]
+
+### New Patterns Discovered
+🆕 **[New insight not in strategy]**
+- Emerged from: [N] customers independently
+- Description: [Pattern description]
+- Potential opportunity: [What this means for product]
+- Recommend: Add to strategic brainstorming
+
+### Segment Refinements
+📊 **[Segment name] segment characteristics**
+- Core needs: [List]
+- Differentiators from other segments: [Differences]
+- Recommended focus: [What to prioritize for this segment]
+
+---
+
+## Next Triage Session
+
+**Recommended Timing**: [Date - typically 1 week or after N interviews]  
+
+**Candidates for Next Triage**:
+- [ ] [Customer name] - Interview scheduled for [Date]
+- [ ] [Customer name] - Analysis pending
+- [ ] [Customer name] - Analysis pending
+
+**Backlog**:
+- [ ] [N] interview analyses waiting for triage
+- [ ] Consider bulk triage after [Event/milestone]
+
+**Preparation for Next Triage**:
+- Review issues created in this session for duplicates
+- Check if any critical issues were completed (for customer follow-up)
+- Update strategic document with validated assumptions
+
+---
+
+## Appendix: Raw Data
+
+### All Insights Extracted (Before Consolidation)
+[Optional: List all raw insights before deduplication for reference]
+
+1. **[Customer 1]**:
+   - Insight 1: [Description]
+   - Insight 2: [Description]
+
+2. **[Customer 2]**:
+   - Insight 1: [Description]
+   - Insight 2: [Description]
+
+### Priority Calculation Details
+[Optional: Show detailed priority calculations for transparency]
+
+**Issue #[number]**:
+- Number of Customers: [N] → Score: [X]
+- Avg Fit Score: [X/10] → Weighted: [Y]
+- Urgency: [Level] → Score: [X]
+- Willingness to Pay: [Level] → Score: [X]
+- **Total Priority Score**: [X.X/10] → Label: `priority:[level]`
+
+---
+
+**Triage Completed By**: AI Agent  
+**Triage Date**: [Date and Time]  
+**Triage Duration**: [X minutes]  
+**Next Review**: [Date]

package/dist/registry/templates/customer-development/weekly-newsletter-template.html

@@ -0,0 +1,204 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{{personaName}} Weekly Update - Amazing New Features!</title>
+</head>
+<body style="margin: 0; padding: 0; background-color: #f5f5f5; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;">
+    <table role="presentation" cellspacing="0" cellpadding="0" border="0" width="100%" style="background-color: #f5f5f5;">
+        <tr>
+            <td align="center" style="padding: 40px 20px;">
+                <table role="presentation" cellspacing="0" cellpadding="0" border="0" width="650" style="max-width: 650px; background-color: #ffffff; border-radius: 16px; box-shadow: 0 4px 12px rgba(0,0,0,0.1); overflow: hidden;">
+                    
+                    <!-- Hero Header -->
+                    <tr>
+                        <td style="background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); padding: 50px 40px; text-align: center; position: relative;">
+                            <div style="font-size: 14px; color: rgba(255,255,255,0.9); font-weight: 600; letter-spacing: 2px; text-transform: uppercase; margin-bottom: 12px;">🚀 Weekly Update</div>
+                            <div style="font-size: 38px; font-weight: 800; color: #ffffff; margin-bottom: 12px; line-height: 1.2;">{{weekTitle}}</div>
+                            <div style="font-size: 18px; color: rgba(255,255,255,0.95); font-weight: 400; line-height: 1.5;">{{weekSubtitle}}</div>
+                            <div style="margin-top: 24px; font-size: 15px; color: rgba(255,255,255,0.85); background: rgba(0,0,0,0.2); padding: 12px 24px; border-radius: 30px; display: inline-block;">
+                                📅 Week of {{weekDate}}
+                            </div>
+                        </td>
+                    </tr>
+                    
+                    <!-- Stats Banner -->
+                    {{#if showStats}}
+                    <tr>
+                        <td style="background: linear-gradient(90deg, #f8f9fa 0%, #e9ecef 100%); padding: 30px 40px; border-bottom: 3px solid #667eea;">
+                            <table role="presentation" cellspacing="0" cellpadding="0" border="0" width="100%">
+                                <tr>
+                                    <td align="center" style="padding: 0 15px;">
+                                        <div style="font-size: 36px; font-weight: 800; color: #667eea; margin-bottom: 6px;">{{statsFeatures}}</div>
+                                        <div style="font-size: 13px; color: #6c757d; font-weight: 600; text-transform: uppercase; letter-spacing: 1px;">New Features</div>
+                                    </td>
+                                    <td align="center" style="padding: 0 15px; border-left: 2px solid #dee2e6;">
+                                        <div style="font-size: 36px; font-weight: 800; color: #28a745; margin-bottom: 6px;">{{statsImprovements}}</div>
+                                        <div style="font-size: 13px; color: #6c757d; font-weight: 600; text-transform: uppercase; letter-spacing: 1px;">Improvements</div>
+                                    </td>
+                                    <td align="center" style="padding: 0 15px; border-left: 2px solid #dee2e6;">
+                                        <div style="font-size: 36px; font-weight: 800; color: #fd7e14; margin-bottom: 6px;">{{statsBugFixes}}</div>
+                                        <div style="font-size: 13px; color: #6c757d; font-weight: 600; text-transform: uppercase; letter-spacing: 1px;">Bug Fixes</div>
+                                    </td>
+                                </tr>
+                            </table>
+                        </td>
+                    </tr>
+                    {{/if}}
+                    
+                    <!-- Opening Message -->
+                    <tr>
+                        <td style="padding: 40px 40px 30px 40px;">
+                            <div style="font-size: 17px; color: #495057; line-height: 1.8;">
+                                {{openingMessage}}
+                            </div>
+                        </td>
+                    </tr>
+                    
+                    <!-- Hero Feature -->
+                    {{#if hasHeroFeature}}
+                    <tr>
+                        <td style="padding: 0 40px 40px 40px;">
+                            <div style="background: linear-gradient(135deg, #667eea15 0%, #764ba215 100%); border: 2px solid #667eea; border-radius: 12px; padding: 35px; position: relative; overflow: hidden;">
+                                <div style="position: absolute; top: -10px; right: -10px; background: #ff6b6b; color: white; padding: 8px 20px; border-radius: 20px; font-size: 12px; font-weight: 700; letter-spacing: 1px; transform: rotate(12deg); box-shadow: 0 4px 12px rgba(255, 107, 107, 0.4);">
+                                    ⭐ HERO FEATURE
+                                </div>
+                                <div style="font-size: 14px; color: #667eea; font-weight: 700; text-transform: uppercase; letter-spacing: 1.5px; margin-bottom: 12px;">🎯 Feature of the Week</div>
+                                <div style="font-size: 28px; font-weight: 800; color: #212529; margin-bottom: 16px; line-height: 1.3;">{{heroFeatureTitle}}</div>
+                                <div style="font-size: 16px; color: #495057; line-height: 1.8; margin-bottom: 20px;">{{heroFeatureDescription}}</div>
+                                {{#if heroFeatureImpact}}
+                                <div style="background: white; border-left: 4px solid #28a745; padding: 16px 20px; border-radius: 8px; margin-top: 20px;">
+                                    <div style="font-size: 14px; font-weight: 700; color: #28a745; margin-bottom: 8px;">💚 Real Impact:</div>
+                                    <div style="font-size: 15px; color: #495057; line-height: 1.7;">{{heroFeatureImpact}}</div>
+                                </div>
+                                {{/if}}
+                            </div>
+                        </td>
+                    </tr>
+                    {{/if}}
+                    
+                    <!-- New Features Section -->
+                    {{#if hasNewFeatures}}
+                    <tr>
+                        <td style="padding: 0 40px 35px 40px;">
+                            <div style="font-size: 24px; font-weight: 700; color: #212529; margin-bottom: 20px; padding-bottom: 12px; border-bottom: 3px solid #667eea;">
+                                ✨ New Capabilities
+                            </div>
+                            {{newFeaturesList}}
+                        </td>
+                    </tr>
+                    {{/if}}
+                    
+                    <!-- Improvements Section -->
+                    {{#if hasImprovements}}
+                    <tr>
+                        <td style="padding: 0 40px 35px 40px;">
+                            <div style="font-size: 24px; font-weight: 700; color: #212529; margin-bottom: 20px; padding-bottom: 12px; border-bottom: 3px solid #28a745;">
+                                🚀 Major Improvements
+                            </div>
+                            {{improvementsList}}
+                        </td>
+                    </tr>
+                    {{/if}}
+                    
+                    <!-- Bug Fixes Section -->
+                    {{#if hasBugFixes}}
+                    <tr>
+                        <td style="padding: 0 40px 35px 40px;">
+                            <div style="font-size: 24px; font-weight: 700; color: #212529; margin-bottom: 20px; padding-bottom: 12px; border-bottom: 3px solid #fd7e14;">
+                                🔧 Fixes & Polish
+                            </div>
+                            {{bugFixesList}}
+                        </td>
+                    </tr>
+                    {{/if}}
+                    
+                    <!-- Testimonial/Quote -->
+                    {{#if hasTestimonial}}
+                    <tr>
+                        <td style="padding: 0 40px 40px 40px;">
+                            <div style="background: linear-gradient(135deg, #f8f9fa 0%, #e9ecef 100%); border-radius: 12px; padding: 32px; text-align: center; border-left: 5px solid #ffc107;">
+                                <div style="font-size: 22px; color: #495057; font-style: italic; line-height: 1.7; margin-bottom: 20px;">"{{testimonialText}}"</div>
+                                <div style="font-size: 16px; font-weight: 700; color: #667eea;">— {{testimonialAuthor}}</div>
+                                <div style="font-size: 14px; color: #6c757d; margin-top: 4px;">{{testimonialRole}}</div>
+                            </div>
+                        </td>
+                    </tr>
+                    {{/if}}
+                    
+                    <!-- FOMO Call to Action -->
+                    {{#if showFOMO}}
+                    <tr>
+                        <td style="padding: 0 40px 40px 40px;">
+                            <div style="background: linear-gradient(135deg, #ff6b6b 0%, #ee5a52 100%); border-radius: 12px; padding: 40px; text-align: center; box-shadow: 0 8px 24px rgba(255, 107, 107, 0.3);">
+                                <div style="font-size: 28px; font-weight: 800; color: #ffffff; margin-bottom: 16px;">Don't Miss Out! 🚀</div>
+                                <div style="font-size: 17px; color: rgba(255,255,255,0.95); line-height: 1.7; margin-bottom: 28px;">
+                                    {{personaName}} users are already enjoying these amazing features. Join them and experience the future of AI-powered executive assistance!
+                                </div>
+                                <a href="{{ctaLink}}" style="display: inline-block; background: white; color: #ff6b6b; padding: 16px 40px; border-radius: 30px; text-decoration: none; font-size: 18px; font-weight: 700; box-shadow: 0 6px 20px rgba(0,0,0,0.15); transition: transform 0.2s;">
+                                    {{ctaText}} →
+                                </a>
+                                <div style="margin-top: 20px; font-size: 14px; color: rgba(255,255,255,0.85);">
+                                    ⚡ Setup takes less than 5 minutes
+                                </div>
+                            </div>
+                        </td>
+                    </tr>
+                    {{/if}}
+                    
+                    <!-- Coming Next -->
+                    {{#if hasComingNext}}
+                    <tr>
+                        <td style="padding: 0 40px 40px 40px;">
+                            <div style="background: linear-gradient(135deg, #e7f3ff 0%, #d1e9ff 100%); border-radius: 12px; padding: 28px; border: 2px dashed #667eea;">
+                                <div style="font-size: 20px; font-weight: 700; color: #667eea; margin-bottom: 14px;">🔮 Coming Next Week</div>
+                                <div style="font-size: 15px; color: #495057; line-height: 1.7;">{{comingNextText}}</div>
+                            </div>
+                        </td>
+                    </tr>
+                    {{/if}}
+                    
+                    <!-- Feedback CTA -->
+                    <tr>
+                        <td style="padding: 0 40px 40px 40px;">
+                            <div style="background: #f8f9fa; border-radius: 10px; padding: 28px; text-align: center; border: 1px solid #dee2e6;">
+                                <div style="font-size: 18px; font-weight: 600; color: #495057; margin-bottom: 10px;">
+                                    💬 Have feedback or questions?
+                                </div>
+                                <div style="font-size: 15px; color: #6c757d; line-height: 1.6;">
+                                    Share your thoughts through my <a href="{{chatUrl}}" style="color: #667eea; text-decoration: underline; font-weight: 600;">ChatGPT interface</a> - I'm always learning!
+                                </div>
+                            </div>
+                        </td>
+                    </tr>
+                    
+                    <!-- Signature -->
+                    <tr>
+                        <td style="padding: 0 40px 35px 40px; border-top: 2px solid #e9ecef;">
+                            <div style="padding-top: 30px; font-size: 16px; color: #495057; line-height: 1.6;">
+                                <div style="font-weight: 600; color: #212529; margin-bottom: 8px;">With gratitude,</div>
+                                <div style="color: #667eea; font-weight: 700; font-size: 18px;">{{personaName}}</div>
+                                <div style="margin-top: 10px; font-size: 14px; color: #6c757d; font-style: italic;">
+                                    Your AI Executive Assistant
+                                </div>
+                            </div>
+                        </td>
+                    </tr>
+                    
+                    <!-- Footer -->
+                    <tr>
+                        <td style="background: linear-gradient(90deg, #f8f9fa 0%, #e9ecef 100%); padding: 25px 40px; text-align: center; border-top: 1px solid #dee2e6;">
+                            <div style="font-size: 12px; color: #adb5bd;">
+                                <a href="{{webAppUrl}}" style="color: #667eea; text-decoration: none; font-weight: 600;">Visit {{personaName}}</a> · 
+                                <a href="{{unsubscribeLink}}" style="color: #6c757d; text-decoration: none;">Unsubscribe</a>
+                            </div>
+                        </td>
+                    </tr>
+                    
+                </table>
+            </td>
+        </tr>
+    </table>
+</body>
+</html>

package/dist/registry/templates/evidence/Design-Evidence.md

@@ -0,0 +1,30 @@
+# Feature: <Title>
+Issue: #<issue>  
+Feature Spec: <Link to Feature Spec, if any>
+PR: <Link to PR>
+
+## Completeness Evidence
+ - Issue tagged with label `phase:design`: Yes/No
+ - Issue tagged with label `status:needs-review`: Yes/No
+ - All files committed/synced to branch: Yes/No
+ - Table with following columns 
+   - PR Comment
+   - How Addressed
+
+
+## Due Diligence Evidence
+ - Reviewed feaure spec in detail (if feature spec present): Yes/No
+ - Reviwed code base in detail to understand and repro the issue: Yes/No
+ - Included detailed design, validation plan, test strategy in doc: Yes/No
+
+## Prototype & Validation Evidence
+ - [ ] Built simple proof-of-concept that works end-to-end
+ - [ ] Manually tested complete user flow (browser/curl)
+ - [ ] Verified solution actually works before designing architecture
+ - [ ] Identified minimal viable implementation
+ - [ ] Documented what works vs. what's overengineered
+   
+## Continous Learning
+ - Table with following columns
+    - Learning
+    - Agent Rule Updates (what agent rule file was updated to ensure the learning is durable)

package/dist/registry/templates/evidence/Implementation-BugEvidence.md

@@ -0,0 +1,122 @@
+# Bug: <Title>
+Issue: #<issue>  
+Bug Spec: <Link to Bug Spec>
+PR: <Link to PR>
+
+## RFC/Design Completeness
+
+**Design Document**: [path to RFC/TECHSPEC if exists, or "N/A - Bug fix"]
+
+### Implementation Checklist
+**From Scoping Phase** (or created during implementation):
+
+#### Bug Fix Components
+- [x] File: path/to/file.ts - [fix description] - ✅ Implemented
+- [x] Test: path/to/repro-test.ts - [repro test] - ✅ Implemented
+- [x] Test: path/to/regression-test.ts - [regression test] - ✅ Implemented
+
+#### Additional Changes (if any)
+- [x] File: path/to/related-file.ts - [description] - ✅ Implemented
+- [ ] Config: .fraim/config.json - [fields] - ⏸️ Deferred to Issue #XYZ
+
+**Completeness Summary**:
+- Implemented: X/Y items (Z%)
+- Deferred: A items (with follow-up issues #123, #456)
+- Missing: 0 (MUST be 0 or have follow-up issues)
+
+**Scope Changes from Original Plan** (if any):
+- [List any changes from original bug fix scope]
+- [Explain rationale for each change]
+
+**Deferred Items** (if any):
+- Item: [description] - Deferred to Issue #XYZ - Reason: [why deferred]
+
+## Completeness Evidence
+ - Issue tagged with label `phase:impl`: Yes/No
+ - Issue tagged with label `status:needs-review`: Yes/No
+ - All files committed/synced to branch: Yes/No
+
+## Feedback Received
+### PR Comments
+ - Table with following columns 
+   - PR Comment
+   - How Addressed
+
+### User Feedback (Direct)
+ - Table with following columns
+   - Feedback Content
+   - How Addressed
+
+## Implementation Quality Checkpoints
+ - [ ] Code complexity reviewed (no overengineering)
+ - [ ] No resource waste (excessive retries, delays, workarounds)
+ - [ ] Solution based on proven approach from design phase
+ - [ ] All new files/functions are actually used
+
+## Validation Evidence
+- Complete valiation performed as suggested in bug spec: Yes/No
+- **MANDATORY**: Evidence must reflect actual validation status, not assumptions
+- **MANDATORY**: Cannot mark automated validations as "pending" without attempting them first
+- Table with following columns
+   - Validation Step (manual vs automated)
+   - Validation Result (pass vs fail)
+   - Evidence (actual command/output or explanation why not applicable)
+   - Failure Analysis (if fail)
+
+## New Files/Functions Created
+ - Table with the following columns
+    - File/Function Name
+    - Purpose
+    - Who is using/importing/calling it
+    - Is it actually used? (Yes/No - if No, explain why it exists)
+
+## New Tests Added
+- Required if existing test cases did not repro the bug, Optional if bug fix made previously failing test cases pass
+- **MANDATORY**: For each new test case added, you MUST:
+  - Show actual test execution command run
+  - Show actual test output (exit code and results)
+  - Document whether it passed/failed
+  - Cannot claim tests "need fixes" without attempting execution first
+
+## Test Execution Log
+**MANDATORY**: Include actual test execution results below:
+
+```bash
+# Example: Running test file
+$ npm run test -- test-XXX-fix.ts
+# [Include actual output here]
+# Exit code: 0 (success) or non-zero (failure)
+```
+
+**For each test file**:
+- Command executed: `[command]`
+- Exit code: `[0 or non-zero]`
+- Passed tests: `[count]`
+- Failed tests: `[count]`
+- Output excerpt: `[relevant lines]`
+
+## Existing Test Suites Run
+ - Table with following columns
+    - Test Suite
+    - Was it Run (if not, why not - it's ok to not run a suite if there is no impact of your work to it as covered in agent-testing-guidelines.md)
+    - Failing Tests
+    - Failure Analysis (if any tests fail)
+
+## Pre-Completion Reflection
+
+[Include reflection analysis here following `get_fraim_file({ path: "rules/mandatory-pre-completion-reflection.md" })`]
+
+✅ Reflection Phase 1 (Claim Verification) completed: YES/NO
+✅ Reflection Phase 2 (Risk Analysis) completed: YES/NO
+✅ Reflection Phase 3 (Validation Plan Check) completed: YES/NO
+✅ Reflection Phase 4 (Self-Audit) completed: YES/NO
+✅ All blockers from reflection addressed: YES/NO
+✅ Confidence level: X% (must be ≥ 90% to proceed)
+
+**Reflection Summary:**
+[Brief summary of key findings from reflection]
+
+## Continous Learning
+ - Table with following columns
+    - Learning
+    - Agent Rule Updates (what agent rule file was updated to ensure the learning is durable)