bootstrap/templates/agent/qa-remediation-actions.md

file_path: {full_path} file_name: {sanitized_name} remediation_report: {FileName}_remediation_needed.md timestamp_start: {ISO_timestamp} timestamp_end: {ISO_timestamp} iteration: {current_iteration} status: {planning|researching|executing|validating|completed|failed} success_metrics: typescript: {pass|fail|not_applicable} eslint: {pass|fail|not_applicable} prettier: {pass|fail|not_applicable} security: {pass|fail|not_applicable}

Remediation Actions: {file_name}

Planning Phase

Start Time: {timestamp}
Status: {in_progress|completed}

Sequential Thinking Analysis

Thought 1: Analyzing reported issues - {analysis}
Thought 2: Determining fix priority - {priority reasoning}
Thought 3: Identifying dependencies - {dependency analysis}
Thought 4: Planning execution order - {order rationale}
Thought 5: Estimating complexity - {complexity assessment}
Thought 6: Validation approach - {how to verify success}
Total Thoughts: {n}
Decision: {chosen approach}

Issues Prioritization

1. Critical: {issues that block compilation/execution}
2. High: {issues affecting functionality}
3. Medium: {code quality issues}
4. Low: {style/formatting issues}

Research Phase

Start Time: {timestamp}
Status: {in_progress|completed}

Context7 Documentation Retrieved

// Query 1: TypeScript best practices
await mcp__context7__get_library_docs({
  context7CompatibleLibraryID: "/microsoft/TypeScript",
  topic: "{specific topic}",
  tokens: 3000
});
// Result: {summary of findings}

// Query 2: ESLint rules
await mcp__context7__get_library_docs({
  context7CompatibleLibraryID: "/eslint/eslint",
  topic: "{specific rules}",
  tokens: 2000
});
// Result: {summary of findings}

// Query 3: Framework patterns
await mcp__context7__get_library_docs({
  context7CompatibleLibraryID: "{framework library}",
  topic: "{specific patterns}",
  tokens: 2500
});
// Result: {summary of findings}

Relevant Patterns Identified

• Pattern 1: {description and application}
• Pattern 2: {description and application}
• Best Practice: {relevant best practice from docs}

Action Plan

Generated: {timestamp}
Total Actions: {count}

Planned Actions

1. Fix TypeScript interface issue

   • Issue: Property 'onClick' missing from ButtonProps
   • Solution: Add optional onClick property with proper typing
   • Rationale: Maintains backward compatibility while fixing type error
   • Rollback: Remove property if breaks existing usage
   • Estimated Impact: Low risk, improves type safety

2. Resolve ESLint violations

   • Issue: no-unused-vars on line 45
   • Solution: Remove unused import or implement usage
   • Rationale: Clean code practice, reduces bundle size
   • Rollback: Re-add if functionality needed
   • Estimated Impact: No functional change

3. Apply Prettier formatting

   • Issue: Inconsistent formatting throughout file
   • Solution: Run prettier --write
   • Rationale: Maintains code style consistency
   • Rollback: Not needed (formatting only)
   • Estimated Impact: No functional change

Execution Phase

Start Time: {timestamp}
Status: {in_progress|completed}

Actions Taken

Action 1: Fix TypeScript interface issue

Timestamp: {ISO timestamp}
Tool Used: Edit
Target: Lines 10-15 of ButtonProps interface
Change Applied:

// Before
interface ButtonProps {
  label: string;
  disabled?: boolean;
}

// After
interface ButtonProps {
  label: string;
  disabled?: boolean;
  onClick?: React.MouseEventHandler<HTMLButtonElement>;
}

Result: ✅ Success - TypeScript compilation now passes
Side Effects: None observed
Status: [x] Completed

Action 2: Resolve ESLint violations

Timestamp: {ISO timestamp}
Tool Used: MultiEdit
Target: Multiple locations with violations
Changes Applied:

• Removed unused import on line 3
• Fixed missing dependency in useEffect on line 67
• Added missing return type on line 89 Result: ✅ Success - ESLint now reports 0 errors
  Side Effects: None
  Status: [x] Completed

Action 3: Apply Prettier formatting

Timestamp: {ISO timestamp}
Tool Used: Bash
Command: npx prettier --write {file_path}
Result: ✅ Success - File formatted
Lines Changed: 47
Status: [x] Completed

Unexpected Issues Encountered

{Any issues that arose during execution}

Adjustments Made

{Any deviations from the original plan and why}

Validation Phase

Start Time: {timestamp}
Status: {in_progress|completed}

Re-run QA Checks

TypeScript Validation

npx tsc --noEmit {file_path}

Result: ✅ PASS - No errors
Details: Compilation successful, all types resolved

ESLint Validation

npx eslint {file_path}

Result: ✅ PASS - 0 errors, 2 warnings
Warnings:

• Line 34: Prefer const over let (prefer-const)
• Line 78: Missing explicit return type (explicit-function-return-type)

Prettier Validation

npx prettier --check {file_path}

Result: ✅ PASS - File formatted correctly

Security Scan

# Security check command

Result: ✅ PASS - No vulnerabilities detected

Overall Validation Status

• All Critical Issues: ✅ Resolved
• All High Issues: ✅ Resolved
• Medium Issues: ⚠️ 2 warnings remain (non-blocking)
• Low Issues: ✅ Resolved

Next Steps

If Successful (All Pass)

• Move reports to done/
• Archive after 7 days
• Log success metrics

If Failed (Issues Remain)

• Check iteration count: {current}/5
• If < 5: Plan next iteration approach
• If >= 5: Escalate with detailed analysis

Next Iteration Planning (If Needed)

Remaining Issues: {list}
New Approach: {different strategy based on learnings}
Sequential Thinking:

Thought 1: Why did previous approach fail?
Thought 2: What alternative solutions exist?
Thought 3: Which approach has highest success probability?
Decision: {new approach}

Summary

Total Execution Time: {duration}
Actions Completed: {n}/{total}
Success Rate: {percentage}
Final Status: {completed|needs_iteration|escalated}

Lessons Learned

{Any insights that could help future remediation}

---

Generated by Auto-Remediation Agent
Start: {ISO timestamp}
End: {ISO timestamp}
Agent Version: 1.0.0