vivreal-workflow

Adversarial 12-point review of a bug fix. Reviews the diff for the given slug against research.md and plan.md. Can also review the current unstaged diff with no arguments. Records metrics.

Orchestrate the full bug fix workflow — research, plan, user approval, implement, strict review (max 3 passes), document, PR.

Principal-level system architecture and design. Evaluates tradeoffs, generates options, and recommends the best approach. Use for "how should we build X?", migration planning, or architecture decisions.

Generate RESOLUTION.md and PR description for a completed bug fix. Reads all artifacts for the given slug. Records metrics.

Principal-level implementation of a feature or change. Writes production-grade code with proper error handling, performance, and security. Use for complex implementations that need senior-level judgment.

Use after research is complete and an implementation plan or design is needed. Designs implementation plans with 2-3 options and tradeoffs. Bug mode produces docs/bugs/<slug>/plan.md. Feature mode produces design.md. Stops at judgment calls.

Use to implement an approved plan.md or design.md. Implements approved plans. Zero scope creep. Follows existing patterns. Reads plan.md/design.md as the spec, runs lint and type-check before reporting done.

Use for end-to-end bug fixes and small tasks that need the full research→implement→review cycle. Multi-mode orchestrator (bug|feature|audit|migration). Dispatches role agents through research → plan → approve → implement → test → review → document.

Use after a fix is implemented and approved, to produce RESOLUTION.md and the PR description. Generates RESOLUTION.md and PR descriptions from completed bug-fix or feature artifacts. Templated transform of research.md + plan.md + final review. Reports metrics.

Investigates issues end-to-end across the Vivreal stack. Cites file:line for every claim. Read-only — never edits source. Dispatches @<system-expert> for system-specific gotchas.

Vivreal Portal shared engineering standards — the non-negotiable conventions every Vivreal bug/feature workflow agent reads before working. Use when an agent or command says to consult "shared-standards" or "_shared-standards", or when a task touches Vivreal proxy routes, multi-tenancy (active_ctx/dbKey/groupID), CSRF, hydration/SSR, Lambda infra, MongoDB queries, or testing rules. Carries the ${VIVREAL_REPOS} path-resolution preamble and the lazy-reading trigger map.