@getvitops/create 0.9.0-alpha.2 → 0.9.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @getvitops/create
 
+## 0.9.0-alpha.3
+
+### Patch Changes
+
+- 8543f73: `vitops agents` (also `vitops agents sync`) now keeps a short fenced block at the **top** of `AGENTS.md` instead of appending a long one. The block names the config, says to prefer the framework's classes, and links the skills linked under `.agents/skills` from installed `@getvitops/*` packages (with a one-line "use when …" from each), plus `vitops docs <topic>` for reference; the generate-command list and the topic list are gone. A later run replaces only that block in place and leaves the rest of the file alone; with no block, it is added at the top; a block from an older release is updated where it is. The command also links every skill an installed `@getvitops/skills` ships, so it works without the `skills` CLI. The templates run it from `prepare` and ship the block already in `AGENTS.md`.
+
 ## 0.9.0-alpha.2
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getvitops/create",
-  "version": "0.9.0-alpha.2",
+  "version": "0.9.0-alpha.3",
   "description": "Project templates for the Vitops design system — scaffold wired-up sites with `vp create @getvitops`.",
   "homepage": "https://docs.vitops.ca",
   "bugs": "https://github.com/getvitops/design-system/issues",
@@ -19,7 +19,7 @@
     "access": "public"
   },
   "devDependencies": {
-    "@getvitops/generator": "8.3.0-alpha.2"
+    "@getvitops/generator": "8.3.0-alpha.3"
   },
   "engines": {
     "node": ">=24"

package/templates/emdash/AGENTS.md

@@ -1,3 +1,18 @@
+<!-- vitops:start -->
+
+Built with the Vitops design system (`@getvitops/*`); tokens and site facts live in `site.json`.
+Prefer its classes and patterns over hand-written CSS. Load the skill that matches the task:
+
+- [contact-form](.agents/skills/contact-form/SKILL.md) — Use when adding or changing a form, fixing submissions that don't arrive, setting up noti…
+- [content-and-deploys](.agents/skills/content-and-deploys/SKILL.md) — Use for any deploy or build problem, stale or missing content, "my publish isn't live", s…
+- [csp](.agents/skills/csp/SKILL.md) — Use when changing `public/_headers`, adding an embed, tracking snippet or third-party scr…
+- [custom-blocks](.agents/skills/custom-blocks/SKILL.md) — Use before creating, renaming or deleting any block type, any `src/components/blocks/*` r…
+- [vitops-design-system](.agents/skills/vitops-design-system/SKILL.md) — Use when styling or authoring pages or components (choosing utility/pattern classes, colo…
+
+Reference, rendered from this project: `vitops docs <topic>` (no topic lists them).
+<!-- managed by `vitops agents sync` · @getvitops/cli@8.3.0-alpha.2 — edit outside this block -->
+<!-- vitops:end -->
+
 This is an EmDash CMS website (Astro on Cloudflare Workers, D1 + R2 — public pages
 prerendered, the Worker serving the admin and API) styled by the Vitops design system.
 
@@ -22,7 +37,7 @@ prerendered, the Worker serving the admin and API) styled by the Vitops design s
 - Keep the Worker cron trigger in `wrangler.jsonc`: it publishes content scheduled in the admin.
 - `src/assets/placeholder/` is wireframe stand-in imagery; delete it once real assets land.
 - Prefer framework classes (utilities, patterns, type roles like `font-heading`) over bespoke CSS.
-  `vp exec vitops agents` appends the full class reference to this file.
+  `vp exec vitops docs classes` prints the full class reference.
 - `SETUP.html` is the onboarding checklist (`.agents/skills/setup/`). Tick a box only for a step you
   completed, never for a human-only one (the Cloudflare API token, domain cutover, legal documents).
 

package/templates/emdash/README.md

@@ -147,8 +147,8 @@ and media in the storage backend (bucket/directory copy).
   agents answer from current documentation. Your running site also exposes its
   own content MCP server at `/_emdash/api/mcp` (authenticated).
 - **Skills** (`.agents/skills/`): `promote` dispatches the dev → main
-  promotion workflow. Run `vp exec vitops agents` to also write the design-system
-  class reference into `AGENTS.md`.
+  promotion workflow. The short block at the top of `AGENTS.md` (fenced by
+  `<!-- vitops:start -->`) lists the toolkit skills; `vp install` refreshes it (`vitops agents sync`).
 - **EmDash skills** are installed per project so they match the pinned `emdash`
   version: `vp dlx skills add emdash-cms/skills --skill '*' -y`,
   then commit `.agents/skills/`, the `.claude/skills/` symlinks and `skills-lock.json`. Update with
@@ -173,7 +173,7 @@ Useful commands (via `@getvitops/cli`):
 
 ```bash
 vp exec vitops validate site.json   # check the config against the schema
-vp exec vitops agents               # write the design-system reference into AGENTS.md
+vp exec vitops agents sync          # refresh the managed block at the top of AGENTS.md and link the skills
 vpr build:css                  # regenerate the CSS manually
 ```
 

package/templates/emdash/package.json

@@ -18,7 +18,7 @@
     "build:css": "vitops generate -i site.json -f tailwind -o src/styles",
     "lint:design": "vitops lint -i site.json -f tailwind --strict",
     "sop": "vitops generate -i site.json -f css -o .vitops/sop",
-    "prepare": "vp config && skills experimental_sync -y -a claude-code --no-frozen-lockfile"
+    "prepare": "vp config && skills experimental_sync -y -a claude-code --no-frozen-lockfile && vitops agents sync -i site.json"
   },
   "dependencies": {
     "@astrojs/cloudflare": "^14.0.0",

package/templates/static/AGENTS.md

@@ -1,3 +1,18 @@
+<!-- vitops:start -->
+
+Built with the Vitops design system (`@getvitops/*`); tokens and site facts live in `site.json`.
+Prefer its classes and patterns over hand-written CSS. Load the skill that matches the task:
+
+- [contact-form](.agents/skills/contact-form/SKILL.md) — Use when adding or changing a form, fixing submissions that don't arrive, setting up noti…
+- [content-and-deploys](.agents/skills/content-and-deploys/SKILL.md) — Use for any deploy or build problem, stale or missing content, "my publish isn't live", s…
+- [csp](.agents/skills/csp/SKILL.md) — Use when changing `public/_headers`, adding an embed, tracking snippet or third-party scr…
+- [custom-blocks](.agents/skills/custom-blocks/SKILL.md) — Use before creating, renaming or deleting any block type, any `src/components/blocks/*` r…
+- [vitops-design-system](.agents/skills/vitops-design-system/SKILL.md) — Use when styling or authoring pages or components (choosing utility/pattern classes, colo…
+
+Reference, rendered from this project: `vitops docs <topic>` (no topic lists them).
+<!-- managed by `vitops agents sync` · @getvitops/cli@8.3.0-alpha.2 — edit outside this block -->
+<!-- vitops:end -->
+
 This is a static Astro website styled by the Vitops design system, deployed
 as Cloudflare Workers static assets (no server runtime, no database).
 
@@ -14,8 +29,8 @@ as Cloudflare Workers static assets (no server runtime, no database).
   portrait, landscape; SVG + PNG) for layout work before real imagery
   exists. Delete the directory once real assets land.
 - Prefer framework CSS classes (utilities, patterns, type roles like
-  `font-heading`) over bespoke CSS. Run `vp exec vitops agents` to append the
-  full generated class-vocabulary reference to this file.
+  `font-heading`) over bespoke CSS. `vp exec vitops docs classes` prints the
+  full class vocabulary.
 - **Layout foundations — these are the answer, not a starting point.** Six
   substitutions carry the structure of nearly every page:
   | About to write…                                         | Write instead   |

package/templates/static/package.json

@@ -16,7 +16,7 @@
     "build:css": "vitops generate -i site.json -f css -o src/styles",
     "lint:design": "vitops lint -i site.json -f css --strict",
     "sop": "vitops generate -i site.json -f css -o .vitops/sop",
-    "prepare": "vp config && skills experimental_sync -y -a claude-code --no-frozen-lockfile"
+    "prepare": "vp config && skills experimental_sync -y -a claude-code --no-frozen-lockfile && vitops agents sync -i site.json"
   },
   "dependencies": {
     "@getvitops/astro": "latest",