Skip to main content

Contribute

Feedback is managed in GitHub Issues so decisions stay public, reviewable, and traceable.

Suggest an improvement

  1. Open an issue: New issue
  2. Use a clear title with the affected rule, doc page, blog post, or workflow concept.
  3. Link the specific page and section.
  4. Describe the current problem, the expected improvement, and why it matters.
  5. If relevant, include a concrete wording proposal.

Strong contribution targets

Especially useful contributions include:

  • unclear execution-mode boundaries
  • weak completion criteria
  • missing or weak evidence expectations
  • blocker-handling ambiguity
  • exploratory-review loopholes
  • persistence-proof gaps
  • weak checkpoint/report examples
  • workflow wording that is easy to game or misread

Preferred issue types

Contribution principles

  • Preserve intent over surface wording.
  • Keep governance reusable across projects and providers.
  • Avoid project-specific tool lock-in in core rules.
  • Prefer guidance that is hard to misread and hard to execute badly.
  • If a rule sounds good but is easy to game, keep improving it.