Contribute
Feedback is managed in GitHub Issues so decisions stay public, reviewable, and traceable.
Suggest an improvement
- Open an issue: New issue
- Use a clear title with the affected rule, doc page, blog post, or workflow concept.
- Link the specific page and section.
- Describe the current problem, the expected improvement, and why it matters.
- 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.