@jskit-ai/agent-docs 0.1.149 → 0.1.151

package/patterns/page-scaffolding.md

@@ -29,7 +29,8 @@ Rules:
   ownership rather than creating a parallel navigation structure.
 - For a small placeholder route inside an existing route family, keep the change scoped unless the durable route or surface plan in the app blueprint changed.
 - Live pages must be usable screens, not instructional scaffolds. Do not ship copy such as "replace this", "use this area", or "this page is ready".
-- Prefer a page header plus a direct `v-sheet` working region. Do not wrap every page in a generic `v-card`.
+- Never add a page header, title block, welcome heading, or standalone heading copy by default. Start with the useful content and actions; add a heading only when the user explicitly asks for one.
+- Prefer a direct `v-sheet` working region when the content needs a surface. Do not wrap every page in a generic `v-card`.
 - If the screen is not implemented yet, use a product-shaped empty state with one clear next action or status, not developer instructions.
 - Primary navigation links belong in semantic placements such as `shell.primary-nav` or `page.section-nav`; do not place every route into one drawer by default.
 - Compact layouts must be checked first: no horizontal overflow, no unreachable primary action, and tap targets should be at least 48 px.
@@ -38,7 +39,7 @@ UI contract:
 
 - App-facing screens are phone-first and task-first; admin/console screens may be denser but still need responsive controls.
 - Navigation uses semantic placements by default. Raw `host:position` outlets are advanced infrastructure.
-- Page architecture is header plus direct work region, normally `v-sheet`; do not use generic page-level `v-card` shells.
+- Page architecture starts with the direct work region and actions, normally using `v-sheet` when a surface is needed; it does not include default page-heading chrome or generic page-level `v-card` shells.
 - Empty/loading/error states are product-shaped and resource-named.
 - Detail and workflow routes are not primary navigation by default.
 - Changed UI must have compact, medium, and expanded browser checks when it changes user-facing behavior.
@@ -46,6 +47,7 @@ UI contract:
 Avoid:
 
 - inventing a page and placement shape without checking the existing pattern and neighboring routes
+- adding a route-name heading, welcome heading, or other page title the user did not request
 - treating a small page stub as permission to rewrite marketing copy, route architecture, or app blueprint scope
-- adding cards inside cards or repeating the page title inside a card title
+- adding cards inside cards
 - treating Vuetify component defaults as the product architecture

package/patterns/shell-foundation/PATTERN.md

@@ -37,6 +37,8 @@ not convert those choices into a generator questionnaire.
 
 - Materialize source inside the existing project without disturbing `.git` or
   any existing project/agent context.
+- Pages start with useful content and actions, never a default page header or
+  standalone heading.
 - Inspect and resolve file collisions; never force-overwrite product source.
 - Keep placements and topology explicit and use shell public components.
 - Keep one app-owned `npm run develop` entry that runs the API on loopback and

package/patterns/shell-foundation/example/AGENTS.md

@@ -1,16 +1,20 @@
 # App Agent Instructions
 
-Use current project context, JSKIT public APIs, and the installed JSKIT pattern
-index as the source of truth for application work.
+Use current project context, JSKIT public APIs, and the official framework
+documentation as the source of truth for application work.
 
-Recommended references:
+Framework references:
 
-- `node_modules/@jskit-ai/agent-docs/guide/agent/index.md`
-- `node_modules/@jskit-ai/agent-docs/patterns/INDEX.md`
+- `https://mobily-enterprises.github.io/jskit-ai/guide/`
+- `https://mobily-enterprises.github.io/jskit-ai/patterns/`
 
-Before database, schema, CRUD, repository, or persistence work, inspect the
-relevant package-owned pattern from
-`node_modules/@jskit-ai/agent-docs/reference/autogen/PATTERN_INDEX.md`.
+Before implementation, read the narrow relevant source pattern completely. If
+its owner package is installed, prefer that version-matched package-owned copy.
+Do not install an unrelated runtime package only to read documentation.
+
+Pages never start with a page header, title block, welcome heading, or other
+standalone heading copy. Start with the useful content and actions. If the user
+wants a heading, they will ask for or add one.
 
 Copied pattern source is ordinary application source. Do not add generator
 provenance, receipts, completion ledgers, or tooling-operation history. Keep

package/patterns/shell-foundation/example/Procfile

@@ -1,2 +1 @@
-release: npm run db:migrate
 web: npm run start

package/patterns/shell-foundation/example/package.json

@@ -34,7 +34,7 @@
   "dependencies": {
     "@local/main": "0.1.0",
     "@fastify/static": "^10.1.3",
-    "@jskit-ai/kernel": "0.1.177",
+    "@jskit-ai/kernel": "0.1.179",
     "@tanstack/vue-query": "^5.101.0",
     "fastify": "^5.8.5",
     "json-rest-schema": "^1.0.17",
@@ -42,14 +42,13 @@
     "vue": "^3.5.38",
     "vue-router": "^5.1.0",
     "vuetify": "^4.1.2",
-    "@jskit-ai/http-runtime": "0.1.175",
+    "@jskit-ai/http-runtime": "0.1.177",
     "@mdi/js": "^7.4.47",
-    "@jskit-ai/shell-web": "0.1.181"
+    "@jskit-ai/shell-web": "0.1.183"
   },
   "devDependencies": {
-    "@jskit-ai/agent-docs": "0.1.149",
-    "@jskit-ai/config-eslint": "0.1.174",
-    "@jskit-ai/jskit-catalog": "0.1.202",
+    "@jskit-ai/config-eslint": "0.1.176",
+    "@jskit-ai/jskit-catalog": "0.1.204",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",

package/patterns/shell-foundation/example/packages/main/package.json

@@ -9,7 +9,7 @@
   },
   "description": "App-local runtime composition and lightweight glue.",
   "dependencies": {
-    "@jskit-ai/kernel": "0.1.177"
+    "@jskit-ai/kernel": "0.1.179"
   },
   "jskit": {
     "kind": "runtime",

package/patterns/shell-foundation/example/src/pages/home/index.vue

@@ -29,16 +29,9 @@ const healthPending = computed(
 
 <template>
   <section class="home-surface-screen d-flex flex-column ga-4">
-    <header class="home-surface-screen__header">
-      <div>
-        <p class="text-overline text-medium-emphasis mb-1">Home</p>
-        <h1 class="home-surface-screen__title">Ready</h1>
-        <p class="text-body-2 text-medium-emphasis mb-0">
-          Core services are available.
-        </p>
-      </div>
+    <div class="home-surface-screen__actions">
       <v-btn color="primary" variant="flat" to="/home/settings/general">Settings</v-btn>
-    </header>
+    </div>
 
     <v-sheet rounded="lg" border class="home-surface-screen__panel">
       <div class="home-surface-screen__status">
@@ -62,23 +55,12 @@ const healthPending = computed(
 
 <style scoped>
 .home-surface-screen {
-  --home-surface-title-size: 2rem;
   --home-surface-panel-padding: 1rem;
 }
 
-.home-surface-screen__header {
-  align-items: flex-start;
+.home-surface-screen__actions {
   display: flex;
-  gap: 1rem;
-  justify-content: space-between;
-}
-
-.home-surface-screen__title {
-  font-size: var(--home-surface-title-size);
-  font-weight: 700;
-  letter-spacing: 0;
-  line-height: 1.1;
-  margin: 0 0 0.4rem;
+  justify-content: flex-end;
 }
 
 .home-surface-screen__panel {
@@ -100,15 +82,7 @@ const healthPending = computed(
 }
 
 @media (max-width: 640px) {
-  .home-surface-screen {
-    --home-surface-title-size: 1.5rem;
-  }
-
-  .home-surface-screen__header {
-    flex-direction: column;
-  }
-
-  .home-surface-screen__header :deep(.v-btn) {
+  .home-surface-screen__actions :deep(.v-btn) {
     min-height: 48px;
     width: 100%;
   }

package/patterns/shell-foundation/example/src/pages/home/settings/general/index.vue

@@ -16,12 +16,9 @@ const drawerDefaultOpenModel = computed({
 
 <template>
   <section class="settings-general-screen d-flex flex-column ga-4">
-    <div>
-      <h2 class="text-h6 mb-2">Navigation</h2>
-      <p class="text-body-2 text-medium-emphasis mb-0">
-        On wider screens, collapsed navigation remains available as a rail. Phone layouts close the drawer and keep primary navigation in the bottom bar.
-      </p>
-    </div>
+    <p class="text-body-2 text-medium-emphasis mb-0">
+      On wider screens, collapsed navigation remains available as a rail. Phone layouts close the drawer and keep primary navigation in the bottom bar.
+    </p>
 
     <v-switch
       v-model="drawerDefaultOpenModel"

package/patterns/shell-foundation/example/src/pages/home/settings.vue

@@ -5,12 +5,6 @@ import { RouterView } from "vue-router";
 
 <template>
   <section class="settings-shell d-flex flex-column ga-4">
-    <header>
-      <p class="text-overline text-medium-emphasis mb-1">Settings</p>
-      <h1 class="settings-shell__title">Home settings</h1>
-      <p class="text-body-2 text-medium-emphasis mb-0">Configure shell behavior for this surface.</p>
-    </header>
-
     <v-sheet rounded="lg" border class="settings-shell__panel">
       <div class="settings-shell__body">
         <nav class="settings-shell__nav" aria-label="Home settings sections">
@@ -29,18 +23,9 @@ import { RouterView } from "vue-router";
 
 <style scoped>
 .settings-shell {
-  --settings-title-size: 1.85rem;
   --settings-panel-padding: 1rem;
 }
 
-.settings-shell__title {
-  font-size: var(--settings-title-size);
-  font-weight: 650;
-  letter-spacing: 0;
-  line-height: 1.15;
-  margin: 0 0 0.35rem;
-}
-
 .settings-shell__panel {
   overflow: hidden;
 }
@@ -81,10 +66,6 @@ import { RouterView } from "vue-router";
 }
 
 @media (max-width: 960px) {
-  .settings-shell {
-    --settings-title-size: 1.35rem;
-  }
-
   .settings-shell__body {
     grid-template-columns: 1fr;
   }

package/patterns/shell-foundation/example/tests/e2e/base-shell.spec.ts

@@ -11,7 +11,7 @@ test.describe("application responsive smoke", () => {
     test(`${viewport.name} home route renders without horizontal overflow`, async ({ page }) => {
       await page.setViewportSize(viewport);
       await page.goto("/home");
-      await expect(page.getByRole("heading", { name: "Ready" })).toBeVisible();
+      await expect(page.getByText("Service health")).toBeVisible();
 
       const dimensions = await page.evaluate(() => ({
         clientWidth: document.documentElement.clientWidth,

package/patterns/ui-contract.md

@@ -12,6 +12,8 @@ and action UI.
 - Compact interactive targets are at least 48 CSS pixels.
 - Navigation uses semantic placements and explicit navigation roles.
 - Pages do not stack decorative cards inside structural cards.
+- Pages do not include a header, title block, welcome heading, or standalone
+  heading copy unless the user explicitly requests one.
 - Shared screens own repeated chrome; app pages own product fields and domain
   sections.
 

package/patterns/ui-testing.md

@@ -53,7 +53,7 @@ import { loginAsExistingUser } from "@jskit-ai/auth-web/test/playwright";
 test("authenticated feature", async ({ page }) => {
   await loginAsExistingUser(page, { email: "ada@example.com" });
   await page.goto("/w/acme/admin/contacts");
-  await expect(page.getByRole("heading", { name: "Contacts" })).toBeVisible();
+  await expect(page.getByRole("button", { name: "Add contact" })).toBeVisible();
 });
 ```
 

package/reference/autogen/PATTERN_INDEX.md

@@ -7,7 +7,7 @@ Patterns are ordinary package-owned Markdown and example files. Read the matchin
 
 Do not create or consult receipts recording that a pattern was used. Current source and verification are the evidence.
 
-Resolve an installed pattern from the project root as `node_modules/<package-id>/<document-path>`. Example files are beside it under the listed example path.
+This documentation artifact contains a version-matched copy of every listed pattern and example. Runtime packages remain separate dependencies and should be installed only when the application selects them.
 
 ## Minimal JSKIT application foundation
 
@@ -15,9 +15,9 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
 
 - Id: `app/minimal-foundation`
 - Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
-- Owner: `@jskit-ai/agent-docs@0.1.149`
-- Read: `node_modules/@jskit-ai/agent-docs/patterns/minimal-foundation/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/agent-docs/patterns/minimal-foundation/example/`
+- Owner: `@jskit-ai/agent-docs@0.1.151`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/app/minimal-foundation/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/app/minimal-foundation/example/)
 - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
 
 ## Adaptive-shell JSKIT application foundation
@@ -26,9 +26,9 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
 
 - Id: `app/shell-foundation`
 - Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
-- Owner: `@jskit-ai/agent-docs@0.1.149`
-- Read: `node_modules/@jskit-ai/agent-docs/patterns/shell-foundation/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/agent-docs/patterns/shell-foundation/example/`
+- Owner: `@jskit-ai/agent-docs@0.1.151`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/app/shell-foundation/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/app/shell-foundation/example/)
 - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`, `@jskit-ai/shell-web`
 
 ## Assistant surface and settings
@@ -37,9 +37,9 @@ Configure an assistant runtime for one application surface and expose its chat a
 
 - Id: `assistant/assistant-surface`
 - Keywords: `ai`, `assistant`, `chat`, `config`, `environment`, `page`, `placement`, `settings`, `surface`
-- Owner: `@jskit-ai/assistant-runtime@0.1.148`
-- Read: `node_modules/@jskit-ai/assistant-runtime/patterns/assistant-surface/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/assistant-runtime/patterns/assistant-surface/example/`
+- Owner: `@jskit-ai/assistant-runtime@0.1.150`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/assistant/assistant-surface/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/assistant/assistant-surface/example/)
 - Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/shell-web`
 
 ## Authentication surface
@@ -48,9 +48,9 @@ Compose JSKIT authentication routes, views, profile controls, and public surface
 
 - Id: `auth/auth-surface`
 - Keywords: `account`, `auth`, `login`, `logout`, `password`, `placement`, `profile`, `reset`, `surface`
-- Owner: `@jskit-ai/auth-web@0.1.177`
-- Read: `node_modules/@jskit-ai/auth-web/patterns/auth-surface/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/auth-web/patterns/auth-surface/example/`
+- Owner: `@jskit-ai/auth-web@0.1.179`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/auth-surface/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/auth/auth-surface/example/)
 - Requires: `@jskit-ai/auth-core`, `@jskit-ai/auth-web`, `@jskit-ai/shell-web`
 
 ## Supabase authentication
@@ -59,9 +59,9 @@ Add Supabase authentication through normal npm composition, explicit environment
 
 - Id: `auth/supabase-auth`
 - Keywords: `auth`, `authentication`, `oauth`, `sessions`, `supabase`
-- Owner: `@jskit-ai/auth-provider-supabase-core@0.1.174`
-- Read: `node_modules/@jskit-ai/auth-provider-supabase-core/patterns/supabase-auth/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/auth-provider-supabase-core/patterns/supabase-auth/example/`
+- Owner: `@jskit-ai/auth-provider-supabase-core@0.1.176`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/auth/supabase-auth/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/auth/supabase-auth/example/)
 - Requires: `@jskit-ai/auth-provider-supabase-core`
 
 ## Owner console surface
@@ -70,9 +70,9 @@ Add a protected administration surface, settings shell, and semantic navigation
 
 - Id: `console/console-surface`
 - Keywords: `admin`, `console`, `navigation`, `owner`, `placement`, `settings`, `surface`
-- Owner: `@jskit-ai/console-web@0.1.145`
-- Read: `node_modules/@jskit-ai/console-web/patterns/console-surface/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/console-web/patterns/console-surface/example/`
+- Owner: `@jskit-ai/console-web@0.1.147`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/console/console-surface/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/console/console-surface/example/)
 - Requires: `@jskit-ai/console-core`, `@jskit-ai/console-web`, `@jskit-ai/shell-web`
 
 ## CRUD list, view, create, and edit screens
@@ -81,9 +81,9 @@ Build a routed CRUD user interface as thin application pages over JSKIT's shared
 
 - Id: `crud/crud-screen-set`
 - Keywords: `actions`, `add`, `crud`, `delete`, `edit`, `filters`, `list`, `material`, `routes`, `view`, `vue`
-- Owner: `@jskit-ai/http-web@0.1.22`
-- Read: `node_modules/@jskit-ai/http-web/patterns/crud-screen-set/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/http-web/patterns/crud-screen-set/example/`
+- Owner: `@jskit-ai/http-web@0.1.24`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/crud-screen-set/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/crud/crud-screen-set/example/)
 - Requires: `@jskit-ai/http-web`, `@jskit-ai/resource-crud-core`
 
 ## JSON API CRUD resource package
@@ -92,9 +92,9 @@ Build a complete application-owned CRUD server package from a migration, resourc
 
 - Id: `crud/json-api-resource-package`
 - Keywords: `actions`, `crud`, `database`, `json-api`, `migration`, `permissions`, `provider`, `repository`, `routes`, `service`
-- Owner: `@jskit-ai/crud-core@0.1.188`
-- Read: `node_modules/@jskit-ai/crud-core/patterns/json-api-resource-package/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/crud-core/patterns/json-api-resource-package/example/`
+- Owner: `@jskit-ai/crud-core@0.1.190`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/json-api-resource-package/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/crud/json-api-resource-package/example/)
 - Requires: `@jskit-ai/crud-core`, `@jskit-ai/resource-crud-core`
 
 ## Owner-scoped CRUD resource contract
@@ -103,9 +103,9 @@ Define an authenticated application resource whose records belong to the current
 
 - Id: `crud/resource-contract`
 - Keywords: `authenticated`, `crud`, `database`, `owner-scoped`, `resource`, `user`
-- Owner: `@jskit-ai/resource-crud-core@0.1.119`
-- Read: `node_modules/@jskit-ai/resource-crud-core/patterns/resource-contract/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/resource-crud-core/patterns/resource-contract/example/`
+- Owner: `@jskit-ai/resource-crud-core@0.1.121`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/crud/resource-contract/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/crud/resource-contract/example/)
 - Requires: `@jskit-ai/resource-crud-core`
 
 ## MySQL application database
@@ -114,9 +114,9 @@ Configure a JSKIT application for MySQL with a fixed driver, ordinary environmen
 
 - Id: `database/mysql-application`
 - Keywords: `database`, `knex`, `mariadb`, `migrations`, `mysql`, `mysql2`
-- Owner: `@jskit-ai/database-runtime-mysql@0.1.175`
-- Read: `node_modules/@jskit-ai/database-runtime-mysql/patterns/mysql-application/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/database-runtime-mysql/patterns/mysql-application/example/`
+- Owner: `@jskit-ai/database-runtime-mysql@0.1.177`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/database/mysql-application/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/database/mysql-application/example/)
 - Requires: `@jskit-ai/database-runtime-mysql`
 
 ## PostgreSQL application database
@@ -125,9 +125,9 @@ Configure a JSKIT application for PostgreSQL with a fixed driver, ordinary envir
 
 - Id: `database/postgres-application`
 - Keywords: `database`, `knex`, `migrations`, `pg`, `postgres`, `postgresql`
-- Owner: `@jskit-ai/database-runtime-postgres@0.1.174`
-- Read: `node_modules/@jskit-ai/database-runtime-postgres/patterns/postgres-application/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/database-runtime-postgres/patterns/postgres-application/example/`
+- Owner: `@jskit-ai/database-runtime-postgres@0.1.176`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/database/postgres-application/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/database/postgres-application/example/)
 - Requires: `@jskit-ai/database-runtime-postgres`
 
 ## Capacitor Android application
@@ -136,9 +136,9 @@ Wrap a JSKIT web application in a Capacitor Android shell using native Capacitor
 
 - Id: `mobile/android-application`
 - Keywords: `android`, `capacitor`, `device`, `mobile`, `native`, `shell`, `webview`
-- Owner: `@jskit-ai/mobile-capacitor@0.1.112`
-- Read: `node_modules/@jskit-ai/mobile-capacitor/patterns/android-application/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/mobile-capacitor/patterns/android-application/example/`
+- Owner: `@jskit-ai/mobile-capacitor@0.1.114`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/mobile/android-application/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/mobile/android-application/example/)
 - Requires: `@capacitor/android`, `@capacitor/app`, `@capacitor/cli`, `@jskit-ai/mobile-capacitor`
 
 ## Realtime application
@@ -147,9 +147,9 @@ Add JSKIT realtime events with an optional Redis backplane and an explicit shell
 
 - Id: `realtime/realtime-application`
 - Keywords: `realtime`, `redis`, `socket.io`, `sockets`, `status`, `websocket`
-- Owner: `@jskit-ai/realtime@0.1.174`
-- Read: `node_modules/@jskit-ai/realtime/patterns/realtime-application/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/realtime/patterns/realtime-application/example/`
+- Owner: `@jskit-ai/realtime@0.1.176`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/realtime/realtime-application/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/realtime/realtime-application/example/)
 - Requires: `@jskit-ai/realtime`, `@jskit-ai/shell-web`
 
 ## App-local server feature package
@@ -158,9 +158,9 @@ Define a server feature through explicit capabilities and first-class actions, a
 
 - Id: `server/feature-package`
 - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
-- Owner: `@jskit-ai/agent-docs@0.1.149`
-- Read: `node_modules/@jskit-ai/agent-docs/patterns/feature-package/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/agent-docs/patterns/feature-package/example/`
+- Owner: `@jskit-ai/agent-docs@0.1.151`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/server/feature-package/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/server/feature-package/example/)
 - Requires: `@jskit-ai/kernel`
 
 ## Responsive application shell
@@ -169,9 +169,9 @@ Compose the JSKIT responsive shell, semantic placements, settings navigation, an
 
 - Id: `shell/application-shell`
 - Keywords: `adaptive`, `app`, `layout`, `navigation`, `placement`, `responsive`, `settings`, `shell`
-- Owner: `@jskit-ai/shell-web@0.1.181`
-- Read: `node_modules/@jskit-ai/shell-web/patterns/application-shell/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/shell-web/patterns/application-shell/example/`
+- Owner: `@jskit-ai/shell-web@0.1.183`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/shell/application-shell/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/shell/application-shell/example/)
 - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
 
 ## Routed page, section navigation, and placed element
@@ -180,9 +180,9 @@ Add product routes and shell extensions through file routing, semantic placement
 
 - Id: `ui/page-and-placement`
 - Keywords: `component`, `navigation`, `outlet`, `page`, `placement`, `routes`, `section`, `shell`, `subpages`, `vue`
-- Owner: `@jskit-ai/shell-web@0.1.181`
-- Read: `node_modules/@jskit-ai/shell-web/patterns/page-and-placement/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/shell-web/patterns/page-and-placement/example/`
+- Owner: `@jskit-ai/shell-web@0.1.183`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/ui/page-and-placement/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/ui/page-and-placement/example/)
 - Requires: `@jskit-ai/kernel`, `@jskit-ai/shell-web`
 
 ## Account settings surface
@@ -191,9 +191,9 @@ Compose an account settings route and profile, preference, and notification sect
 
 - Id: `users/account-settings`
 - Keywords: `account`, `notifications`, `preferences`, `profile`, `settings`, `user`, `vue`
-- Owner: `@jskit-ai/users-web@0.1.195`
-- Read: `node_modules/@jskit-ai/users-web/patterns/account-settings/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/users-web/patterns/account-settings/example/`
+- Owner: `@jskit-ai/users-web@0.1.197`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/users/account-settings/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/users/account-settings/example/)
 - Requires: `@jskit-ai/shell-web`, `@jskit-ai/users-core`, `@jskit-ai/users-web`
 
 ## User administration server package
@@ -202,9 +202,9 @@ Expose user administration and workspace-scoped member operations through app-ow
 
 - Id: `users/user-administration-server`
 - Keywords: `account`, `admin`, `member`, `repository`, `resource`, `routes`, `service`, `user`, `workspace`
-- Owner: `@jskit-ai/users-core@0.1.190`
-- Read: `node_modules/@jskit-ai/users-core/patterns/user-administration-server/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/users-core/patterns/user-administration-server/example/`
+- Owner: `@jskit-ai/users-core@0.1.192`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/users/user-administration-server/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/users/user-administration-server/example/)
 - Requires: `@jskit-ai/crud-core`, `@jskit-ai/users-core`
 
 ## Workspace tenancy server composition
@@ -213,9 +213,9 @@ Configure roles, workspace access policy, invitations, and app-owned invitation
 
 - Id: `workspaces/workspace-server`
 - Keywords: `access`, `invite`, `membership`, `multitenancy`, `policy`, `role`, `tenancy`, `workspace`
-- Owner: `@jskit-ai/workspaces-core@0.1.155`
-- Read: `node_modules/@jskit-ai/workspaces-core/patterns/workspace-server/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/workspaces-core/patterns/workspace-server/example/`
+- Owner: `@jskit-ai/workspaces-core@0.1.157`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/workspaces/workspace-server/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/workspaces/workspace-server/example/)
 - Requires: `@jskit-ai/users-core`, `@jskit-ai/workspaces-core`
 
 ## Workspace application and administration surfaces
@@ -224,7 +224,7 @@ Compose workspace selection, invitation, member administration, settings, and re
 
 - Id: `workspaces/workspace-surfaces`
 - Keywords: `admin`, `invite`, `member`, `navigation`, `settings`, `surface`, `switcher`, `workspace`
-- Owner: `@jskit-ai/workspaces-web@0.1.156`
-- Read: `node_modules/@jskit-ai/workspaces-web/patterns/workspace-surfaces/PATTERN.md`
-- Examples: `node_modules/@jskit-ai/workspaces-web/patterns/workspace-surfaces/example/`
+- Owner: `@jskit-ai/workspaces-web@0.1.158`
+- Read: [PATTERN.md](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/PATTERN.md)
+- Examples: [example/](../../skills/jskit/references/patterns/workspaces/workspace-surfaces/example/)
 - Requires: `@jskit-ai/shell-web`, `@jskit-ai/workspaces-core`, `@jskit-ai/workspaces-web`

package/skills/jskit/SKILL.md

@@ -11,11 +11,14 @@ belongs to the application immediately.
 
 ## Pattern-first implementation
 
-Search [the generated source pattern index](references/pattern-index.md)
-for the requested outcome before reading broad operational guidance or
-inventing a local structure. Read a selected package's `PATTERN.md` completely,
-then use its example directly, adapt it, compose compatible patterns, or treat
-it as evidence for a different implementation through the same public APIs.
+Search [the bundled source pattern index](references/pattern-index.md) for the
+requested outcome before reading broad operational guidance or inventing a
+local structure. It contains every indexed `PATTERN.md` and complete example
+tree; do not install a runtime package merely to read them. Read the selected
+pattern completely, then use its example directly, adapt it, compose compatible
+patterns, or treat it as evidence for a different implementation through the
+same public APIs. If its owner runtime package is already installed at a
+different version, prefer that package's version-matched pattern.
 
 Do not write or consult receipts, provenance, completion ledgers, or other
 durable bookkeeping for pattern or authoring-tool runs. Current source,

package/skills/jskit/references/app-operations.md

@@ -1,6 +1,8 @@
+<!-- Generated from `packages/agent-docs/site/guide/framework/application-operations.md` by `npm run agent-docs:build`. -->
+
 # Application operations
 
-Read this for establishing an application foundation, selecting package
+Use this for establishing an application foundation, selecting package
 capabilities, and realizing product features from JSKIT patterns.
 
 ## Establish a new application
@@ -10,11 +12,10 @@ request, current source, and ordinary project documentation. Ask the user for
 any material missing product decision before writing application source. Do
 not run a JSKIT questionnaire and do not create a temporary scaffold app.
 
-Read the generated pattern index:
-
-```text
-node_modules/@jskit-ai/agent-docs/reference/autogen/PATTERN_INDEX.md
-```
+Read the [bundled source pattern index](pattern-index.md). When the optional standalone
+JSKIT Agent Skill is installed, its pattern index contains the same
+version-matched pattern documents and examples. Do not install a runtime
+package only to read its documentation.
 
 For a browser product, inspect one foundation:
 
@@ -74,11 +75,11 @@ mark a resource valid because a generator once wrote it.
 
 ## Verify current state
 
-Run verification against source, package graph, migrations, and
-runtime behavior. Runtime startup owns the capability/provider graph,
-loadability, ids, environment, and configuration. Builds own client imports;
-migration status and disposable rebuilds own schema state. App lint, tests,
-audit, browser checks, and CI own security, runtimes, and behavior.
+Run verification against source, package graph, migrations, and runtime
+behavior. Runtime startup owns the capability/provider graph, loadability,
+ids, environment, and configuration. Builds own client imports; migration
+status and disposable rebuilds own schema state. App lint, tests, audit,
+browser checks, and CI own security, runtimes, and behavior.
 
 There is no supported `jskit doctor` command. Old CLI authoring-history
 warnings do not describe AI-first apps. Diagnose current contracts; never add

package/skills/jskit/references/crud-operations.md

@@ -1,3 +1,5 @@
+<!-- Generated from `packages/agent-docs/site/guide/framework/crud-operations.md` by `npm run agent-docs:build`. -->
+
 # CRUD operations
 
 Read this before database, schema, CRUD, repository, or persistence work.
@@ -5,12 +7,12 @@ Read this before database, schema, CRUD, repository, or persistence work.
 ## Establish the product contract
 
 Take database, surface, access, ownership, operations, and fields from product
-intent and current source. Ask when a material choice is missing. Do not translate the work into generator options.
+intent and current source. Ask when a material choice is missing. Do not
+translate the work into generator options.
 
-Read the narrow package-owned pattern from the generated index:
-`crud/resource-contract` for the resource, `crud/json-api-resource-package` for
-the server, and `crud/crud-screen-set` for routed UI. Child-resource and
-row-policy patterns own those variations.
+Read the narrow package-owned pattern in the [bundled source pattern index](pattern-index.md): `crud/resource-contract` for the resource,
+`crud/json-api-resource-package` for the server, and `crud/crud-screen-set`
+for routed UI. Child-resource and row-policy patterns own those variations.
 
 Normal CRUD tables use one non-null integer primary key. Foreign keys are
 single-column; composite unique indexes are business constraints, not
@@ -65,7 +67,9 @@ Honor `temporalPrecision`; repositories return strict strings.
 
 ## Migration ownership
 
-Migrations are immutable application source owned with their resource. Never make a live table or a generator the sole source of truth. Schema inspection is for adoption and diagnosis, not compulsory authoring.
+Migrations are immutable application source owned with their resource. Never
+make a live table or a generator the sole source of truth. Schema inspection
+is for adoption and diagnosis, not compulsory authoring.
 
 Before sign-off, rebuild from zero in a fresh disposable database, compare the
 schema, test ownership boundaries and failure cases, and run current-state