# Vendored agentnative-spec
This directory is a **vendored copy** of [`brettdavies/agentnative`](https://github.com/brettdavies/agentnative) — the
canonical specification of agent-native CLI principles. Files here are not edited by hand; they are mirrored from the
latest upstream `v*` tag and consumed by `build.rs` to generate the `REQUIREMENTS` slice at build time. The currently
vendored version is recorded in [`VERSION`](./VERSION).
For the full spec landing page — leaderboard, badge convention, and acknowledgements — see [anc.dev](https://anc.dev) or
the upstream [`README`](https://github.com/brettdavies/agentnative#readme).
## Resync
Run from the repo root:
```sh
scripts/sync-spec.sh # queries the remote for the latest v* tag; falls back to local on network failure
```
The script queries `https://github.com/brettdavies/agentnative.git` for the latest `v*` tag and shallow-clones that tag
into a temp directory for extraction. If the remote is unreachable, it falls back to a local checkout
(`$HOME/dev/agentnative-spec` by default; override with `SPEC_ROOT`). Override `SPEC_REMOTE_URL` to query a different
remote. The script extracts files via `git show`, so neither source's working tree is perturbed.
## Layout
| `VERSION` | `VERSION` | Spec version string; surfaced as `SPEC_VERSION` |
| `CHANGELOG.md` | `CHANGELOG.md` | Spec change history; informational |
| `principles/p*.md` | `principles/p*.md` | Frontmatter parsed by `build.rs` → `REQUIREMENTS` |
| `principles/scoring.md` | `principles/scoring.md` | Scoring-formula authority; reference only (not parsed by `build.rs`) |
## Licensing
Upstream content is licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). This crate is
dual-licensed MIT / Apache-2.0; vendoring a CC BY 4.0 source requires attribution only, satisfied by this README plus
the upstream project link in each principle's frontmatter `id` field.