Skip to content

DEV-010.md

Latest commit

 

History

History
30 lines (23 loc) · 981 Bytes

DEV-010.md

File metadata and controls

30 lines (23 loc) · 981 Bytes
Raw
id DEV-010
title Enforce One Behavior Per Rule File
status active
enforcement manual
severity error

Problem

A rule that bundles several behaviors, or one behavior spread across several files, cannot be checked or referenced cleanly. A reviewer cannot say whether a subject passes it, and other rules cannot depend on a precise, single thing.

Solution

A rule is only enforceable if it makes one claim you can check. Bundle two and a reviewer can pass half and fail half with no clear verdict. Scope each file to one behavior, using two quick tests:

  1. If the title needs "and" to join unrelated behaviors, split it into two rules.
  2. If one behavior only makes sense beside another, keep them apart and couple them through depends_on instead of merging.

Acceptance Criteria

  • The rule describes exactly one behavior
  • The behavior can be checked pass or fail against a single subject
  • No unrelated behavior shares the file