Simplify

simplify - Quality Gate Stage

Invariants

• Review only the task scope and changed files.
• Do not add new product scope.
• Block major deviations before testing.
• Write durable findings to the task document.
• If the task doc has an Implementation Notes section but TASKS.md still shows the row in Planned or In Progress, reconcile the row to Testing before continuing — implement ran but missed its tracker update. If Implementation Notes is absent, do not reconcile; implement genuinely did not run and the user should be told.

Runtime adapters may expose this stage as a slash command, menu action, or natural-language skill invocation. The portable stage name is simplify.

Workflow

1. Read AGENTS.md.
2. Resolve the task ID and read docs/task/{ID}-{task-name}.md.
3. Identify changed files from Implementation Notes and git diff --name-only.
4. Read changed files only.
5. Check coding standards and maintainability.
6. Compare implementation against requirements, file changes, out-of-scope boundaries, and acceptance criteria.
7. Classify deviations.
8. Append Quality Gate Notes to the task document.
9. Return PASS or FAIL.

Standards Checklist

Apply where relevant:

• no unused code, dead code, or commented-out implementation
• no broad any or untyped escape hatches when the project has typed alternatives
• no deep nesting where guard clauses would be clearer
• functions and files have clear responsibility
• names describe behavior accurately
• repeated logic is extracted when repetition creates maintenance risk
• errors are handled intentionally
• no secrets, credentials, or debug logging in production paths
• project conventions from AGENTS.md, LEARNINGS.md, and the task doc are followed

Deviation Classification

Output In Task Document

## Quality Gate Notes

### Result
PASS | FAIL

### Standards Review
- {Finding or "No blocking issues"}

### Deviations
- {Deviation level and rationale}

### Required Fixes
- {Only if FAIL}

Handoff

PASS:

Quality gate passed for task {ID}
Next stage: test {ID}

FAIL:

Quality gate failed for task {ID}
Return to implementation with the required fixes listed in the task document.