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

file_path, file_name, epic_association, epic_exists, timestamp, iteration, max_iterations, tool_triggered, severity, status, error_context

file_path	file_name	epic_association	epic_exists	timestamp	iteration	max_iterations	tool_triggered	severity	status	error_context
full_path	sanitized_name	E.XXXX-name or "general"	true|false|created	YYYYMMDD-HHMM	1-5	5	Edit|MultiEdit|Write	CRITICAL|HIGH|MEDIUM|LOW	pending	any errors during creation

Remediation Needed: {file_name}

Environment Context

• Epic Status: {existing|created|general}
• Report Location: {full path to this report}
• Previous Iterations: {list if any}
• Project Type: {React Frontend|NestJS Backend|Node.js Library}

Issues Detected

TypeScript Compilation

Status: ❌ FAILED | ✅ PASSED
Errors Found: {count}

// Error details with line numbers
{specific errors}

Context7 Documentation:

• {relevant TypeScript docs retrieved}

ESLint Violations

Status: ❌ ERRORS | ⚠️ WARNINGS | ✅ CLEAN
Issues Found: {count}

// Violation details with rule names
{specific violations}

Context7 Documentation:

• {relevant ESLint rule docs}

Prettier Formatting

Status: ❌ NEEDS FORMATTING | ✅ FORMATTED
Changes Required: {yes|no}

// Formatting differences
- {original}
+ {formatted}

Security Issues

Status: ❌ VULNERABILITIES | ✅ SECURE
Critical Issues: {count}

• {list of security concerns}

Recommended Fixes

Priority 1: Critical (Must Fix)

1. {Issue}: {specific fix with code example}
   • Rationale: {why this fix}
   • Context7 Reference: {documentation link/content}

Priority 2: High (Should Fix)

1. {Issue}: {specific fix}
   • Rationale: {reasoning}
   • Auto-fixable: {yes|no}

Priority 3: Medium (Consider Fixing)

1. {Issue}: {improvement suggestion}
   • Impact: {what this improves}

Sequential Thinking Analysis

Thought 1: {initial analysis}
Thought 2: {problem identification}
Thought 3: {solution approach}
Thought 4: {validation strategy}
Decision: {recommended approach}

Auto-Fix Availability

• TypeScript: {percentage auto-fixable}
• ESLint: {percentage auto-fixable with --fix}
• Prettier: ✅ 100% auto-fixable
• Overall: {percentage requiring manual intervention}

Execution Plan

1. Apply Prettier formatting
2. Run ESLint with --fix flag
3. Fix TypeScript compilation errors
4. Address security vulnerabilities
5. Re-run validation suite

Risk Assessment

• Breaking Changes: {none|low|medium|high}
• Side Effects: {list potential impacts}
• Dependencies: {any new dependencies needed}

Manual Actions Required

{If any issues cannot be auto-fixed, list specific manual interventions needed}

Notes

{Additional context, warnings, or information}

---

Generated by Universal QA Agent
Timestamp: {ISO timestamp}
Agent Version: 1.0.0