Skip to content

bugfix templates state commit-subject format as law: repo conventions turn it into blocking CMAP noise #1316

Description

@waleedkadous

Problem (production report)

protocols/bugfix/prompts/fix.md:56 templates the commit subject as exactly one form — Fix #{{issue.number}}: <brief description> — and consult-types/pr-review.md names two accepted forms (Fix #N: / [Bugfix #N]). A workspace whose own documented convention differs (reporting workspace uses [#NNNN] fix: ... per its CLAUDE.md) just had a codex CMAP reviewer raise the template form as a BLOCKING item against a defect-free PR — and satisfying it would have meant force-pushing over porch-tracked commits, strictly worse than the "violation."

Root shape: the templates state a style default as a rule, so reviewers enforce it as one. Same noise class as the (already-fixed) SPIR-criteria-on-bugfix problem from Fix #742 — this is its remaining tail.

Ask

  1. fix.md: mark the subject format as repo-convention-deferring — default Fix #N: <description> unless the repo's CLAUDE.md/AGENTS.md documents its own bugfix commit format, which takes precedence.
  2. pr-review.md: generalize the non-issues list entry — a commit subject that matches the repo's own documented convention is never a blocking finding; the only hard rule stays "not [Spec NNNN][Phase]" (protocol-identity confusion, not style).
  3. Mirror both trees (codev/ + codev-skeleton/), and grep for other prompts that state style defaults as law while at it (the review-template rot class).

Credit

Reported by a production workspace's architect with the live CMAP incident; the deference framing is theirs.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area/protocolsArea: Protocol definitions — distinct from area/porch (orchestration)

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions