Skip to content

[P1] Enforce Issue → branch → PR → Verifier delivery workflow #7

Description

@fxbin

Parent: #2

Problem

TopicEye already has repository engineering guidance, but recent delivery history does not consistently demonstrate the virtual-intelligent-dev-team GitHub loop. Direct-to-main commits reduce reviewability, regression isolation and parallel-worker safety.

WorkOrder

Lead: Git Workflow Guardian / Conductor

Scope

  1. Define branch naming: issue-<number>-<short-slug> (or equivalent documented convention).
  2. Require meaningful changes to have a GitHub Issue with context, scope, non-goals, acceptance criteria and verification plan.
  3. Require PRs to link the issue and include Worker evidence.
  4. Add/standardize PR template sections: WorkOrder, changes, tests, risks/rollback, verifier verdict, DeliveryCycleReport.
  5. Document independent verification policy: Verifier must not be the same implementation pass; remediation goes back to Worker and is re-verified.
  6. Require green required checks before merge where repository permissions/settings allow it.
  7. Document emergency/hotfix exception procedure and post-hoc audit requirement.

Acceptance criteria

  • Workflow contract is committed to repository documentation.
  • PR template encodes Worker → Verifier → DeliveryCycleReport.
  • New implementation work in this stabilization cycle uses issue-linked branches and PRs.
  • Direct-to-main delivery is no longer the normal path.
  • Branch-protection/ruleset configuration is reviewed by a repository admin; if automation cannot inspect/change it, the required manual setting is recorded explicitly.

Note

The connected GitHub App returned 403 when reading branch protection, so this issue does not assume the current protection state.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions