Skip to content

Latest commit

 

History

History
44 lines (31 loc) · 1.6 KB

File metadata and controls

44 lines (31 loc) · 1.6 KB

Contributing

Scope Discipline

Contributions should strengthen the repository's role as a research-and-synthesis project focused on coding-agent runtime behavior. Keep business-domain workflows, product marketing, and implementation-heavy detours out of the core unless they directly clarify runtime semantics.

Accepted Contribution Types

  • Source-backed system reviews.
  • Pattern pages grounded in at least one verified implementation and ideally more than one.
  • Corrections to factual claims.
  • Better diagrams and comparative matrices.
  • Narrower, clearer definitions of runtime boundaries.
  • Build-from-zero guidance that reflects the current synthesis.

Evidence Rules

  1. Prefer primary sources such as source code, docs, issue threads, and design notes.
  2. Mark confidence explicitly when evidence is partial.
  3. Separate observed behavior from proposed standardization.
  4. State when a conclusion is inferred rather than directly documented.

Review Standard

Every system review should end with:

  1. reusable runtime patterns,
  2. non-transferable product specifics,
  3. confidence level,
  4. open questions.

Style Guide

  • Be direct and concrete.
  • Favor behavior descriptions over feature marketing.
  • Use the shared terminology from research/glossary.md.
  • Keep implementation advice narrow and evidence-backed.

Pull Request Expectations

  1. Describe the claim being added or revised.
  2. Link the sources that justify the change.
  3. Note whether the change affects the runtime contract, pattern catalog, or corpus status.
  4. Update the relevant matrix or synthesis page when needed.