AGENTS.md git:20261031.20ad90dA

Immutable. This exact content never changes and is served at /api/v1/blob/57c51b6d81e2dd93.

# ModelPlan public development

This repository is the canonical source for the public clients and publication reader. Write GitHub issues, PRs, comments and commits in English; discuss with the owner in their language.

## Source, data, visual and license changes

Before adding/exporting source, changing a dependency or license, editing visual assets, or changing a workflow, read [docs/source-policy.md](docs/source-policy.md). Run `node scripts/check-source-policy.mjs` before pushing. The root MIT license covers its declared software scope; per-file data and third-party notices govern their own material.

Public clients render published verdicts. Method explanations and source weights stay public. Production scoring/recommendation implementation, full calibration records and model entry/exit automation stay private. Do not export these, client-specific scorers, raw benchmark fixtures or collection/review/publishing/deployment machinery here.

## Implementation and verification

Keep the community build complete without private files, credentials or a sibling private checkout. Run the applicable checks documented in CONTRIBUTING.md, plus `npm ci --prefix reader && npm test --prefix reader` for reader changes. Preserve generated plugin runtime bundles and dependency locks. Hosted runners are the default; owner-only Mac checks may use the pinned reusable workflow under [the Mac CI admission contract](docs/mac-ci.md). Public PR code never uses private publishing runners.

Read the task's current issue/comments before editing and report concrete checks. Preserve existing MIT/CC grants and contributor/third-party notices when changing future licensing. Official visuals live in `desktop/official-visuals/` under their reserved license (`LicenseRef-ModelPlan-Visuals-1.0`, not MIT); put new official visual creations there and nowhere else, with the SPDX header or a listed hash. Unreleased designs (studies and prototypes) stay out of this repository until the owner releases them. Scoring, calibration and operations stay private.