AGENTS.md · git:20261022.3a04e3f · 2026-10-22 · sha256 a6bc8c9e567e708d
AGENTS.md git:20261022.3a04e3fA
Immutable. This exact content never changes and is served at /api/v1/blob/a6bc8c9e567e708d.
# Repository guidance This repository is the canonical shared source for cross-runtime rules and global core Skills. ## Development entry Start with `README.md`, then `README.zh-TW.md`, `PROJECT.yaml`, and `local_bridge/README.md`. The current Windows bridge fix is recorded by local commit `6d0cc96` on branch `codex/windows-bridge-lock-20261019`; do not push or merge it without approval. The portable worktree is a separate protected checkout. Treat its existing uncommitted files as user-owned evidence; do not clean, move, or rewrite them from this repository. - Start with `CANONICAL_MANIFEST.json` to resolve ownership and restore targets. - Shared rules live in `shared/rules/`; global Skills live in `shared/skills/GLOBAL_CORE/`. - Treat backups, generated copies, runtime caches, and open migration branches as evidence, not as canonical sources. - Keep root `SKILL.md` files focused on routing, essential workflow, and safety boundaries. Read linked references only when the current task needs them. - Use a clear specialized Skill directly; resolve routing only when multiple material paths remain. - Preserve model-agnostic shared behavior. Put model- or platform-specific behavior in the owning thin-adapter repository. - Make the smallest relevant change and use proportional validation. For Skill or manifest changes, run `pwsh -File scripts/validate-canonical-skills.ps1` and `git diff --check`. - Do not weaken approval or secret-handling boundaries, merge default branches, or overwrite unrelated work.