Contribution¶

English | 日本語

Git と GitHub が system of record です。repository AGENTS.md を読み、該当 Issue を使用または 作成し、registered Issue-linked worktree だけで tracked change を作ります。通常変更は Pull Request 経由で main に入ります。

Verification¶

python3 scripts/verification_policy.py で artifact を分類し、反復中は focused check を使います。 特定の test module を実行するには、repository-relative な test path を指定して focused profile を使います。例:

python3 scripts/quality_gate.py run --profile focused --test tests/test_docs.py

tests/ は import package ではないため、python3 -m unittest tests.test_docs のような module invocation は使いません。focused profile は canonical な discovery-based test invocation を 維持します。

review-stable な code、configuration、packaging、installation contract、security、CI、test candidate は 次を実行します。

python3 scripts/quality_gate.py run --profile required

merge には exact-head hosted validate が必要です。failed、skipped、stale、unavailable の場合は 新しい exact-head hosted run が成功するまで acceptance を block し、local result で代替しません。

Documentation change¶

Documentation Governanceに従い、English canonical と official Japanese translation を同時更新し、machine-derived page を再生成します。

python3 scripts/docs.py generate
python3 scripts/docs.py check

check は strict MkDocs build を含みます。site/ の generated HTML は disposable/ignored です。