AGENTS.md@.agents ยท diff

git:20260713.397aa15 to git:20260829.b2727a9

3 added, 0 removed. Audit A to A.

# `.agents/`
Public repository-scoped Agent Skills shared across Codex/OpenAI-compatible,
Claude Code, and Hermes runtimes.
## Contract
- [`.agents/skills/`](skills/) is the tracked source used by repository skill
discovery and by the cross-runtime installer.
- [`context-engineering.lock.json`](context-engineering.lock.json) pins the
upstream repository, revision, plugin version, inventory counts, and exact
content digest.
+ - Every immediate skill directory under [`skills/`](skills/) belongs to that
+ one pinned source. A skill from another upstream stays with its owning
+ infrastructure package unless a reviewed multi-source lock schema is added.
- Upstream skill directories retain their relative references and scripts.
Scripts are illustrative and must not be auto-executed.
- Runtime-specific policy belongs in an explicit overlay recorded by the lock,
not in an unrecorded per-runtime copy.
## Verification
```bash
uv run python -m infrastructure.skills runtime-status
uv run python -m infrastructure.skills check
uv run python -m infrastructure.skills operations-check
```
Use `... infrastructure.skills runtime-install` only for an intentional user-level install. It
moves same-name existing paths to timestamped backups before linking the pinned
shared store.