Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
20 lines (14 loc) · 1005 Bytes

CONTRIBUTING.md

File metadata and controls

20 lines (14 loc) · 1005 Bytes
Raw

Contributing

Thanks for helping improve Codebase Design Router.

Principles

  • Keep route-codebase-design a thin routing layer. Design guidance belongs in codebase-design.
  • Preserve normal model freedom for tasks that do not introduce an interface, module-depth, seam-placement, or testability decision.
  • Prefer defer over premature restructuring when the root cause is unknown.
  • Make routing criteria observable and discriminating; avoid broad rules that capture routine coding work.
  • Preserve explicit user direction over automatic routing.

Development

  1. Create a focused branch.
  2. Change the smallest relevant skill or supporting document.
  3. Run python3 tests/validate_skills.py.
  4. In the pull request, explain which realistic request was misrouted and why the new rule improves it without attracting unrelated tasks.

Behavioral changes should include at least one use, skip, or defer example in the pull-request description. Avoid tests that only freeze exact prose.