Issue-to-PR begins with an intake boundary

An issue is a request or signal, not yet an implementation plan. Convert it into a bounded goal, current behavior, desired behavior, scope, non-goals, acceptance, and verification before editing.

Keep external wording separate from facts confirmed in the repository.

StageOutput
IntakeIssue Intake Note
DiscoveryAffected files and behavior evidence
PlanningTASK_SPEC.md and PLAN.md
ImplementationSmall diff
ReviewChecks, findings, and decision

Issue-to-PR sequence

  1. Read the issue and identify missing information.
  2. Inspect the repository and confirm the affected area.
  3. Write the task boundary and stop conditions.
  4. Agree on a plan before editing.
  5. Implement one reviewable slice.
  6. Run focused checks and inspect the diff.
  7. Prepare a reviewer-ready handoff.

Intake record

# Issue Intake Note

Signal: <issue text>
Confirmed behavior: <facts>
Unknowns: <questions>
Candidate area: <paths>
Next check: <command or file>
Status: documented example.

Canonical lesson source · JavaRush

Open JavaRush material