@owlmeans/create-app 0.1.13 → 0.1.15

package/README.md

@@ -18,6 +18,9 @@ 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)
 ├── sources/
 │   ├── common/   # shared entrypoints (routes), schemas and types
 │   ├── api/      # @owlmeans/server-app backend; session data in an in-memory static resource
@@ -32,6 +35,13 @@ By default the scaffolder also installs dependencies and **deploys agent guidanc
 into the project via [`@owlmeans/agent-skills`](https://www.npmjs.com/package/@owlmeans/agent-skills)
 (`.claude/skills/` + `.github/instructions/`).
 
+`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`.
+
 ## Options
 
 | Flag | Description |

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,CA2E1D,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,CA8E1D,CAAA"}

package/build/run.js

@@ -41,31 +41,32 @@ export const run = async (args) => {
         }
     }
     if (args.skills) {
-        if (!args.install) {
-            log('\nSkipping agent-skills deploy (requires installed dependencies — re-run with install).');
-        }
-        else {
-            log('\nDeploying agent skills via @owlmeans/agent-skills…');
-            try {
-                const result = await installSkills({
-                    dir: dest,
-                    yes: true,
-                    only: [],
-                    claudeOnly: false,
-                    copilotOnly: false,
-                    extras: true,
-                    force: false,
-                    dryRun: false,
-                    help: false,
-                });
-                if (result.code !== 0) {
-                    process.stderr.write(`  agent-skills exited with code ${result.code} — you can re-run \`npx @owlmeans/agent-skills\` later.\n`);
-                }
-            }
-            catch (err) {
-                process.stderr.write(`  agent-skills failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        // Without an install the target has no node_modules/@owlmeans, so discovery falls back
+        // to the installer's own bundled agent-meta/ — the general harness guidance (memory,
+        // self-education, git, skill authoring) still lands; only package-specific skills wait.
+        log(args.install
+            ? '\nDeploying agent skills via @owlmeans/agent-skills…'
+            : '\nDeploying harness guidance via @owlmeans/agent-skills (general skills only — re-run'
+                + '\n`npx @owlmeans/agent-skills` after installing to add the package-specific ones)…');
+        try {
+            const result = await installSkills({
+                dir: dest,
+                yes: true,
+                only: [],
+                claudeOnly: false,
+                copilotOnly: false,
+                extras: true,
+                force: false,
+                dryRun: false,
+                help: false,
+            });
+            if (result.code !== 0) {
+                process.stderr.write(`  agent-skills exited with code ${result.code} — you can re-run \`npx @owlmeans/agent-skills\` later.\n`);
             }
         }
+        catch (err) {
+            process.stderr.write(`  agent-skills failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
     }
     const runCmd = args.pm === 'npm' ? 'npm run dev' : `${args.pm} run dev`;
     const installCmd = args.pm === 'yarn' ? 'yarn' : `${args.pm} install`;
@@ -76,7 +77,8 @@ 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 and .github/copilot-instructions.md.');
+    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');
     return 0;

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;AAgBvH,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;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"}

package/build/template.js

@@ -7,6 +7,9 @@ const DOTFILE_RENAMES = {
     '_npmrc': '.npmrc',
     '_env': '.env',
     '_github': '.github',
+    '_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":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAElD,uGAAuG;AACvG,MAAM,eAAe,GAA2B;IAC9C,YAAY,EAAE,YAAY;IAC1B,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,MAAM;IACd,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,SAAS;CACrB,CAAA;AAED,yEAAyE;AACzE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;AASjG,gFAAgF;AAChF,MAAM,CAAC,MAAM,WAAW,GAAG,GAAW,EAAE,CACtC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAA;AAEpE,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAE,CAAuB,EAAU,EAAE,CAC7E,OAAO;KACJ,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC;KAClC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;AAEvC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAW,EAAE;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IACjC,OAAO,GAAG,IAAI,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;AAClE,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,IAAY,EAAE,CAAuB,EAAQ,EAAE;IACvF,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACpC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAC7B,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,KAAK,CAAA;QAClD,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;QAEjC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACjC,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;YACzB,SAAQ;QACV,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;YAChB,SAAQ;QACV,CAAC;QAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;QAChE,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IAC5B,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAW,EAAE;IACjD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IACjC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAA;AACtC,CAAC,CAAA;AAED,OAAO,EAAE,UAAU,EAAE,CAAA"}
+{"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.13",
+  "version": "0.1.15",
   "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,13 +29,13 @@
     "template"
   ],
   "dependencies": {
-    "@owlmeans/agent-skills": "^0.1.12"
+    "@owlmeans/agent-skills": "^0.1.15"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
-    "@types/node": "^24.10.1",
-    "nodemon": "^3.1.11",
-    "typescript": "^6.0.2"
+    "@types/node": "^26.1.0",
+    "nodemon": "^3.1.14",
+    "typescript": "^6.0.3"
   },
   "publishConfig": {
     "access": "public"

package/template/CLAUDE.md

@@ -8,12 +8,68 @@
 > 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.
 
+## 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.
+`getting-started` skill for how the pieces fit together, and `scaffolding` for how it was generated.
 
 ## Reuse before you build (mandatory)
 
@@ -22,24 +78,6 @@ package (in the installed packages and at https://github.com/owlmeans/common) or
 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.
 
-## Memory & Meta-file Rules
-
-All project memory and meta-information lives **inside this project**, never in `~/.claude/`:
-
-- **Always** write new memory files to `.claude/memory/` in this project root.
-- **Always** update `.claude/memory/MEMORY.md` when adding a memory file.
-- **Never** write project memory to `~/.claude/`.
-- Context that should load every session goes in `CLAUDE.md`; on-demand context goes in
-  `.claude/<topic>.md` and is referenced from here.
-- When asked to remember something about this project, save it to `.claude/memory/<topic>.md` and
-  update the index. See the `agent-memory` skill.
-
-### When to read memory
-
-- **At the start of every session**: read `.claude/memory/MEMORY.md`, then any relevant file.
-- **Before a non-trivial task**: read the relevant memory or `.claude/<topic>.md` first.
-- **After completing a task** that produced new knowledge: save it to memory.
-
 ## Skills
 
 Reusable guidance lives in `.claude/skills/<name>/SKILL.md`, deployed by `@owlmeans/agent-skills` from
@@ -47,7 +85,9 @@ the installed `@owlmeans/*` packages. Claude auto-invokes them by topic, or run
 
 - After adding or updating any `@owlmeans/*` dependency, run `npx @owlmeans/agent-skills` to refresh
   the deployed skills and instructions.
-- To capture your own guidance, see the `skill-authoring` skill.
+- 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
 

package/template/README.md

@@ -46,10 +46,19 @@ for a full walkthrough and the manual (non-scaffolded) version of this project.
 
 ## Agent guidance
 
-This project ships agent context in `CLAUDE.md` and `.github/copilot-instructions.md` (memory + skill
-directives, plus a project-purpose placeholder the agent fills in on its first session), and Claude
-Code skills (`.claude/skills/`) + GitHub Copilot instructions (`.github/instructions/`) for the
-OwlMeans framework. Refresh the skills after adding or upgrading `@owlmeans/*` packages:
+This project ships agent context in `CLAUDE.md` and `.github/copilot-instructions.md`. Both carry the
+same four mandatory sections a real OwlMeans monorepo uses — **Git Workflow**, **Reporting**,
+**Memory**, **Self-Education** — plus a project-purpose placeholder the agent fills in on its first
+session.
+
+Project memory is a single shared graph store at `.agents/memory/` (index `MEMORY.md`), used by both
+Claude Code and Copilot — never write memory anywhere else.
+
+Reusable guidance lives in `.claude/skills/` (Claude Code) and `.github/instructions/` (Copilot).
+Files carrying an `AUTO-GENERATED` banner are managed by
+[`@owlmeans/agent-skills`](https://www.npmjs.com/package/@owlmeans/agent-skills) — don't hand-edit
+them; write your own guidance as separate, un-bannered files. Refresh after adding or upgrading
+`@owlmeans/*` packages:
 
 ```sh
 npx @owlmeans/agent-skills

package/template/_agents/memory/MEMORY.md

@@ -0,0 +1,17 @@
+# Memory Graph — __APP_NAME__
+
+Shared agent memory (`agent-memory` protocol). Read this file at session start.
+Before non-trivial work, open every node whose scope matches the task's files or topics.
+
+No nodes yet. On the first durable finding, create `.agents/memory/<node>.md` and add exactly one
+line here under the matching group: `- [[<node>]] ` + backticked scope + ` — <hook>` (hook ≤ 100
+chars, no dates). Delete this notice and any group still empty once real nodes exist; add an
+`## Integrations` group when an external service earns a node.
+
+## Subsystems
+
+_(none yet — nodes named for `sources/common`, `sources/api`, `sources/web` land here)_
+
+## Cross-cutting
+
+_(none yet — `build`, `testing`, `deploy`, `routing`, `i18n`, `workspace` land here)_

package/template/_claude/skills/agent-memory/SKILL.md

@@ -0,0 +1,142 @@
+---
+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.
+user-invocable: true
+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
+merges and compacts; nothing is ever appended as a log.
+
+Never write memory to `.claude/memory/`, `.github/memory/`, `~/.claude/`, `~/.copilot/`, or
+anywhere outside the repository. Legacy `.claude/memory/` / `.github/memory/` stores are
+retired — if one exists, flag it for `memory-recompact` migration instead of writing there.
+
+## Store layout
+
+```
+.agents/memory/
+├── MEMORY.md     # graph root: the only always-read file
+└── <node>.md     # one file per subsystem / concern / integration
+```
+
+Flat directory — graph structure lives in scopes and wiki-links, not subdirectories.
+
+## Node naming
+
+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
+   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`.
+4. **`workspace`** — repo-level facts that fit nowhere else (remotes, branch topology, env model).
+
+File is `<node>.md`; the id is the wiki-link target: `[[manager-web]]`. **Never** key a node to an
+event, date, phase, investigation, or task name.
+
+## Index format (`MEMORY.md`)
+
+```markdown
+# Memory Graph — <project>
+
+Shared agent memory (`agent-memory` protocol). Read this file at session start.
+Before non-trivial work, open every node whose scope matches the task's files or topics.
+
+## Subsystems
+- [[manager-web]] `sources/manager-web/**` — i18n 8-domain split; owl-theme wiring
+## Cross-cutting
+- [[build]] `**/tsconfig*.json` — tsbuildinfo path pinning; tolerant library builds
+## Integrations
+- [[stripe]] `ext:stripe` — sandbox topology; webhook fan-out
+```
+
+Rules: exactly one line per node — `- [[<node>]] ` + backticked scope + ` — <hook>`; hook ≤ 100
+chars; no dates; only non-empty groups; file ≤ 50 lines; no skills listed (skills self-describe).
+The scope column is the router: match the task's paths/topics against scopes to decide which
+nodes to open.
+
+## Node format
+
+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
+updated: 2026-08             # month granularity only
+---
+```
+
+Body — only non-empty sections, in this order:
+
+- `## Facts` — what IS: structure, behavior, topology. 1–3 lines each.
+- `## Invariants` — what MUST HOLD; optionally "broke when violated: <symptom>".
+- `## Gotchas` — symptom → cause → counter-move, ≤ 3 lines each.
+- `## Pointers` — key files, promoted-skill pointer lines, `External docs` (URL + gist).
+- `## Status` — optional; in-flight state only; every line dated; prune resolved lines on every read.
+
+`Status` is the **only** place dates and unfinished-work notes are allowed. Link related nodes
+inline with `[[node]]`.
+
+## Read protocol
+
+- **Session start**: read `.agents/memory/MEMORY.md` — the index only.
+- **Before a non-trivial task**: open every node whose scope matches the task (typically 1–3).
+- **When a topic surfaces mid-session** that the index names: open its node before acting.
+- **Never bulk-read** the store — the index + scopes exist so you don't have to.
+
+## Write protocol (compact-on-write)
+
+Every write is a merge, never an append:
+
+1. **Extract** — reduce the outcome to reusable knowledge atoms (rule below). Nothing survives →
+   write nothing.
+2. **Locate** — match scopes to find the node; none matches → create one per the naming rule and
+   add its index line.
+3. **Merge / supersede** — place each atom in the right section; if it refines or contradicts an
+   existing line, **rewrite that line in place** — never append a dated correction. The node
+   always reads as current truth.
+4. **Compact** — reread the node; collapse redundancy; delete anything the code or git history
+   now states; prune resolved `Status` lines.
+5. **Cap** — over soft cap: compact harder. Over hard cap: split by sub-scope into a linked child
+   node, or promote procedure-shaped overflow (`memory-promotion` where present, else
+   `skill-authoring`).
+6. **Index** — update the hook line if the node's center of gravity moved; bump `updated:`.
+
+## Knowledge, not events
+
+**Record the rule, not the story.** For every line ask: *what must a future agent know to act
+correctly, stated without reference to this session?* Keep invariants, cause→effect,
+counter-moves, recognition fingerprints (symptoms). Drop dates, phase numbers, who did what,
+attempt sequences, and anything recoverable from code or git.
+
+Before (event log): "Verification 2026-06-11 … Bug found: script missing embedded-count logic.
+Fix deployed to all copies; second run idempotent."
+After (knowledge): "`nested-agent-context.sh` exists as byte-identical copies in the archive and
+each repo — fan every fix out to all copies; verify with `diff`. Correct re-runs are no-ops."
+
+## Size caps (hard)
+
+| Thing | Cap |
+|---|---|
+| Index entry | 1 line, hook ≤ 100 chars |
+| `MEMORY.md` | ≤ 50 lines |
+| Node file (soft / hard) | 80 / 120 lines |
+| Single fact/gotcha | ≤ 3 lines |
+| `Status` section | ≤ 5 dated lines |
+| Nodes per store (soft) | ~25 — merge low-traffic siblings beyond |
+
+## Memory vs skill
+
+Fact-shaped ("what is true") stays here. Procedure-shaped ("to do X, do Y") becomes a skill —
+follow `memory-promotion` where present, otherwise `skill-authoring`. Repeated use of a node to
+*perform* tasks, and over-cap nodes full of steps, are promotion triggers.
+
+Promotion is a **rewrite, never a move**: never paste node text into a skill. "Record the rule,
+not the story" and the size caps above bind skill bodies at least as tightly as they bind nodes
+(`memory-promotion` → Distillation).

package/template/_claude/skills/getting-started/SKILL.md

@@ -0,0 +1,104 @@
+---
+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
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# Getting started with OwlMeans Common — fullstack app shape
+
+A minimal OwlMeans app is a **bun-workspace monorepo with three packages**:
+
+```
+sources/
+├── common/   # shared entrypoints (routes), AJV schemas, types, config — the single source of truth
+├── api/      # @owlmeans/server-app backend; handlers attached to the shared entrypoints
+└── web/      # @owlmeans/web-panel + shadcn UI; screens attached to the same entrypoints
+```
+
+The full, runnable walkthrough (scaffolded **and** manual) lives in
+[`docs/getting-started.md`](../../../docs/getting-started.md). To generate this exact project, use
+[[scaffolding]] (`npm create @owlmeans/app`). This skill is the mental model.
+
+## The core idea: one contract, two sides
+
+Declare each route once in `common` as an **entrypoint**, then `elevate()` it on each side:
+
+```ts
+// common/modules.ts — declaration + validation, no implementation
+export const sessionModules = [
+  entrypoint(route(session.base, '/session')),
+  entrypoint(route(session.list, '/:sid/items', { parent: session.base, method: RouteMethod.GET }),
+    filter(params<SessionParams>(SessionParamsSchema))),
+  entrypoint(route(session.add, '/:sid/items', { parent: session.base, method: RouteMethod.POST }),
+    filter(params<SessionParams>(SessionParamsSchema, body<AddItemPayload>(AddItemSchema)))),
+]
+```
+
+```ts
+// api/modules.ts — attach handlers
+elevate(sessionModules, session.list, handlers.list)
+export const appModules = [...modules, ...sessionModules]        // `modules` = framework defaults
+```
+
+```ts
+// web/modules.ts — attach screen components, plus call-only elevation for backend routes
+elevate(modules, session.list)                                    // callable from the client
+modules.push(entrypoint(route(web.session, '/session', frontend({ parent: BASE })), handler(SessionScreen)))
+```
+
+Change a route or schema in `common` and both sides stay in sync. See [[entrypoint]], [[route]],
+[[server-app]], [[web-client]], [[web-panel]].
+
+## Shared config (where services live)
+
+`common/config.ts` registers both services so the web knows where the API is. `base: 'api'`
+prefixes API routes with `/api`:
+
+```ts
+const cfg = service({ type: AppType.Frontend, service: APP_WEB, host: 'localhost', port: 3001 })
+service({ type: AppType.Backend, service: APP_API, host: 'localhost', port: 3000, base: 'api' }, cfg)
+cfg.debug = { all: true }
+export const commonConfig = cfg
+```
+
+api: `config(APP_API, commonConfig)` (+ `cfg.port`). web: `config(APP_WEB, commonConfig)`. See [[config]].
+
+## Backend bootstrap + in-memory data
+
+```ts
+// api/context.ts
+const context = makeContext(cfg, true)          // from @owlmeans/server-app
+appendStaticResource(context, SESSION_ITEMS)    // @owlmeans/static-resource — in-memory, no DB
+```
+
+Handlers use `handleRequest` / `handleBody` / `handleParams` (validated payload, then context, then
+req). Read/write `ctx.getStaticResource<T>(alias)` — full CRUD (`get/load/list/create/save/delete`).
+**`static-resource.list()` takes no criteria** — list all and filter in JS (e.g. by `sessionId`).
+`main(context, appModules)` starts the server. See [[static-resource]], [[server-app]], [[resource]].
+
+Swap `@owlmeans/static-resource` for [[mongo-resource]] / [[redis-resource]] when you need
+persistence — the handler shape is identical.
+
+## Web bootstrap (shadcn)
+
+`@owlmeans/web-panel`'s `PanelApp` is shadcn/Tailwind v4 (no MUI). The **app provides** the shadcn
+primitives at the `@` alias — `web-panel` references `@/lib/utils` and
+`@/components/ui/{alert,button,card,input,label,progress}`; copy those into `src/`. Render with
+`provide` from `@owlmeans/web-client`:
+
+```tsx
+basicRender(<PanelApp context={context} provide={provide} />)
+```
+
+`vite.config.ts` sets `@`→`src`, `@tailwindcss/vite`, and dedupes the owlmeans/react singletons.
+`index.css` is `@import "tailwindcss";` + a shadcn `@theme` token block (replaces `@owlmeans/owl-theme`).
+A parent `BASE` route renders the layout via `handler(LayoutComponent)`; `HOME` is its default child.
+Screens call the backend with `context.entrypoint(alias).call({ params, body })` → `[data, outcome]`.
+See [[web-panel]], [[web-client]], [[shadcn-web]], [[client-entrypoint]].
+
+## Authentication
+
+This shape is intentionally **auth-free**. To add it: `@owlmeans/server-auth` + `@owlmeans/client-auth`
+and `guard(...)` on entrypoints. See [[auth-protocol]], [[server-auth]], [[client-auth]].

package/template/_claude/skills/git/SKILL.md

@@ -0,0 +1,53 @@
+---
+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
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# Git Workflow Rules
+
+**Mandatory and universal.** These rules apply to every git operation in this repository and
+**override any default agent behavior** — including any automatic `Co-Authored-By` or
+AI/agent-attribution trailer. Consult them before running any git command.
+
+## 0. Never run state-changing git without explicit instruction
+
+- **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. Outside such an explicitly
+  requested tmp worktree, do nothing with git.
+- **Read-only inspection is allowed**: `git status`, `git diff`, `git log`, `git show`,
+  `git branch --list`, etc. — use these to report state, never to change it.
+
+## 1. Never commit under the agent's identity
+
+- Commit only under the repository's preconfigured git identity — whatever `git config user.name`
+  and `git config user.email` resolve to (set by the user, globally or locally).
+- **Never** override authorship: do not pass `--author`, do not set or change `user.name` /
+  `user.email`, and never substitute an AI / agent / assistant name or email.
+- **Never** add a `Co-Authored-By:` trailer (or any other trailer) attributing the commit to
+  Claude, Copilot, or any AI/agent. Every commit is the user's, attributed solely to the user.
+- If the repository has no git identity configured (neither local nor global), stop and ask the
+  user — do not invent one.
+
+## 2. Always report finished git work as a table
+
+- After completing any git action (commit, push, branch, checkout, merge, rebase, stash, tag,
+  reset, etc.), summarize what was done as a Markdown table.
+- One row per action. Include at least **Action**, **Target** (branch / remote / files / ref),
+  and **Result** (commit SHA, `pushed`, `up to date`, `conflict`, …). Add a **Notes** column
+  when useful.
+
+## 3. Never commit a conflicted working copy
+
+- If a `merge`, `rebase`, `cherry-pick`, `stash pop`/`apply`, or `pull` produces conflicts,
+  **do not** finalize it: do not run `git commit`, `git merge --continue`,
+  `git rebase --continue`, or stage-and-commit the conflicted tree to "resolve" it on the
+  user's behalf.
+- Stop, list the conflicted paths in the report table, and hand control back to the user —
+  unless the user has explicitly told you how to resolve the conflict and commit.