This directory is a vendored copy of 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 ship inside the skill bundle so consumers carry the canonical principle text alongside the
skill metadata. Each release of this bundle re-vendors against the latest spec tag. The currently vendored version is
recorded in VERSION.
For the full spec landing page — leaderboard, badge convention, and acknowledgements — see anc.dev or
the upstream README.
Run from the repo root:
scripts/sync-spec.sh # queries the remote for the latest v* tag; falls back to local on network failureThe 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.
| Path | Source in agentnative-spec |
Purpose |
|---|---|---|
VERSION |
VERSION |
Spec version string; the skill's vendored SPEC_VERSION |
CHANGELOG.md |
CHANGELOG.md |
Spec change history; informational |
principles/p*.md |
principles/p*.md |
Frontmatter requirements[] is the machine-readable contract |
principles/scoring.md |
principles/scoring.md |
Leaderboard formula, badge eligibility floor, and color bands |
Each principle file has a YAML frontmatter block with id, title, last-revised, status, and requirements[].
Each requirements[] entry carries a stable id (e.g. p1-must-no-interactive), a level (must/should/may), an
applicability (universal or {if: <reason>}), and a one-sentence summary. The anc auditor
(brettdavies/agentnative-cli) emits these IDs in its scorecard so
agents can navigate from a finding directly to the requirement.
Upstream content is licensed under CC BY 4.0. This skill bundle is
dual-licensed under MIT or 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.