Skip to content

Clarify issue format: keep technical decisions and implementation plan in PR artifacts #96

Description

Issue descriptions should stay on the functionality/request side and avoid prescribing implementation approach. The agent's role at issue stage is to collect and clarify requests; the team decides solution design during planning and PR review.

Request

Update issue-format guidance so default issue bodies focus on user problem, functional outcomes, and acceptance criteria, while intentionally avoiding technical design decisions and implementation planning details.

Desired outcome

  • Issue captures what is needed and why it matters
  • Issue avoids how to implement
  • Team and reviewers decide architecture/implementation in planning + PR artifacts
  • Guidance explicitly discourages embedding solution design in issue bodies

References

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions