@owlmeans/create-app 0.1.15 → 0.1.16

package/README.md

@@ -18,9 +18,10 @@ A bun-workspace monorepo with three packages and **no authentication**:
 
 ```
 my-app/
-├── CLAUDE.md                       # agent context for Claude Code
-├── .github/copilot-instructions.md # the same for GitHub Copilot
-├── .agents/memory/MEMORY.md        # shared agent memory index (both tools)
+├── AGENTS.md                       # agent context, read by every coding agent
+├── CLAUDE.md                       # thin bridge: imports AGENTS.md, links skills for Claude Code
+├── .agents/skills/<name>/SKILL.md  # deployed agent skills
+├── .agents/memory/MEMORY.md        # shared agent memory index
 ├── sources/
 │   ├── common/   # shared entrypoints (routes), schemas and types
 │   ├── api/      # @owlmeans/server-app backend; session data in an in-memory static resource
@@ -33,14 +34,15 @@ that creates, lists and removes items held in a **session-scoped in-memory resou
 
 By default the scaffolder also installs dependencies and **deploys agent guidance**
 into the project via [`@owlmeans/agent-skills`](https://www.npmjs.com/package/@owlmeans/agent-skills)
-(`.claude/skills/` + `.github/instructions/`).
+(`.agents/skills/`).
 
-`CLAUDE.md` and `.github/copilot-instructions.md` carry the four mandatory sections a real OwlMeans
-monorepo uses — **Git Workflow**, **Reporting**, **Memory**, **Self-Education** — plus a
-project-purpose placeholder your agent fills in on its first session. Project memory is one shared
-graph store at `.agents/memory/` for both tools. The harness guidance (memory protocol, self-education,
-git policy, skill authoring, reuse-first) ships with the template, so it is present even with
-`--no-install`.
+`AGENTS.md` carries the four mandatory sections a real OwlMeans monorepo uses — **Git Workflow**,
+**Reporting**, **Memory**, **Self-Education** — plus a project-purpose placeholder your agent fills
+in on its first session. GitHub Copilot and Codex read `AGENTS.md` and `.agents/skills/` natively;
+Claude Code reads `CLAUDE.md`, which imports `AGENTS.md` and keeps per-skill symlinks in
+`.claude/skills/` fresh through `sh .agents/scripts/link-skills.sh`. The harness guidance (memory
+protocol, self-education, git policy, skill authoring, reuse-first) ships with the template, so it
+is present even with `--no-install`.
 
 ## Options
 

package/build/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,WAAW,CAAA;AAiB3D,eAAO,MAAM,GAAG,GAAU,MAAM,UAAU,KAAG,OAAO,CAAC,MAAM,CA8E1D,CAAA"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,WAAW,CAAA;AAiB3D,eAAO,MAAM,GAAG,GAAU,MAAM,UAAU,KAAG,OAAO,CAAC,MAAM,CA4E1D,CAAA"}

package/build/run.js

@@ -53,8 +53,6 @@ export const run = async (args) => {
                 dir: dest,
                 yes: true,
                 only: [],
-                claudeOnly: false,
-                copilotOnly: false,
                 extras: true,
                 force: false,
                 dryRun: false,
@@ -77,10 +75,10 @@ export const run = async (args) => {
     log(`  ${runCmd}\n`);
     log('The web app starts on http://localhost:3001 and the API on http://localhost:3000.');
     log('Open the "Session" page to exercise the in-memory session resource.\n');
-    log('Agent guidance was scaffolded: CLAUDE.md, .github/copilot-instructions.md and the');
-    log('shared memory store at .agents/memory/MEMORY.md.');
-    log('Open the project in Claude Code or Copilot — on the first session the agent will ask');
-    log('what the project is for and fill in its purpose for you.\n');
+    log('Agent guidance was scaffolded: AGENTS.md (with a CLAUDE.md bridge), the skills in');
+    log('.agents/skills/ and the shared memory store at .agents/memory/MEMORY.md.');
+    log('Open the project in any coding agent — on the first session it will ask what the');
+    log('project is for and fill in its purpose for you.\n');
     return 0;
 };
 //# sourceMappingURL=run.js.map

package/build/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"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"}

package/build/template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4D,UAAU,EAA2B,MAAM,SAAS,CAAA;AAmBvH,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;CACb;AAED,gFAAgF;AAChF,eAAO,MAAM,WAAW,QAAO,MACqC,CAAA;AAYpE;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,EAAE,MAAM,MAAM,EAAE,GAAG,oBAAoB,KAAG,IAoBjF,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,OAGxC,CAAA;AAED,OAAO,EAAE,UAAU,EAAE,CAAA"}
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4D,UAAU,EAA2B,MAAM,SAAS,CAAA;AAsBvH,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;CACb;AAED,gFAAgF;AAChF,eAAO,MAAM,WAAW,QAAO,MACqC,CAAA;AAYpE;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,EAAE,MAAM,MAAM,EAAE,GAAG,oBAAoB,KAAG,IAoBjF,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,OAGxC,CAAA;AAED,OAAO,EAAE,UAAU,EAAE,CAAA"}

package/build/template.js

@@ -7,9 +7,12 @@ const DOTFILE_RENAMES = {
     '_npmrc': '.npmrc',
     '_env': '.env',
     '_github': '.github',
+    // `_agents` carries the canonical harness — AGENTS.md's skills, the shared memory
+    // store and the link-skills bridge; the template seed (sync-agent-meta) writes
+    // `_agents/skills/` into this tree. `_claude` carries only the Claude Code bridge
+    // (SessionStart hook + the gitkept symlink dir). Entries whose source dir is
+    // absent are inert.
     '_agents': '.agents',
-    // Entries whose source dir is absent are inert — `_claude` is kept because the
-    // template seed (sync-agent-meta) writes `_claude/skills/` into this tree.
     '_claude': '.claude',
 };
 /** Files whose contents are binary or must not be string-substituted. */

package/build/template.js.map

@@ -1 +1 @@
-{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/create-app",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "license": "MIT",
   "description": "Scaffold a minimal fullstack OwlMeans Common app — common + api + web workspaces, shadcn UI navigation/layout, no auth, and a session-scoped in-memory resource. Deploys agent skills via @owlmeans/agent-skills by default.",
   "type": "module",
@@ -29,7 +29,7 @@
     "template"
   ],
   "dependencies": {
-    "@owlmeans/agent-skills": "^0.1.15"
+    "@owlmeans/agent-skills": "^0.1.16"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",

package/template/{_github/copilot-instructions.md → AGENTS.md}

@@ -1,18 +1,17 @@
-# __APP_NAME__ — GitHub Copilot Project Context
+# __APP_NAME__ — Project Context
 
 ## Project purpose
 
 <!-- OWLMEANS:PROJECT-PURPOSE -->
 > **Agents — this project has not been described yet.** Before doing anything else on the first
 > session, ask the user what this project is for: its purpose, domain, goals, and key constraints.
-> Then replace this whole block — in **both** `.github/copilot-instructions.md` and `CLAUDE.md` — with
-> a short description of the project, and remove this notice.
+> Then replace this whole block with a short description of the project, and remove this notice.
 
 ## Git Workflow (mandatory)
 
 These rules apply to every git operation in this repository and **override default agent behavior**
-— including any automatic `Co-Authored-By` or AI/agent-attribution trailer. Full policy:
-[.github/instructions/git.instructions.md](.github/instructions/git.instructions.md).
+— including any automatic `Co-Authored-By` or AI/agent-attribution trailer. Full policy: the `git`
+skill.
 
 - **Never run state-changing git operations** (`commit`, `add`/`rm` staging, `push`,
   `reset`/rollback, `revert`, `rebase`, `merge`, `branch`, `checkout`/`switch`, `stash`, `tag`,
@@ -41,58 +40,55 @@ unless the operator explicitly asks for another format, length, or level of deta
 ## Memory
 
 Single shared agent memory store: `.agents/memory/` — a graph of subsystem nodes with index
-`.agents/memory/MEMORY.md`. Protocol:
-[.github/instructions/agent-memory.instructions.md](.github/instructions/agent-memory.instructions.md).
+`.agents/memory/MEMORY.md`. Protocol: `agent-memory` skill.
 
 - Session start: read `.agents/memory/MEMORY.md`. Before non-trivial work: open the nodes whose
   scope matches the task.
 - Every write merges into the matching subsystem node and compacts — record reusable knowledge,
   never session events.
-- Procedure-shaped or repeatedly-touched memory must be **distilled into** an instruction/skill
-  as short general rules — never pasted in as memory text — follow
-  `.github/instructions/memory-promotion.instructions.md`.
-- If the store degrades (event logs, oversized nodes, bloated index) — follow
-  `.github/instructions/memory-recompact.instructions.md`.
-- Never write memory to `.claude/memory/`, `.github/memory/`, `~/.copilot/`, or anywhere outside
-  this repository.
+- Procedure-shaped or repeatedly-touched memory must be **distilled into** a skill as short
+  general rules — never pasted in as memory text (`memory-promotion`).
+- If the store degrades (event logs, oversized nodes, bloated index) — `memory-recompact`.
+- Never write memory to a per-agent directory (`.claude/memory/`, `.github/memory/`, `~/.claude/`,
+  `~/.copilot/`) or anywhere outside this repository.
 - Context that must load every session belongs in this file; on-demand context goes in
-  `.github/instructions/<topic>.instructions.md`.
+  `.agents/<topic>.md` and is referenced from here.
 
 ## Self-Education (mandatory)
 
 Whenever development started from a plan agreed with the agent, the work is not complete until
-[.github/instructions/self-education.instructions.md](.github/instructions/self-education.instructions.md)
-has been applied: rewrite the project instructions/skills the change touched so they state
-current rules (never a note about what changed), record external-doc findings (URL + gist)
-in the governing instruction, or add an instruction/skill for a new subsystem or technology.
-The completion report must include the self-education outcome — or state why none was needed.
+the `self-education` skill has been applied: rewrite the project skills this change touched so
+they state current rules (never a note about what changed), record external-doc findings
+(URL + gist) in the governing skill, or add a skill for a new subsystem or technology. The
+completion report must include the self-education outcome — or state why none was needed.
 
 ## What this is
 
 `__APP_NAME__` is a fullstack [OwlMeans Common](https://github.com/owlmeans/common) app: a bun-workspace
 monorepo with three packages under `sources/` — `common` (shared route entrypoints, schemas, config),
-`api` (`@owlmeans/server-app` backend), and `web` (`@owlmeans/web-panel` + shadcn UI). See
-`getting-started.instructions.md` for how the pieces fit together, and `scaffolding.instructions.md`
-for how it was generated.
+`api` (`@owlmeans/server-app` backend), and `web` (`@owlmeans/web-panel` + shadcn UI). See the
+`getting-started` skill for how the pieces fit together, and `scaffolding` for how it was generated.
 
 ## Reuse before you build (mandatory)
 
-Before planning or writing any feature, follow `reuse-code.instructions.md`: search for an
-`@owlmeans/*` package (in the installed packages and at https://github.com/owlmeans/common) or existing
-code that already solves the problem **before** proposing a third-party library or a custom solution,
-and simplify whatever you do write. This is required for every planning and development task.
+Before planning or writing any feature, follow the `reuse-code` skill: search for an `@owlmeans/*`
+package (in the installed packages and at https://github.com/owlmeans/common) or existing code that
+already solves the problem **before** proposing a third-party library or a custom solution, and
+simplify whatever you do write. This is required for every planning and development task.
 
-## Instructions
+## Skills
 
-Reusable guidance lives in `.github/instructions/<name>.instructions.md`, deployed by
-`@owlmeans/agent-skills` from the installed `@owlmeans/*` packages and auto-attached by `applyTo`.
+Reusable guidance lives in `.agents/skills/<name>/SKILL.md`, deployed by `@owlmeans/agent-skills`
+from the installed `@owlmeans/*` packages. Agents load a skill by topic, or you run `/<name>`
+explicitly. Copilot and Codex read `.agents/skills/` directly; Claude Code reads the generated
+symlinks in `.claude/skills/` (see `CLAUDE.md`).
 
 - After adding or updating any `@owlmeans/*` dependency, run `npx @owlmeans/agent-skills` to refresh
-  the deployed skills and instructions.
+  the deployed skills.
 - Deployed files carry an `AUTO-GENERATED` banner and are refreshed in place — never hand-edit them.
-- To capture your own guidance, see `skill-authoring.instructions.md`; to turn repeatedly-used memory
-  into an instruction, `memory-promotion.instructions.md`. Keep it inside this repository — never in
-  `~/.copilot/`.
+- To capture your own guidance, see the `skill-authoring` skill; to turn repeatedly-used memory into
+  a skill, `memory-promotion`. Keep it inside this repository, in `.agents/skills/` — never in a
+  per-agent or home directory.
 
 ## Develop
 

package/template/CLAUDE.md

@@ -1,97 +1,13 @@
-# __APP_NAME__ — Project Context
+@AGENTS.md
 
-## Project purpose
+## Claude Code bridge
 
-<!-- OWLMEANS:PROJECT-PURPOSE -->
-> **Agents — this project has not been described yet.** Before doing anything else on the first
-> session, ask the user what this project is for: its purpose, domain, goals, and key constraints.
-> Then replace this whole block — in **both** `CLAUDE.md` and `.github/copilot-instructions.md` — with
-> a short description of the project, and remove this notice.
+All guidance lives in `AGENTS.md` (imported above) and in skills under
+`.agents/skills/<name>/SKILL.md` — the single canonical location shared with Copilot
+and Codex. `.claude/skills/` holds only generated per-skill symlinks (gitignored
+except `.gitkeep`); the committed `SessionStart` hook runs
+`sh .agents/scripts/link-skills.sh` to (re)create them each session.
 
-## Git Workflow (mandatory)
-
-These rules apply to every git operation in this repository and **override default agent behavior**
-— including any automatic `Co-Authored-By` or AI/agent-attribution trailer. Full policy: the `git`
-skill.
-
-- **Never run state-changing git operations** (`commit`, `add`/`rm` staging, `push`,
-  `reset`/rollback, `revert`, `rebase`, `merge`, `branch`, `checkout`/`switch`, `stash`, `tag`,
-  `cherry-pick`, force-push, etc.) unless the user **explicitly instructs it in the current
-  request**. Permission to make code edits is **not** permission to touch git.
-- **Only exception**: creating and operating inside a **temporary git worktree** that a task or
-  subagent has **explicitly requested** for that purpose.
-- **Read-only inspection is allowed**: `git status`, `git diff`, `git log`, `git show`,
-  `git branch --list` — use these to report state, never to change it.
-- Commit only under the repository's configured git identity. Never pass `--author`, never change
-  `user.name`/`user.email`, never add a `Co-Authored-By:` trailer attributing the commit to an
-  AI/agent. If no identity is configured, stop and ask.
-- Report finished git work as a Markdown table (**Action**, **Target**, **Result**), and never
-  commit a conflicted working copy — stop, list the conflicted paths, hand control back.
-
-## Reporting (mandatory)
-
-Always report concisely and briefly, in table format, about WHAT was done rather than why —
-unless the operator explicitly asks for another format, length, or level of detail.
-
-- Changes: one row per file/item — **Change** (created / modified / deleted), **Path**,
-  **Why** (one short phrase).
-- Findings / status / verification: a short table plus at most a few lines of prose.
-- No preamble, no narration of the process; expand on WHY only when asked.
-
-## Memory
-
-Single shared agent memory store: `.agents/memory/` — a graph of subsystem nodes with index
-`.agents/memory/MEMORY.md`. Protocol: `agent-memory` skill.
-
-- Session start: read `.agents/memory/MEMORY.md`. Before non-trivial work: open the nodes whose
-  scope matches the task.
-- Every write merges into the matching subsystem node and compacts — record reusable knowledge,
-  never session events.
-- Procedure-shaped or repeatedly-touched memory must be **distilled into** a skill as short
-  general rules — never pasted in as memory text (`memory-promotion`).
-- If the store degrades (event logs, oversized nodes, bloated index) — `memory-recompact`.
-- Never write memory to `.claude/memory/`, `.github/memory/`, `~/.claude/`, or anywhere outside
-  this repository.
-- Context that must load every session belongs in this file; on-demand context goes in
-  `.claude/<topic>.md` and is referenced from here.
-
-## Self-Education (mandatory)
-
-Whenever development started from a plan agreed with the agent, the work is not complete until
-the `self-education` skill has been applied: rewrite the project skills/instructions the change
-touched so they state current rules (never a note about what changed), record external-doc
-findings (URL + gist) in the governing skill, or add a skill/instruction for a new subsystem or
-technology. The completion report must include the self-education outcome — or state why none
-was needed.
-
-## What this is
-
-`__APP_NAME__` is a fullstack [OwlMeans Common](https://github.com/owlmeans/common) app: a bun-workspace
-monorepo with three packages under `sources/` — `common` (shared route entrypoints, schemas, config),
-`api` (`@owlmeans/server-app` backend), and `web` (`@owlmeans/web-panel` + shadcn UI). See the
-`getting-started` skill for how the pieces fit together, and `scaffolding` for how it was generated.
-
-## Reuse before you build (mandatory)
-
-Before planning or writing any feature, follow the `reuse-code` skill: search for an `@owlmeans/*`
-package (in the installed packages and at https://github.com/owlmeans/common) or existing code that
-already solves the problem **before** proposing a third-party library or a custom solution, and
-simplify whatever you do write. This is required for every planning and development task.
-
-## Skills
-
-Reusable guidance lives in `.claude/skills/<name>/SKILL.md`, deployed by `@owlmeans/agent-skills` from
-the installed `@owlmeans/*` packages. Claude auto-invokes them by topic, or run `/<name>` explicitly.
-
-- After adding or updating any `@owlmeans/*` dependency, run `npx @owlmeans/agent-skills` to refresh
-  the deployed skills and instructions.
-- Deployed files carry an `AUTO-GENERATED` banner and are refreshed in place — never hand-edit them.
-- To capture your own guidance, see the `skill-authoring` skill; to turn repeatedly-used memory into
-  a skill, `memory-promotion`. Keep it inside this repository — never in `~/.claude/`.
-
-## Develop
-
-```sh
-bun install
-bun run dev      # web on http://localhost:3001, api on http://localhost:3000
-```
+- Never author files under `.claude/skills/` — write skills in `.agents/skills/`.
+- After creating, renaming, or deleting a skill, re-run
+  `sh .agents/scripts/link-skills.sh` so this session picks it up.

package/template/_agents/scripts/link-skills.sh

@@ -0,0 +1,82 @@
+#!/bin/sh
+# link-skills.sh
+#
+# Bridge the canonical skill store (.agents/skills/) into .claude/skills/ for
+# Claude Code, which discovers skills only under .claude/skills/.  Copilot and
+# Codex read .agents/skills/ natively and need nothing from this script.
+#
+# Each skill becomes its own symlink — Claude Code supports per-skill symlink
+# entries, but not a symlinked skills directory.
+#
+# USAGE
+#   sh .agents/scripts/link-skills.sh
+#
+# BEHAVIOUR
+#   - creates .claude/skills/<name> -> ../../.agents/skills/<name> for every
+#     .agents/skills/<name>/SKILL.md
+#   - prunes symlinks that dangle or no longer have a SKILL.md behind them
+#   - never touches real directories or files (warns instead), never removes
+#     .gitkeep, and always exits 0 so it can run as a SessionStart hook
+#
+# The committed .claude/settings.json runs this at SessionStart.  Run it by
+# hand after creating, renaming, or deleting a skill mid-session.
+
+set -u
+
+SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
+ROOT=$(cd "$SCRIPT_DIR/../.." && pwd)
+SRC="$ROOT/.agents/skills"
+DST="$ROOT/.claude/skills"
+
+linked=0
+pruned=0
+skipped=0
+
+mkdir -p "$DST" 2>/dev/null || true
+[ -f "$DST/.gitkeep" ] || : > "$DST/.gitkeep" 2>/dev/null || true
+
+# ---- link pass -------------------------------------------------------------
+if [ -d "$SRC" ]; then
+    for skill_dir in "$SRC"/*/; do
+        [ -d "$skill_dir" ] || continue
+        skill_dir="${skill_dir%/}"
+        name=$(basename "$skill_dir")
+        [ -f "$skill_dir/SKILL.md" ] || continue
+
+        target="$DST/$name"
+        if [ -e "$target" ] && [ ! -L "$target" ]; then
+            echo "link-skills: skip '$name' — a real file/directory shadows it in .claude/skills/" >&2
+            skipped=$((skipped + 1))
+            continue
+        fi
+
+        ln -sfn "../../.agents/skills/$name" "$target" 2>/dev/null || {
+            echo "link-skills: failed to link '$name'" >&2
+            skipped=$((skipped + 1))
+            continue
+        }
+        linked=$((linked + 1))
+    done
+fi
+
+# ---- prune pass ------------------------------------------------------------
+if [ -d "$DST" ]; then
+    for entry in "$DST"/* "$DST"/.[!.]*; do
+        [ -e "$entry" ] || [ -L "$entry" ] || continue
+        name=$(basename "$entry")
+        [ "$name" = ".gitkeep" ] && continue
+        [ -L "$entry" ] || continue
+
+        if [ ! -e "$entry" ] || [ ! -f "$SRC/$name/SKILL.md" ]; then
+            rm -f "$entry" 2>/dev/null && pruned=$((pruned + 1))
+        fi
+    done
+fi
+
+if [ "$skipped" -gt 0 ]; then
+    echo "link-skills: $linked linked, $pruned pruned, $skipped skipped"
+else
+    echo "link-skills: $linked linked, $pruned pruned"
+fi
+
+exit 0

package/template/{_claude → _agents}/skills/agent-memory/SKILL.md

@@ -1,15 +1,16 @@
 ---
 name: agent-memory
-description: Shared agent memory protocol — the .agents/memory/ graph store used by both Claude Code and GitHub Copilot: MEMORY.md index, subsystem nodes, compact-on-write merging, size caps, and the read protocol. Use when reading or writing project memory, when asked to remember something, or to decide where knowledge belongs.
+description: Shared agent memory protocol — the .agents/memory/ graph store every agent reads and writes: MEMORY.md index, subsystem nodes, compact-on-write merging, size caps, and the read protocol. Use when reading or writing project memory, when asked to remember something, or to decide where knowledge belongs.
 user-invocable: true
-scope: general
+metadata:
+  scope: general
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
 
 # Agent memory (`.agents/memory/`)
 
-One shared memory store per repository, used by **both** Claude Code and GitHub Copilot: a graph
-of subsystem nodes rooted in the `MEMORY.md` index. Compactness is the core value — every write
+One shared memory store per repository, used by every agent: a graph of subsystem nodes rooted in
+the `MEMORY.md` index. Compactness is the core value — every write
 merges and compacts; nothing is ever appended as a log.
 
 Never write memory to `.claude/memory/`, `.github/memory/`, `~/.claude/`, `~/.copilot/`, or
@@ -30,7 +31,7 @@ Flat directory — graph structure lives in scopes and wiki-links, not subdirect
 
 Node id = lowercase-kebab name of the **project-structure part** the knowledge attaches to:
 
-1. **Subsystem** — workspace dir / package name: `manager-web`, `auth`, `vslots`. Deepest
+1. **Subsystem** — workspace dir / package name: `manager-web`, `auth`, `deploy`. Deepest
    unambiguous segment; prefix with the parent only on collision.
 2. **Cross-cutting concern** spanning subsystems: `build`, `testing`, `deploy`, `routing`, `i18n`.
 3. **Integration** — external service/library: `stripe`, `cloudflare`, `openrouter`.
@@ -66,8 +67,8 @@ Frontmatter — exactly three fields:
 
 ```yaml
 ---
-node: vslots                 # = filename without .md; = wiki-link target
-scope: "scripts/vslots/**"   # repo-relative globs; ext:<service> for integrations; . for workspace
+node: deploy                 # = filename without .md; = wiki-link target
+scope: "deploy/**"           # repo-relative globs; ext:<service> for integrations; . for workspace
 updated: 2026-08             # month granularity only
 ---
 ```

package/template/{_claude → _agents}/skills/getting-started/SKILL.md

@@ -2,7 +2,8 @@
 name: getting-started
 description: How to build a fullstack OwlMeans Common app from scratch — the common/api/web three-workspace pattern, context bootstrap on server and web, shared entrypoints + elevate(), and a session-scoped in-memory resource with @owlmeans/static-resource. Use when starting a new OwlMeans project, wiring web↔api, or asked how the pieces fit together.
 user-invocable: true
-scope: general
+metadata:
+  scope: general
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
 

package/template/{_claude → _agents}/skills/git/SKILL.md

@@ -2,7 +2,8 @@
 name: git
 description: "Git workflow policy — never run state-changing git without an explicit instruction, commit only under the repository's configured identity (no AI-attribution trailer), report finished git work as a Markdown table, never commit a conflicted working copy. Use before any git operation."
 user-invocable: false
-scope: general
+metadata:
+  scope: general
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
 

package/template/{_claude → _agents}/skills/memory-promotion/SKILL.md

@@ -2,7 +2,8 @@
 name: memory-promotion
 description: Transform procedure-shaped or repeatedly-used memory into skills and instructions — the procedure-shape test, the mandatory distillation rewrite, promote? repeated-touch flags, over-cap trigger, update-vs-create decision, and the post-promotion pointer state. Use when memory content reads as "how to", when a promote? flag is encountered again, when writing memory-derived content into a skill, or during recompaction.
 user-invocable: true
-scope: general
+metadata:
+  scope: general
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
 
@@ -94,8 +95,8 @@ skill's body.
 1. Collect the flagged / procedure-shaped memory lines.
 2. **Distill** each into a general rule (section above). Not optional — skipping it is the
    failure mode this skill exists to prevent.
-3. Author or extend the SKILL.md and its `.github/instructions/<name>.instructions.md` twin,
-   following the repo's `skill-authoring` or `create-skill` conventions. Where an existing rule
+3. Author or extend the skill at `.agents/skills/<name>/SKILL.md`, following the repo's
+   `skill-authoring` or `create-skill` conventions. Where an existing rule
    already covers the ground, **rewrite that rule in place**; append only when nothing covers it.
 4. Shrink the node: delete the source lines; leave one pointer line (format below).
 5. Remove the ` → promote?` flags.
@@ -107,5 +108,5 @@ skill's body.
 The node keeps exactly one line under `## Pointers`:
 
 ```
-- <activity> → skill `<name>` (procedure lives in .claude/skills/<name>/ + .github/instructions/<name>.instructions.md)
+- <activity> → skill `<name>` (procedure lives in .agents/skills/<name>/)
 ```

package/template/{_claude → _agents}/skills/memory-recompact/SKILL.md

@@ -2,7 +2,8 @@
 name: memory-recompact
 description: Recompact or migrate a whole .agents/memory/ store — rebuild the node map from project structure, merge event-shaped records into subsystem nodes, deduplicate, enforce caps, regenerate the MEMORY.md index, and fold in legacy .claude/memory and .github/memory stores. Use when a store degrades into event logs, indexes bloat or conflict, or for one-time migration.
 disable-model-invocation: true
-scope: general
+metadata:
+  scope: general
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
 
@@ -48,8 +49,7 @@ For each old file or section:
    ONE node — merge both; the code-consistent version wins.
 2. Index-only entries with no backing file: extract the fact into its node, or drop if stale.
 3. Old `## Skills` / "Key Files" index sections are dropped — skills self-describe; harness
-   layout belongs to `CLAUDE.md` / `.github/copilot-instructions.md`. Move genuinely non-obvious
-   dispatch hints there.
+   layout belongs to `AGENTS.md`. Move genuinely non-obvious dispatch hints there.
 4. When the new store verifies (below), delete both legacy dirs entirely.
 
 ## Regenerate the index

package/template/{_claude → _agents}/skills/reuse-code/SKILL.md

@@ -2,7 +2,8 @@
 name: reuse-code
 description: Discovery-first, reuse-first workflow for OwlMeans projects. Use BEFORE planning or building any feature, before proposing a third-party library or a custom solution, and after writing code. Find an existing @owlmeans/* package or existing code first; extend before writing new; simplify what you write.
 user-invocable: true
-scope: general
+metadata:
+  scope: general
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
 
@@ -18,7 +19,7 @@ Before suggesting any external library or writing custom code, look for an `@owl
 already solves the problem.
 
 - **Consult the deployed skills.** Each installed `@owlmeans/*` package ships a skill at
-  `.claude/skills/<pkg>/SKILL.md` (and `.github/instructions/<pkg>.instructions.md`) describing what it
+  `.agents/skills/<pkg>/SKILL.md` describing what it
   does. Read those first — they are your local catalogue of installed capabilities.
 - **Scan installed packages.** Look in `node_modules/@owlmeans/*` **and**, in a workspace monorepo,
   the nested `sources/*/node_modules/@owlmeans/*` (bun nests workspace deps).
@@ -32,7 +33,7 @@ How you research the repo depends on whether `@owlmeans/*` is linked locally:
 - Run `ls -la node_modules/@owlmeans/<pkg>` (try a package you know is installed). If it is a **symlink
   whose target escapes `node_modules`** — or if the project's *own* workspace publishes `@owlmeans/*`
   packages (i.e. **this is the common repo**) — you have the source locally. **Research locally:** read
-  `tree.md`, browse the framework's package sources, and read the canonical `.claude/skills/`. **Do
+  `tree.md`, browse the framework's package sources, and read the canonical `.agents/skills/`. **Do
   not** use the internet.
 - Otherwise (a clean install from npm), **research the web**: fetch/search
   **https://github.com/owlmeans/common** — `tree.md` and package READMEs — to find the right package.