diff --git a/AGENTS.md b/AGENTS.md
index c8bd4d9..493ec49 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -2,7 +2,7 @@
 
 This repository packages Vstack for Claude Code, Codex, and Cursor. `vllnt/skills` owns portable skill content; `upstream.lock.json` selects its immutable commit. Do not edit upstream or generated skill copies here.
 
-- `scripts/sync.py` owns host manifests, marketplace catalogs, generated packages, and the Cursor principles adapter. `VERSION` owns the shared package version.
+- `scripts/sync.py` owns host manifests, marketplace catalogs, generated packages, and the Cursor principles adapter. `VERSION` owns the shared package version. `assets/` owns distribution branding, such as the Claude plugin icon.
 - `plugins/{claude,codex,cursor}/` and the three host marketplace JSON files are generated and committed. Change the pin or generator, then regenerate; do not hand-edit output. Preserve unrelated plugin directories.
 - Keep host integration separate from consumer permissions and architecture. Do not add hooks, services, or automatic principle activation for another host without evidence and an explicit request.
 - Verify with `python3 -m unittest discover -s tests -v` and `python3 scripts/sync.py --check`, then `git diff --check`. `--source /path/to/skills` checks the pinned local Git objects offline, not working-tree edits.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 708d211..2e4edfa 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,8 @@
 
 ## Unreleased
 
+- Refresh README and AGENTS guidance: vllnt introduction, current canary status and install evidence, directory submission state, and asset ownership.
+
 ## 0.1.0-canary.3
 
 - Describe Vstack as part of the vllnt universe and set the Claude plugin homepage to https://vllnt.com.
diff --git a/README.md b/README.md
index 5ea569f..4ef1dcf 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,10 @@
 # Vstack
 
-One distribution repository for Vstack plugins for **Claude Code, Codex, and Cursor**.
+One distribution repository for Vstack plugins for **Claude Code, Codex, and Cursor**: evidence-led engineering workflows to plan, build, review, and ship software with AI agents. Vstack is part of the [vllnt](https://vllnt.com) universe of open, sovereign tools, built for freedom by design.
 
 ## Install in Claude Code
 
-The Claude Code plugin is in canary (`0.1.0-canary.N`) while installation from GitHub is verified; Codex and Cursor follow. Stable `0.1.0` is released once all hosts pass.
+The Claude Code plugin is in canary (`0.1.0-canary.N`): installation from GitHub is verified, while skill behavior is still being accepted. Codex and Cursor follow. Stable `0.1.0` is released once all hosts pass.
 
 ```text
 /plugin marketplace add vllnt/stack
@@ -149,9 +149,9 @@ Automatic repository synchronization was independently verified on 2026-09-21. A
 
 Live testing caught a generated-help false hold and post-push PR-head propagation timing; fixes were reviewed and merged through PRs #5 and #6, with 37 regression tests passing. The fresh PR #7 case required neither manual metadata repair nor manual merge. Daily fallback is configured; its timer was not waited for. Push delivery, manual resends, automatic merging, and manual no-op execution were observed.
 
-Claude Code 2.1.283 (2026-09-27): `claude plugin validate` passes for the catalog and plugin; a local-directory marketplace install into an isolated configuration installed `vstack@vllnt-stack` 0.1.0-canary.1 with all 22 skills, and a maintainer session with the local install listed every `vstack:*` skill. After `vllnt/stack` became public (merge `c3ad08c08fe460ed4f2e1a40630afe4001ddd23c`), an anonymous clone succeeded, and `/plugin marketplace add vllnt/stack` plus `/plugin install vstack@vllnt-stack` in a clean configuration installed `0.1.0-canary.1` from the GitHub source; a headless session there listed exactly the 22 `vstack:*` skills. Skill invocation behavior (including `plan-work` staying read-only), automatic skill selection, and the rest of the acceptance checklist remain unverified.
+Claude Code 2.1.283 (2026-09-27): `claude plugin validate` passes for the catalog and plugin; a local-directory marketplace install into an isolated configuration installed `vstack@vllnt-stack` 0.1.0-canary.1 with all 22 skills, and a maintainer session with the local install listed every `vstack:*` skill. After `vllnt/stack` became public (merge `c3ad08c08fe460ed4f2e1a40630afe4001ddd23c`), an anonymous clone succeeded, and the CLI equivalents `claude plugin marketplace add vllnt/stack` plus `claude plugin install vstack@vllnt-stack` in a clean, credential-free configuration installed `0.1.0-canary.1` from the GitHub source; a headless session there listed exactly the 22 `vstack:*` skills. The same commands after merge `915a4d0d519d726f84185ec698b3ed3f4c925cb8` installed `0.1.0-canary.3` with its icon, updated description, and 22 skills. The in-chat `/plugin` forms were not run separately. Skill invocation behavior (including `plan-work` staying read-only), automatic skill selection, and the rest of the acceptance checklist remain unverified.
 
-**Codex and Cursor installation, and startup/context-loss behavior in every host, remain unverified.** No public marketplace submission, release tag, or automatic Claude/Codex principle loading has been performed.
+**Codex and Cursor installation, and startup/context-loss behavior in every host, remain unverified.** The repository is public and installable as a GitHub marketplace. A Claude plugin directory submission is in validation and is not listed yet. No release tag or automatic Claude/Codex principle loading exists.
 
 Host format sources consulted during initialization: