
Creates or updates .agents/PROJECT_CONTEXT.md with project conventions, tech stack, code standards, testing strategy, and product architecture. Triggered by: bun nvst create project-context.
Creates a structured test plan from the PRD and project context with automation-first guidance. Triggered by: bun nvst create test-plan.
# evaluate (scaffold) <!-- TODO: Complete. All content in English. --> ## Objective TBD — Evaluate prototype: strengths, technical debt, violations of PROJECT_CONTEXT.md; recommendations by impact, urgency, effort, scope; optional numeric score for ordering. ## Inputs TBD — Prototype code, PROJECT_CONTEXT.md, TECHNICAL_DEBT.md. ## Outputs TBD — `it_<iteration>_evaluation-report.md`. ## Checklist TBD
# refactor-prd (scaffold) <!-- TODO: Complete. All content in English. --> ## Objective TBD — Add refactor use cases to the iteration PRD (`it_<iteration>_PRD.json`), with associated regression tests if requested. ## Inputs TBD — `it_<iteration>_refactor_plan.md`, `it_<iteration>_PRD.json`. ## Outputs TBD — Updated `it_<iteration>_PRD.json`. ## Checklist TBD
Refines an existing test plan based on user feedback or adversarial challenge mode. Triggered by: bun nvst refine test-plan.
Fixes one issue from the iteration issues list by reproducing, diagnosing, and resolving it. Invoked by: bun nvst fix issue.
Gathers the requirement from the user and produces it_{iteration}_product-requirement-document.md. Triggered by: bun nvst define requirement.
Executes a batch of approved automated test cases and returns a strict JSON array of result payloads. Invoked by: bun nvst execute test-plan.
Executes a batch of approved test cases and returns a strict JSON array of result payloads. Invoked by: bun nvst execute test-plan.
Evaluates the prototype and produces an ordered refactor plan. Triggered by: bun nvst define refactor-plan.
Interactively defines one or more issues with the user. Triggered by: bun nvst create issue --agent <provider>.
# debug (scaffold) <!-- TODO: Complete. All content in English. --> ## Objective TBD — Understand error, review failing components, form hypotheses, instrument, reproduce, review logs, confirm hypothesis, fix, confirm fix, remove instrumentation, mark test as fixed. ## Inputs TBD — Failing test(s), codebase, logs. ## Outputs TBD — Code changes, `it_<iteration>_progress.json` test status updated (e.g. fixed). ## Checklist TBD
Applies a single approved refactor item (RI-NNN) to the codebase. Invoked by: bun nvst execute refactor.
Implements a single user story from the PRD: writes code and tests, follows project conventions. Invoked by: bun nvst create prototype.
Updates an existing product requirement document based on user feedback. Triggered by: bun nvst refine requirement.
Refines .agents/PROJECT_CONTEXT.md via editor mode or challenge mode. Challenge mode validates the document against the actual codebase and detects compliance issues. Triggered by: bun nvst refine project-context.
Refines an existing refactor plan based on user feedback or adversarial challenge mode. Triggered by: bun nvst refine refactor-plan.