@owlmeans/create-app 0.1.18-rc.35 → 0.1.18-rc.37

package/README.md

@@ -9,7 +9,7 @@ bun create @owlmeans/app my-app
 # or
 yarn create @owlmeans/app my-app
 # or
-npx @owlmeans/create-app@^0.1.18-rc.35 my-app
+npx @owlmeans/create-app@^0.1.18-rc.37 my-app
 ```
 
 ## What it generates

package/build/args.js

@@ -5,7 +5,7 @@ Usage:
   npm create @owlmeans/app@latest <dir> [options]
   bun create @owlmeans/app <dir> [options]
   yarn create @owlmeans/app <dir> [options]
-  npx @owlmeans/create-app@^0.1.18-rc.35 <dir> [options]
+  npx @owlmeans/create-app@^0.1.18-rc.37 <dir> [options]
 
 Generates three workspaces (common + api + web) with shadcn UI navigation and
 layout, no authentication, and a session-scoped in-memory resource on the
@@ -147,3 +147,4 @@ export const parseArgs = (argv) => {
 export const printHelp = () => {
     process.stdout.write(HELP);
 };
+//# sourceMappingURL=args.js.map

package/build/bin.js

@@ -18,3 +18,4 @@ else {
         process.exit(1);
     });
 }
+//# sourceMappingURL=bin.js.map

package/build/index.js

@@ -3,3 +3,4 @@ export { parseArgs, printHelp } from './args.js';
 export { scaffold } from './scaffold.js';
 export { copyTemplate, templateDir, isEmptyDir } from './template.js';
 export { DEFAULT_LANG, defaultDescription, isValidLang, isValidSlug, LANG_PATTERN, SLUG_PATTERN, slugify, titleize } from './naming.js';
+//# sourceMappingURL=index.js.map

package/build/naming.js

@@ -15,3 +15,4 @@ export const slugify = (input) => basename(input)
     || 'owlmeans-app';
 export const titleize = (slug) => slug.split('-').filter(Boolean).map(w => w[0].toUpperCase() + w.slice(1)).join(' ');
 export const defaultDescription = (name) => `${name} — a fullstack OwlMeans Common app.`;
+//# sourceMappingURL=naming.js.map

package/build/run.js

@@ -50,7 +50,7 @@ export const run = async (args) => {
         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@^0.1.18-rc.27` after installing to add the package-specific ones)…');
+                + '\n`npx @owlmeans/agent-skills@^0.1.18-rc.29` after installing to add the package-specific ones)…');
         try {
             const result = await installSkills({
                 dir: dest,
@@ -62,7 +62,7 @@ export const run = async (args) => {
                 help: false,
             });
             if (result.code !== 0) {
-                process.stderr.write(`  agent-skills exited with code ${result.code} — you can re-run \`npx @owlmeans/agent-skills@^0.1.18-rc.27\` later.\n`);
+                process.stderr.write(`  agent-skills exited with code ${result.code} — you can re-run \`npx @owlmeans/agent-skills@^0.1.18-rc.29\` later.\n`);
             }
         }
         catch (err) {
@@ -87,3 +87,4 @@ export const run = async (args) => {
     log('project is for and fill in its purpose for you.\n');
     return 0;
 };
+//# sourceMappingURL=run.js.map

package/build/scaffold.js

@@ -15,3 +15,4 @@ export const scaffold = (opts) => {
         description: opts.description ?? defaultDescription(name),
     }, { bare: opts.bare === true });
 };
+//# sourceMappingURL=scaffold.js.map

package/build/template.js

@@ -94,3 +94,4 @@ export const isEmptyDir = (dir) => {
     return readdirSync(dir).length === 0;
 };
 export { renameSync };
+//# sourceMappingURL=template.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/create-app",
-  "version": "0.1.18-rc.35",
+  "version": "0.1.18-rc.37",
   "license": "MIT",
   "description": "Scaffold a fullstack OwlMeans Common app — common + api + web workspaces, shadcn UI navigation/layout, no auth, and a session-scoped in-memory resource, or --bare for the demo-free shell. Also usable programmatically via scaffold(). Deploys agent skills via @owlmeans/agent-skills by default.",
   "type": "module",
@@ -30,7 +30,7 @@
     "template"
   ],
   "dependencies": {
-    "@owlmeans/agent-skills": "^0.1.18-rc.27"
+    "@owlmeans/agent-skills": "^0.1.18-rc.29"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",

package/template/AGENTS.md

@@ -94,7 +94,7 @@ from the installed `@owlmeans/*` packages. Agents load a skill by topic, or you
 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@^0.1.18-rc.27` to refresh
+- After adding or updating any `@owlmeans/*` dependency, run `npx @owlmeans/agent-skills@^0.1.18-rc.29` to refresh
   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 the `skill-authoring` skill; to turn repeatedly-used memory into

package/template/README.bare.md

@@ -53,5 +53,5 @@ them; write your own guidance as separate, un-bannered files. Refresh after addi
 `@owlmeans/*` packages:
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.27
+npx @owlmeans/agent-skills@^0.1.18-rc.29
 ```

package/template/_agents/skills/memory-recompact/SKILL.md

@@ -49,8 +49,8 @@ For each old file or section:
 1. Union every source. Two same-named files are two drifted sources of 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. `## Skills` / "Key Files" index sections are dropped — skills self-describe; harness layout
-   belongs to `AGENTS.md`. Move genuinely non-obvious dispatch hints there.
+3. `## Skills` / "Key Files" index sections are dropped — skills self-describe; harness layout belongs to `AGENTS.md`; a genuinely non-obvious dispatch hint goes into the
+   owning skill's `description:`, never into `AGENTS.md`.
 4. When the new store verifies (below), delete every merged source entirely.
 
 ## Regenerate the index

package/template/_agents/skills/reuse-code/SKILL.md

@@ -47,7 +47,7 @@ How you research the repo depends on whether `@owlmeans/*` is linked locally:
   **https://github.com/owlmeans/common** — `tree.md` and package READMEs — to find the right package.
 
 This is the same dev-linked detection `@owlmeans/agent-skills` uses (see its `detectLinked`). After
-adding an `@owlmeans/*` dependency, run `npx @owlmeans/agent-skills@^0.1.18-rc.27` to deploy its
+adding an `@owlmeans/*` dependency, run `npx @owlmeans/agent-skills@^0.1.18-rc.29` to deploy its
 skill. Prefer an `@owlmeans/*` package over a third-party library or bespoke code whenever one fits.
 
 ### Never add an OwlMeans dependency without an explicit range
@@ -57,7 +57,7 @@ other `@owlmeans/*` packages:
 
 ```json
 "dependencies": {
-  "@owlmeans/queue": "^0.1.18-rc.22"
+  "@owlmeans/queue": "^0.1.18-rc.23"
 }
 ```
 

package/template/_agents/skills/self-education/SKILL.md

@@ -32,6 +32,9 @@ For each area the work touched:
 2. Do its commands, paths, APIs, and behavior claims still hold after the change?
 3. Fix in place — rewrite the affected lines so they describe current behavior; never append a
    note about what this change did.
+4. Never record what the work taught in `AGENTS.md`: the rule goes to the governing skill, the
+   incident to `.agents/memory/`. `AGENTS.md` gains at most a new skill's one index line or a new
+   repo-wide mandatory rule in one line (`create-skill` → What may enter AGENTS.md).
 
 ## Shape of an update
 
@@ -87,6 +90,9 @@ memory-vs-skill boundary (`agent-memory` / `memory-promotion`).
 
 ## Completion gate
 
+Before reporting, run `sh .agents/scripts/agents-size.sh`; if `AGENTS.md` is over budget, move
+lines out to their skills first.
+
 The completion report must contain a Self-education table:
 
 | Item | Action | Path |

package/template/_agents/skills/skill-authoring/SKILL.md

@@ -26,8 +26,8 @@ imports one.
 **Rule or skill?** A rule is policy that has to hold whether or not anyone thought to load
 anything — the git workflow is the standing example, whether a repo keeps it as
 `.agents/rules/git.md` or inline in `AGENTS.md`. A skill is guidance for a task, loaded when that
-task comes up. If it only matters while you are doing X, write a skill; if breaking it is wrong at
-any moment, put it where `AGENTS.md` loads it every session.
+task comes up. If it only matters while you are doing X, write a skill; if breaking it is wrong at any moment, state it in a line or two where `AGENTS.md` loads it every
+session, and keep its detail in a skill (§ What may enter AGENTS.md).
 
 `.agents/skills/` is the [Agent Skills](https://agentskills.io) standard location: GitHub Copilot
 and Codex discover it natively. Claude Code reads skills only from `.claude/skills/`, so each skill
@@ -63,6 +63,14 @@ that package's own guidance completely, and the installer reports the file as a
 run. Give a skill about your own use of `@owlmeans/payment` a name of its own — `billing`, or your
 product's name with a suffix — never `payment`.
 
+**Never name a skill after a Claude Code built-in slash command.** Claude Code resolves `/<name>` to
+a skill before the built-in command of the same name, so a skill called `context`, `config`,
+`memory` or `review` makes that command unreachable wherever the skill is installed or linked, and
+nothing reports it. The same holds for a command's aliases (`/settings` is `/config`, `/cost` is
+`/usage`) and for the skills Claude Code bundles (`/loop`, `/simplify`); type `/` in a Claude Code
+session to see every taken name. OwlMeans package skills follow this too: the guidance for
+`@owlmeans/context` and `@owlmeans/config` ships as `owlmeans-context` and `owlmeans-config`.
+
 The `description` is the most important field: every agent uses it to decide when to load the
 skill, so state both the topic and the trigger ("Use when …"). Keep it under 1024 characters —
 Copilot rejects longer ones. It is YAML, so a value containing `: ` (colon-space) has to be quoted
@@ -122,10 +130,26 @@ Never paste memory text into a skill. Memory content enters guidance only as a r
 rule — trigger, step, and the failure it prevents, with dates, phase/status markers, versions and
 incident narrative stripped (`memory-promotion` → Distillation).
 
+## What may enter AGENTS.md
+
+`AGENTS.md` — with every file it `@`-imports and `.agents/memory/MEMORY.md` — is loaded in full in
+every session, so it has a budget: **≤ 40 000 chars**, checked by `sh .agents/scripts/agents-size.sh`
+from the repo root where the repo carries it. A line enters it only as:
+
+1. a mandatory rule that must hold before any skill is loaded (git, reporting, environments,
+   naming) — stated in one or two lines, with the detail in a skill;
+2. one line of the package map or the command list;
+3. one line of the skills index: `` - `/name` — when to load it ``, ≤ 160 chars.
+
+Everything else is loaded on demand: a subsystem's rules, contracts and failure fingerprints go to
+the skill that governs it, and the outage that taught them to `.agents/memory/`. Never paraphrase a
+skill's `description:` into the index — skills self-describe. A change that would push the file over
+budget shortens or moves an existing line in the same change.
+
 ## After adding a skill
 
 1. If it replaces an ad-hoc `.agents/<topic>.md`, remove that file.
 2. If it distilled memory content into rules, shrink the source `.agents/memory/` node to a
    pointer line (`memory-promotion`) — the memory index does not list skills.
-3. Reference it from `AGENTS.md` if it should be discoverable every session.
+3. Add one line to the skills index in `AGENTS.md` (`/name` — when to load it, ≤ 160 chars) — never a paragraph (§ What may enter AGENTS.md).
 4. Run `sh .agents/scripts/link-skills.sh`.

package/template/sources/api/package.json

@@ -11,8 +11,8 @@
     "typecheck": "tsc -b"
   },
   "dependencies": {
-    "@owlmeans/server-app": "^0.1.18-rc.32",
-    "@owlmeans/static-resource": "^0.1.18-rc.24",
+    "@owlmeans/server-app": "^0.1.18-rc.33",
+    "@owlmeans/static-resource": "^0.1.18-rc.25",
     "__APP_SLUG__-common": "workspace:^"
   },
   "devDependencies": {

package/template/sources/common/package.json

@@ -19,11 +19,11 @@
     "typecheck": "tsc -b"
   },
   "dependencies": {
-    "@owlmeans/config": "^0.1.18-rc.28",
-    "@owlmeans/entrypoint": "^0.1.18-rc.27",
-    "@owlmeans/error": "^0.1.18-rc.26",
-    "@owlmeans/resource": "^0.1.18-rc.26",
-    "@owlmeans/route": "^0.1.18-rc.25",
+    "@owlmeans/config": "^0.1.18-rc.29",
+    "@owlmeans/entrypoint": "^0.1.18-rc.28",
+    "@owlmeans/error": "^0.1.18-rc.27",
+    "@owlmeans/resource": "^0.1.18-rc.27",
+    "@owlmeans/route": "^0.1.18-rc.26",
     "ajv": "^8.17.1"
   },
   "devDependencies": {

package/template/sources/web/package.json

@@ -11,16 +11,16 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@owlmeans/client": "^0.1.18-rc.31",
-    "@owlmeans/client-config": "^0.1.18-rc.28",
-    "@owlmeans/client-context": "^0.1.18-rc.29",
-    "@owlmeans/client-entrypoint": "^0.1.18-rc.28",
-    "@owlmeans/client-i18n": "^0.1.18-rc.30",
-    "@owlmeans/entrypoint": "^0.1.18-rc.27",
-    "@owlmeans/route": "^0.1.18-rc.25",
-    "@owlmeans/state": "^0.1.18-rc.25",
-    "@owlmeans/web-client": "^0.1.18-rc.40",
-    "@owlmeans/web-panel": "^0.1.18-rc.49",
+    "@owlmeans/client": "^0.1.18-rc.32",
+    "@owlmeans/client-config": "^0.1.18-rc.29",
+    "@owlmeans/client-context": "^0.1.18-rc.30",
+    "@owlmeans/client-entrypoint": "^0.1.18-rc.29",
+    "@owlmeans/client-i18n": "^0.1.18-rc.31",
+    "@owlmeans/entrypoint": "^0.1.18-rc.28",
+    "@owlmeans/route": "^0.1.18-rc.26",
+    "@owlmeans/state": "^0.1.18-rc.26",
+    "@owlmeans/web-client": "^0.1.18-rc.41",
+    "@owlmeans/web-panel": "^0.1.18-rc.50",
     "@radix-ui/react-label": "^2.1.0",
     "@radix-ui/react-navigation-menu": "^1.2.14",
     "@radix-ui/react-progress": "^1.1.0",