Work on an approved issue
A maintainer approved this issue for delivery. Classify the requested work before editing, then use the matching path below. The work command replaces the old choice between fix and implement; the issue type determines the method and result fields.
Bug path
For a reported defect:
- Reproduce the reported behavior with the smallest meaningful failing test or browser journey.
- Diagnose the defect in the current source and verify that the proposed behavior is correct.
- Add the regression test before the fix, implement the smallest backwards-compatible correction, and rerun the focused test.
- Set
fixed: trueonly afterpublish_candidatesucceeds. Report the reproduction and verification evidence.
If reporter-only information prevents a reproduction attempt, report verdict: "unclear" and ask for that specific information. If the behavior is intended or the fix needs a product, security, migration, or breaking-change decision, do not edit. Report the evidence and decision needed.
Enhancement or task path
For approved new behavior, documentation, maintenance, or another directed task:
- Treat the issue and maintainer directive as the specification. Resolve details from existing APIs and conventions without inventing a bug verdict.
- Implement the smallest complete change and add focused behavior coverage through existing test infrastructure.
- Run the affected checks and publish the candidate even if a relevant check still fails after a reasonable repair attempt.
- Set
implemented: trueonly afterpublish_candidatesucceeds. Report the observable change and exact verification results.
Shared constraints
- Read
AGENTS.mdand the relevant implementation and tests before editing. - Use
edit_fileorwrite_filefor direct edits. Useexecfor local Git operations, generators, formatters, tests, builds, and conflict resolution; shell writes are checkpointed into the durable workspace. - Do not edit
.github/workflows, push from the execution container, or perform unrelated cleanup. - Add a changeset when a published package changes. Keep user-facing documentation useful to someone adopting the change.
- Use
fixedfor a bug orimplementedfor an enhancement/task. Never set both. - Run one final focused verification pass after the last edit, then call
publish_candidateandreport_resultexactly once.