Files
stack/packages/mosaic/framework/templates/agent/qa-remediation-needed.md
Jason Woltje b38cfac760
All checks were successful
ci/woodpecker/push/ci Pipeline was successful
ci/woodpecker/pr/ci Pipeline was successful
feat: integrate framework files into monorepo under packages/mosaic/framework/
Moves all Mosaic framework runtime files from the separate bootstrap repo
into the monorepo as canonical source. The @mosaic/mosaic npm package now
ships the complete framework — bin scripts, runtime configs, tools, and
templates — enabling standalone installation via npm install.

Structure:
  packages/mosaic/framework/
  ├── bin/          28 CLI scripts (mosaic, mosaic-doctor, mosaic-sync-skills, etc.)
  ├── runtime/      Runtime adapters (claude, codex, opencode, pi, mcp)
  ├── tools/        Shell tooling (git, prdy, orchestrator, quality, etc.)
  ├── templates/    Agent and repo templates
  ├── defaults/     Default identity files (AGENTS.md, STANDARDS.md, SOUL.md, etc.)
  ├── install.sh    Legacy bash installer
  └── remote-install.sh  One-liner remote installer

Key files with Pi support and recent fixes:
- bin/mosaic: launch_pi() with skills-local loop
- bin/mosaic-doctor: --fix auto-wiring for all 4 harnesses
- bin/mosaic-sync-skills: Pi as 4th link target, symlink-aware find
- bin/mosaic-link-runtime-assets: Pi settings.json patching
- bin/mosaic-migrate-local-skills: Pi skill roots, symlink find
- runtime/pi/RUNTIME.md + mosaic-extension.ts

Package ships 251 framework files in the npm tarball (278KB compressed).
2026-04-01 21:19:21 -05:00

2.8 KiB

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}

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