docs(skill): refresh anc cross-references for v0.3.0 + RELEASES drift sweep + SYNCS map#14
Merged
Merged
Conversation
Closes the v0.3.0 gap that left the "fix → re-run → claim badge" loop incomplete. Compresses the 35-line update-check block buried above the first-action intent into a six-line stub plus a new references/update-check.md detail file. - Add new "The anc loop" section documenting schema 0.5 (`coverage_summary`, `badge.eligible`, `badge.score_pct`, `badge.embed_markdown`), the 80% eligibility floor, and the four `--audit-profile` categories (`human-tui` / `file-traversal` / `posix-utility` / `diagnostic-only`). - Bump vendored-spec prose reference v0.2.0 → v0.3.0 (aligns with spec/VERSION). - Document `anc skill install <host>` in the getting-started installer section, including `--dry-run`, `eval $(...)` capture, and `--output json`. - Expand description with Rust/clap and SKIP keywords for trigger reliability: routes TUI builders to `--audit-profile human-tui` and excludes non-CLI Rust questions. - Reframe update check as "First action: update check" and move snooze ladder, prompt copy, and state-dir layout into references/update-check.md.
Step 4 of "Releasing dev to main" replaced the single guarded-paths grep with a belt-and-suspenders sweep covering both directions of drift before the release tag goes out. - A: main → release (intended ship surface) - B: release → dev (catches non-doc paths missing from release) - C: dev → main (sanity on phantom-ahead state from squash rewrites) Adds a `git cherry HEAD origin/dev` patch-id check with squash-merge triage guidance: documents the three expected '+' line sources (historical squashes, conflict-resolved cherry-picks, intentionally skipped commits), what a real miss looks like, and a two-command triage recipe. Mirrors the same step that landed on agentnative-cli RELEASES.md during v0.3.0 prep, which caught 4 .github/ISSUE_TEMPLATE/*.yml files that had drifted on main since the v0.1.1 squash.
Routing map for how spec content flows into this repo and how the skill bundle flows out. Documents the four sync edges (spec → skill via sync-spec.sh, skill → consumer hosts via git clone, site → skill via daily ls-remote probe, skill ↔ site at the source.commit pin) with mechanism, payload, trigger/cadence, and drift-check columns. Includes inbound/outbound flowchart and a manifest-vs-bundle ownership diagram clarifying that agentnative-site/src/data/skill.json is the manifest source of truth — this repo owns bundle content, not the manifest. Per-script details stay in script headers; release-time re-vendor mechanics stay in RELEASES.md and spec/README.md. SYNCS.md is the top-level routing map that links them.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Three docs landings batched together since they all share the v0.3.0 release-prep arc:
agentnative-cliso thedev → release/mainflow catches drift in both directions.docs/SYNCS.mdrouting map for how spec content flows in and the bundle flows out.Changelog
Added
references/update-check.md— pulled-out operational detail for the consumer-side update-check script (prompt copy, snooze ladder, state-dir layout).SKILL.mddocumenting scorecard schema 0.5 fields (coverage_summary.must.verified,badge.eligible,badge.score_pct,badge.embed_markdown), the 80% badge eligibility floor, and the four--audit-profilecategories (human-tui,file-traversal,posix-utility,diagnostic-only).anc skill install <host>documented ingetting-started.md§ "Installing anc and this skill bundle" with--dry-run,eval $(...)capture, and--output jsonenvelope.docs/SYNCS.md— cross-repo sync map covering inbound (agentnativespec → this repo viascripts/sync-spec.sh) and outbound (this repo → consumer hosts;agentnative-sitedaily probe) edges, with manifest-vs-bundle ownership diagrams.Changed
SKILL.mdbumpedv0.2.0 → v0.3.0to matchspec/VERSION.SKILL.mddescription expanded with Rust/clap, scorecard, audit-profile, agent-native badge, andanc skill installkeywords plus a SKIP clause that routes TUI builders to--audit-profile human-tuiinstead of this skill.SKILL.md"Update check" block compressed from 35 lines (which buried the first-action intent) to a 6-line "First action: update check" stub; details moved toreferences/update-check.md.RELEASES.md§ "Releasing dev to main" step 4 — single guarded-paths grep replaced with a triple-diff verification block (A: main→release, B: release→dev, C: dev→main) plus agit cherry HEAD origin/devpatch-id check with squash-merge triage guidance. Mirrors the same step that landed onagentnative-cliduring v0.3.0 prep.Type of Change
docs: Documentation updateRelated Issues/Stories
Testing
Test Summary:
spec/VERSIONreads0.3.0so the prose bump aligns with the vendored snapshot.--audit-profilecategory list matchescargo run -- check --helpoutput from~/dev/agentnative-cliHEAD.coverage_summary,badge.*,audit_profile,tool/anc/run/target) against a livecargo run -- check --output json .invocation.Files Modified
Modified:
SKILL.md— compressed update-check block, added "The anc loop" section, expanded description with trigger keywords + SKIP clause, bumped spec ref to v0.3.0.getting-started.md— addedanc skill installexamples, badge claim step in the existing-CLI loop, schema-0.5 stop conditions,--audit-profilecategory list.RELEASES.md— step 4 triple-diff verification +git cherrypatch-id check with squash-merge triage guidance.Created:
references/update-check.md— operational details pulled out of SKILL.md (prompt copy, snooze ladder, state-dir layout).docs/SYNCS.md— cross-repo sync routing map.Renamed:
Deleted:
Breaking Changes
Deployment Notes
Checklist