@synap-core/workspace-templates 0.12.0 → 0.23.0

package/packs/hr-pack.json

@@ -0,0 +1,54 @@
+{
+  "_meta": {
+    "slug": "hr-pack",
+    "icon": "users",
+    "color": "#F59E0B",
+    "tags": ["hr", "team", "employees", "departments"],
+    "requiredTier": null,
+    "isPublic": true
+  },
+  "profiles": [
+    {
+      "slug": "team-member",
+      "displayName": "Team Member",
+      "icon": "user",
+      "color": "#F59E0B",
+      "description": "Team members and employees",
+      "scope": "workspace",
+      "parentProfileSlug": "person",
+      "properties": [
+        { "slug": "role", "valueType": "string", "required": true, "label": "Role / Title" },
+        { "slug": "department", "valueType": "string", "label": "Department" },
+        { "slug": "start-date", "valueType": "date", "label": "Start Date" },
+        { "slug": "location", "valueType": "string", "label": "Location" },
+        { "slug": "skills", "valueType": "array", "label": "Skills" },
+        { "slug": "status", "valueType": "string", "label": "Status", "inputType": "select", "enumValues": ["active", "on-leave", "offboarded"] }
+      ]
+    },
+    {
+      "slug": "department",
+      "displayName": "Department",
+      "icon": "building-2",
+      "color": "#6366F1",
+      "description": "Organizational departments and teams",
+      "scope": "workspace",
+      "properties": [
+        { "slug": "head", "valueType": "string", "label": "Department Head" },
+        { "slug": "headcount", "valueType": "number", "label": "Headcount", "constraints": { "min": 0 } },
+        { "slug": "budget", "valueType": "number", "label": "Annual Budget", "constraints": { "min": 0 } },
+        { "slug": "description", "valueType": "string", "label": "Description", "inputType": "textarea" }
+      ]
+    }
+  ],
+  "views": [
+    {
+      "name": "Team",
+      "type": "table",
+      "scopeProfileSlug": "team-member",
+      "config": {}
+    }
+  ],
+  "entityLinks": [
+    { "sourceProfileSlug": "team-member", "targetProfileSlug": "department", "type": "belongs_to", "label": "In department" }
+  ]
+}

package/packs/invoice-profile.json

@@ -0,0 +1,28 @@
+{
+  "_meta": {
+    "slug": "invoice-profile",
+    "icon": "receipt",
+    "color": "#10B981",
+    "tags": ["invoice", "billing", "finance"],
+    "requiredTier": null,
+    "isPublic": true
+  },
+  "profiles": [
+    {
+      "slug": "invoice",
+      "displayName": "Invoice",
+      "icon": "receipt",
+      "color": "#10B981",
+      "description": "Invoice with line items and payment tracking",
+      "scope": "workspace",
+      "properties": [
+        { "slug": "invoice-number", "valueType": "string", "required": true, "label": "Invoice Number" },
+        { "slug": "amount", "valueType": "number", "required": true, "label": "Amount", "constraints": { "min": 0 } },
+        { "slug": "currency", "valueType": "string", "label": "Currency", "placeholder": "USD" },
+        { "slug": "status", "valueType": "string", "label": "Status", "inputType": "select", "enumValues": ["draft", "sent", "paid", "overdue", "cancelled"] },
+        { "slug": "due-date", "valueType": "date", "label": "Due Date" },
+        { "slug": "issued-date", "valueType": "date", "label": "Issued Date" }
+      ]
+    }
+  ]
+}

package/packs/knowledge-base-pack.json

@@ -0,0 +1,56 @@
+{
+  "_meta": {
+    "slug": "knowledge-base-pack",
+    "icon": "book-open",
+    "color": "#06B6D4",
+    "tags": ["knowledge", "articles", "documentation", "resources"],
+    "requiredTier": null,
+    "isPublic": true
+  },
+  "profiles": [
+    {
+      "slug": "article",
+      "displayName": "Article",
+      "icon": "newspaper",
+      "color": "#8B5CF6",
+      "description": "Knowledge base articles and documentation",
+      "scope": "workspace",
+      "parentProfileSlug": "bookmark",
+      "properties": [
+        { "slug": "author", "valueType": "string", "label": "Author" },
+        { "slug": "published-at", "valueType": "date", "label": "Published" },
+        { "slug": "category", "valueType": "string", "label": "Category" },
+        { "slug": "tags", "valueType": "array", "label": "Tags" },
+        { "slug": "read-time", "valueType": "number", "label": "Read Time (min)", "constraints": { "min": 0 } }
+      ]
+    },
+    {
+      "slug": "resource",
+      "displayName": "Resource",
+      "icon": "link",
+      "color": "#10B981",
+      "description": "External links, tools, and references",
+      "scope": "workspace",
+      "properties": [
+        { "slug": "url", "valueType": "string", "required": true, "label": "URL", "inputType": "url" },
+        { "slug": "category", "valueType": "string", "label": "Category" },
+        { "slug": "rating", "valueType": "number", "label": "Rating", "constraints": { "min": 0, "max": 5 } },
+        { "slug": "notes", "valueType": "string", "label": "Notes", "inputType": "textarea" }
+      ]
+    }
+  ],
+  "views": [
+    {
+      "name": "Articles",
+      "type": "grid",
+      "scopeProfileSlug": "article",
+      "config": {}
+    },
+    {
+      "name": "Resources",
+      "type": "list",
+      "scopeProfileSlug": "resource",
+      "config": {}
+    }
+  ]
+}

package/packs/meeting-profile.json

@@ -0,0 +1,29 @@
+{
+  "_meta": {
+    "slug": "meeting-profile",
+    "icon": "video",
+    "color": "#8B5CF6",
+    "tags": ["meeting", "calendar", "scheduling"],
+    "requiredTier": null,
+    "isPublic": true
+  },
+  "profiles": [
+    {
+      "slug": "meeting",
+      "displayName": "Meeting",
+      "icon": "video",
+      "color": "#8B5CF6",
+      "description": "Meeting with attendees, agenda, and notes",
+      "scope": "workspace",
+      "properties": [
+        { "slug": "title", "valueType": "string", "required": true, "label": "Title" },
+        { "slug": "start-date", "valueType": "date", "required": true, "label": "Start Time" },
+        { "slug": "end-date", "valueType": "date", "label": "End Time" },
+        { "slug": "location", "valueType": "string", "label": "Location / Link" },
+        { "slug": "attendees", "valueType": "array", "label": "Attendees" },
+        { "slug": "agenda", "valueType": "string", "label": "Agenda", "inputType": "textarea" },
+        { "slug": "notes", "valueType": "string", "label": "Meeting Notes", "inputType": "textarea" }
+      ]
+    }
+  ]
+}

package/packs/product-profile.json

@@ -0,0 +1,30 @@
+{
+  "_meta": {
+    "slug": "product-profile",
+    "icon": "package",
+    "color": "#6366F1",
+    "tags": ["product", "inventory", "ecommerce"],
+    "requiredTier": null,
+    "isPublic": true
+  },
+  "profiles": [
+    {
+      "slug": "product",
+      "displayName": "Product",
+      "icon": "package",
+      "color": "#6366F1",
+      "description": "Product with pricing, SKU, and inventory",
+      "scope": "workspace",
+      "properties": [
+        { "slug": "name", "valueType": "string", "required": true, "label": "Product Name" },
+        { "slug": "sku", "valueType": "string", "label": "SKU" },
+        { "slug": "price", "valueType": "number", "label": "Price", "constraints": { "min": 0 } },
+        { "slug": "currency", "valueType": "string", "label": "Currency", "placeholder": "USD" },
+        { "slug": "category", "valueType": "string", "label": "Category" },
+        { "slug": "status", "valueType": "string", "label": "Status", "inputType": "select", "enumValues": ["draft", "active", "discontinued"] },
+        { "slug": "description", "valueType": "string", "label": "Description", "inputType": "textarea" },
+        { "slug": "image", "valueType": "string", "label": "Image URL" }
+      ]
+    }
+  ]
+}

package/packs/project-management-pack.json

@@ -0,0 +1,49 @@
+{
+  "_meta": {
+    "slug": "project-management-pack",
+    "icon": "kanban-square",
+    "color": "#8B5CF6",
+    "tags": ["projects", "tasks", "milestones", "team"],
+    "requiredTier": null,
+    "isPublic": true
+  },
+  "profiles": [
+    {
+      "slug": "task",
+      "displayName": "Task",
+      "icon": "check-square",
+      "color": "#3B82F6",
+      "description": "Work items and action items",
+      "scope": "workspace",
+      "properties": [
+        { "slug": "status", "valueType": "string", "required": true, "label": "Status", "inputType": "select", "enumValues": ["todo", "in-progress", "review", "done", "cancelled"] },
+        { "slug": "priority", "valueType": "string", "label": "Priority", "inputType": "select", "enumValues": ["low", "medium", "high", "urgent"] },
+        { "slug": "due-date", "valueType": "date", "label": "Due Date" },
+        { "slug": "assignee", "valueType": "string", "label": "Assignee" },
+        { "slug": "estimate", "valueType": "number", "label": "Estimate (hours)", "constraints": { "min": 0 } },
+        { "slug": "tags", "valueType": "array", "label": "Labels" }
+      ]
+    },
+    {
+      "slug": "milestone",
+      "displayName": "Milestone",
+      "icon": "flag",
+      "color": "#F59E0B",
+      "description": "Key deliverables and checkpoints",
+      "scope": "workspace",
+      "properties": [
+        { "slug": "due-date", "valueType": "date", "required": true, "label": "Target Date" },
+        { "slug": "status", "valueType": "string", "label": "Status", "inputType": "select", "enumValues": ["upcoming", "in-progress", "completed", "missed"] },
+        { "slug": "description", "valueType": "string", "label": "Description", "inputType": "textarea" }
+      ]
+    }
+  ],
+  "views": [
+    {
+      "name": "Task Board",
+      "type": "kanban",
+      "scopeProfileSlug": "task",
+      "config": { "groupByField": "status" }
+    }
+  ]
+}

package/packs/recipe-profile.json

@@ -0,0 +1,29 @@
+{
+  "_meta": {
+    "slug": "recipe-profile",
+    "icon": "chef-hat",
+    "color": "#F59E0B",
+    "tags": ["recipe", "cooking", "food"],
+    "requiredTier": null,
+    "isPublic": true
+  },
+  "profiles": [
+    {
+      "slug": "recipe",
+      "displayName": "Recipe",
+      "icon": "chef-hat",
+      "color": "#F59E0B",
+      "description": "Recipe with ingredients, steps, and nutrition",
+      "scope": "workspace",
+      "properties": [
+        { "slug": "title", "valueType": "string", "required": true, "label": "Recipe Name" },
+        { "slug": "cuisine", "valueType": "string", "label": "Cuisine" },
+        { "slug": "prep-time", "valueType": "number", "label": "Prep Time (min)", "constraints": { "min": 0 } },
+        { "slug": "cook-time", "valueType": "number", "label": "Cook Time (min)", "constraints": { "min": 0 } },
+        { "slug": "servings", "valueType": "number", "label": "Servings", "constraints": { "min": 1 } },
+        { "slug": "ingredients", "valueType": "array", "label": "Ingredients" },
+        { "slug": "tags", "valueType": "array", "label": "Tags" }
+      ]
+    }
+  ]
+}

package/packs/task-views-pack.json

@@ -0,0 +1,39 @@
+{
+  "_meta": {
+    "slug": "task-views-pack",
+    "displayName": "Task Views",
+    "icon": "layout-grid",
+    "color": "#3B82F6",
+    "tags": ["tasks", "kanban", "views", "productivity"],
+    "requiredTier": null,
+    "isPublic": true
+  },
+  "description": "Four ready-made task views: a Kanban board by status, a priority matrix, a due-date calendar and a table of all tasks.",
+  "profiles": [],
+  "views": [
+    {
+      "name": "Task Board",
+      "type": "kanban",
+      "scopeProfileSlug": "task",
+      "config": { "groupByField": "status" }
+    },
+    {
+      "name": "Priority Matrix",
+      "type": "matrix",
+      "scopeProfileSlug": "task",
+      "config": { "xField": "priority", "yField": "status" }
+    },
+    {
+      "name": "Task Calendar",
+      "type": "calendar",
+      "scopeProfileSlug": "task",
+      "config": { "dateField": "dueDate" }
+    },
+    {
+      "name": "All Tasks",
+      "type": "table",
+      "scopeProfileSlug": "task",
+      "config": {}
+    }
+  ]
+}

package/retired.yaml

@@ -0,0 +1,136 @@
+# Retired templates: the tombstone registry (schema: schema/retired.ts).
+#
+# A template that leaves the catalog stays KNOWN here. `synap catalog publish`
+# sends each entry to the control plane (POST /api/packages/retire) after the
+# live publishes, so a pod can tell "retired, replaced by X" from "never heard
+# of it" and offer the person a safe move to X. Removing an entry does NOT
+# un-retire the row on the CP.
+#
+#   slug        the retired slug
+#   kind        workspace (default) · capability · skill · pack · automation
+#   replacedBy  a LIVE catalog slug of the same kind, or absent when nothing replaces it
+#   reason      one plain sentence a person reads
+#   since       the date it left the catalog (YYYY-MM-DD)
+#
+# Validation (`synap catalog validate`): replacedBy is live and not retired; no
+# slug is both live and retired in the same category; reasons are not empty.
+# The evidence behind each entry is in pod file 00c1b2fe-ef98-41fa-86cf-801dfab12cd1 ("Template lifecycle: decisions wave + lane catalog").
+
+apiVersion: synap/v1
+retired:
+  # c64ec2fe: "ecosystem (absorbs radar+content-os per ratified merge)". Every
+  # radar kind (competitor, market-segment, trend, inspiration) is declared by ecosystem.
+  - slug: radar
+    kind: workspace
+    replacedBy: ecosystem
+    reason: Radar was merged into Ecosystem, which tracks competitors, market segments, trends and inspiration in one place.
+    since: "2026-07-16"
+
+  # 2026-07-22 (b12efb1b). Second Brain (life-os) declares every kind Personal
+  # held (note, bookmark, article; projects are the pod's own).
+  - slug: personal
+    kind: workspace
+    replacedBy: life-os
+    reason: Personal was replaced by Second Brain, which keeps your notes, bookmarks and articles together.
+    since: "2026-07-22"
+
+  # R7 2026-09-27 (src/builder-dev-fold.template.test.ts): the four views worth
+  # keeping were rebuilt over Builder's own kinds (slug builder-workspace, shown as "Dev"). credential, vendor, repository,
+  # service and environment were NOT ported.
+  - slug: dev-dashboard
+    kind: workspace
+    replacedBy: builder-workspace
+    reason: Dev Dashboard was folded into the Dev space, where its service health, deploy and cost views now live.
+    since: "2026-09-27"
+
+  # R7 2026-09-27: retired as a template, its `agent` kind deliberately not
+  # ported anywhere. Not a system space (only pod-admin carries a system_slug).
+  - slug: agent-fleet
+    kind: workspace
+    reason: Agent Fleet is no longer offered; your agents belong to the pod itself, not to a space.
+    since: "2026-09-27"
+
+  # eaf49166: it declared no profiles, only tools, skills and vault. It lives on
+  # as the capability `posthog-analytics` (capabilities/), a different category.
+  - slug: posthog-analytics
+    kind: workspace
+    reason: PostHog Analytics is now a capability you connect, not a space.
+    since: "2026-10-06"
+
+  # relay-app's private template (relay-app/src/lib/workspace-templates/relay.ts).
+  # Never in the catalog, but pods hold it. person and company move to CRM;
+  # event and task are pod-wide; campaign and contact have no home in CRM.
+  - slug: relay
+    kind: workspace
+    replacedBy: crm
+    reason: Relay was replaced by CRM, which keeps the people and companies you track.
+    since: "2026-10-11"
+
+  # relay-app's private template (relay-app/src/lib/workspace-templates/pkm.ts).
+  # life-os.yaml says it was consolidated from the CP pkm-template; it declares
+  # note, bookmark and highlight.
+  - slug: pkm
+    kind: workspace
+    replacedBy: life-os
+    reason: Knowledge was replaced by Second Brain, which keeps your notes, bookmarks and highlights.
+    since: "2026-10-11"
+
+  # Founder decision 2026-10-12 (pod file 00c1b2fe-ef98-41fa-86cf-801dfab12cd1, decisions wave item 1).
+  # Its lead/client fields, the campaign kind and "Qualify a lead" folded into
+  # crm.yaml; "Advance a commercial proposal" was dropped for CRM's "Win a
+  # deal"; the Synap-fee + commission model moved to the private arch-sales.yaml,
+  # itself retired the same day (below).
+  - slug: business-developer
+    kind: workspace
+    replacedBy: crm
+    reason: Business Developer was folded into CRM, which now qualifies your leads and runs your campaigns.
+    since: "2026-10-12"
+
+  # Founder decision 2026-10-12: The Arch (project + pod) is no longer in use.
+  # Both were private. Their sources are kept, never loaded, in retired-sources/.
+  # Existing pods keep their spaces and data; nothing offers them again.
+  - slug: arch-sales
+    kind: workspace
+    reason: Arch Sales was The Arch's own business-developer commission model, and that project is no longer in use.
+    since: "2026-10-12"
+
+  - slug: the-arch
+    kind: workspace
+    reason: The Arch was a private suite for a project that is no longer in use.
+    since: "2026-10-12"
+
+  # 2026-10-15, "Any link → data": every pod reads a
+  # public link itself (the builtin web read verb in Synap Core), so this pack
+  # and its capture_public_url twin are no longer offered. Nothing replaces it:
+  # nothing needs installing.
+  - slug: web.read
+    kind: capability
+    reason: Reading a public link is built into every pod.
+    since: "2026-10-15"
+
+  # Founder decision 2026-10-23: one space per domain. For a founder-led company
+  # outreach is part of the commercial job, so the CRM absorbs it: the
+  # `outreach-touch` kind (same slug and lifecycle keys), `sent_to` / `part_of`,
+  # the two views, "Personalized Outreach" and the LinkedIn ingest live in
+  # crm.yaml. `outreach-campaign` folded into CRM's `campaign` (campaign-type
+  # outreach); "Send an outreach message" became "Read the reply to an outreach
+  # message" (the agent drafts, a person sends). No pod had it installed.
+  - slug: outreach-comms
+    kind: workspace
+    replacedBy: crm
+    reason: Outreach & Comms was folded into CRM, which now keeps your outreach campaigns and the messages drafted for you to send.
+    since: "2026-10-23"
+
+  # Static edit loop W5 (build plan ab3e0a5a §4, founder D0-D1, 2 Nov 2026).
+  # Superseded since 2026-10-06: Content OS re-declared its three video kinds
+  # (content-composition, content-asset, render-job) verbatim, their views and
+  # pipeline links; brand-library folded its production-recipe into
+  # brand-template. The edit loop (edit-loop skill, video-toolbox routing)
+  # replaced its render pipeline. The founder's pod holds no Content Studio
+  # space (2026-11-03); a pod that does keeps it as it is (the resolver
+  # refuses a new install and leaves an installed space alone).
+  - slug: content-studio
+    kind: workspace
+    replacedBy: content-os
+    reason: Content Studio was folded into Content OS, which now keeps your videos, carousels and other visual posts with the rest of your content.
+    since: "2026-11-03"

package/skills/app-factory-build-slice/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: app-factory-build-slice
+description: Build one slice of a new app from its approved design boards — scope by board files, data read server-side only through the person's sign-in, governed writes, the Website Factory gates, an independent re-run of every gate by the orchestrator, and a stop for the person's first look after slice 1. Use in the Build stage of "Build an app (App Factory)", or when handing an approved design to a coding agent.
+metadata:
+  synap_native: true
+  auto_load: false
+---
+
+# App Factory: build a slice
+
+A slice is a set of approved boards built pixel for pixel, gate-green, in a pull request. It never starts before the
+person approved the design, and never starts while a gap it depends on is open without a labelled bridge. Content
+Studio's slice S1 (Home + idea bank, read-only, real data) is the reference.
+
+## 1. Write the slice brief (in the app repo, e.g. `BUILD-S1.md`)
+
+The builder reads it fully, then `AGENTS.md`, `.claude/skills/build-site/SKILL.md`, the plan document (sections it
+names) and the boards. The brief says:
+
+- **Scope, by boards.** Each route with the board files it must match (desktop 1280, phone 390, every state board).
+  Shell items outside the slice link to ONE "coming next" page drawn with the kit's `StatePanel`, never a dead link.
+- **Rules computed on the server**, written once (e.g. Home's one line: open interview with unanswered questions →
+  owed asks → pending proposals → the most overdue item). The counts that must agree across pages come from one
+  function.
+- **Not in this slice**, explicitly (writes, sign-in, the pages of later slices).
+- **Data.** The read set per page (route, `workspaceId` always passed, what it returns), the request budget per page
+  against the key's rate limit, cache per request only (no shared cache across people). A failed read renders the
+  error state with retry, never an empty list.
+- **Sign-in, never a key.** The app is a pod-app site (`create-site --path pod-app`): the person signs in to their pod
+  and the server reads through `@synap-core/sdk/connect` (`createPodAppAuth`); follow the kit's AGENTS.md. Never an app
+  key; the session secret stays server-only, never in client code, never `NEXT_PUBLIC_*`, never logged or committed.
+  Not connected → the kit's "not connected" state. What a pod app can see and do (spaces, roles, pod-wide records,
+  writes): `node_modules/@synap-core/sdk/AGENTS.md`, section "What a pod app can see and do". It wins over anything
+  here. If something the app needs is not supported yet, that is a recorded gap with an owner — never edit
+  `synap-check.mjs` to pass.
+- **Writes are governed.** A write from a pod app is a proposal in a granted space (`proposed` is success: link the
+  review, label it in the UI "Proposed · in your pod", never retry it); a person connection applies directly.
+- **Look.** `design-kit/tokens.css` decisions copied into `app/brand.css` (shadcn token names), fonts self-hosted
+  (`next/font/local` or `@fontsource*`, never Google at build time), sizes = shadcn base-nova plus only the sizes the
+  design decisions added (as cva variants). Private app: `app/robots.ts` disallows all, pages carry `noindex`, and any
+  cookie (e.g. the sidebar's `sidebar_state`) is named on the privacy page.
+
+## 2. Gates (the builder runs them, quotes them, fixes until green)
+
+- `pnpm verify` green (typecheck, lint, arc / extensions / synap / registry checks, build, smoke).
+- `pnpm shots` and READ the PNGs and `.shots/REPORT.md` at 375 / 768 / 1280 (and dark, if designed): zero serious or
+  critical axe issues; compare each page with its board and list every remaining difference.
+- Credential grep: the key's variable name appears only in server files
+  (`grep -rn "<KEY_VAR>" app components lib`).
+- Mutation grep (read-only slices): no write call anywhere
+  (`grep -rnE 'method: ?"(POST|PATCH|PUT|DELETE)"|\.create\(|\.update\(|\.transition\(' app components lib` is empty).
+- Small commits on a branch `s<N>-<slug>`, pushed, a pull request to main. Never push to main, never deploy
+  production; a preview deploy only when `VERCEL_TOKEN` is set (if not, say so and skip).
+
+## 3. Independent verification (the orchestrator, not the builder)
+
+Never accept "done" from the builder's report. On the devbox (heavy gates never on the Mac; take the gate lock):
+check out the PR head, run `pnpm verify` and the two greps yourself, read the screenshots, and quote the outputs.
+Look for green-by-accident: a verify that passed only through a temporary proxy or a cached font, a flag that does not
+exist or is not the pod-app path (`create-site --path pod-app`), ids in the brief that drifted from the pod. Record each trap you find as a lesson.
+
+## 4. Report and stop
+
+Post in the slice's session room: what was built (routes, boards matched), the quoted gates, screenshot findings by
+severity (VERIFIED), what only the person can judge (NEEDS-DOGFOOD), and the gaps still open with owners. After
+**slice 1, STOP**: the person's first look on the preview (or the screenshots) decides the next slice. Later slices
+continue in order unless the person stops them; each ends with the same report.
+
+Done when: the PR is open, every gate is quoted by the orchestrator's own run, the differences from the boards are
+listed, and (after slice 1) the person has been asked for their first look.

package/skills/app-factory-build-slice.catalog.json

@@ -0,0 +1,17 @@
+{
+  "apiVersion": "synap/v1",
+  "kind": "skill",
+  "meta": {
+    "slug": "app-factory-build-slice",
+    "name": "App Factory: build a slice",
+    "description": "Build one slice of an app from its approved boards: server-side reads through the person's sign-in, governed writes, the Website Factory gates, an independent re-run of every gate, and a stop for the person's first look after slice 1.",
+    "tags": [
+      "skill",
+      "app-factory",
+      "build",
+      "builder"
+    ],
+    "isPublic": true
+  },
+  "dependencies": []
+}

package/skills/app-factory-design-canvas/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: app-factory-design-canvas
+description: Draw a new app on the design canvas with the Website Factory design kit — every page and every state, desktop and phone, in the real shadcn components from day one, with the person's real data as the sample world and one writer. Use in the Design stage of "Build an app (App Factory)", or when asked to design, mock up or draw an app's screens before building it.
+metadata:
+  synap_native: true
+  auto_load: false
+---
+
+# App Factory: design canvas
+
+The canvas is where the person says yes before any code. It must show the app as it will be built: the real
+components at their real sizes, every state, the phone, and the person's own data. Read the plan (Research output) and
+the decisions first; draw nothing the data contract cannot fill.
+
+## Where the boards live
+
+1. Create the app's repo from the Website Factory now, not at build time: `pnpm create-site <dir> --name "<Name>"
+   --path <path>` in the template (a private repo `Synap-core/site-<slug>`). If the path's bundle is not available
+   yet (`pod-app` exits "bundle not available"), create it from `static`, and keep the gap in the register. Its
+   `design-kit/` is the kit; read `design-kit/README.md` fully.
+2. Work on a branch `design` in that repo and commit `design-kit/src` AND `design-kit/out` after every round. A design
+   that lives only in a scratch folder is lost at the next reboot (it happened).
+3. Publish `design-kit/out` (every `*.dc.html` + `canvas.json`) as the app's design canvas and put its link in the plan.
+
+## Set the look once
+
+Fill `design-kit/tokens.css`: the shadcn token values (background, foreground, card, primary, muted, border, input,
+ring, destructive, radius), the state-mark extras the app uses, the fonts (`@font`), and site macros for the app's
+vocabulary (`@macro status:draft = [[lc:active:Draft]]`, one per lifecycle option, named exactly as the pod's lifecycle).
+Reserve each brand colour for ONE meaning and write the meaning beside it (Content Studio: red only for recording and
+"today", yellow only for the person's own words). Never introduce a colour on a board: `design:check` refuses it.
+
+## What to draw
+
+- **The shell:** `src/Sidebar.dc.html` (256, the registry sidebar: groups, 32 px rows, counts as quiet grey stock or
+  a badge for a queue) and, if the app is used on a phone, `src/TabBar.dc.html` (at most five tabs; a centre `+` only
+  for capture).
+- **One board per page** in the plan's pages table, at 1280, with `expand: fill`. Each page has ONE primary (button
+  `lg`), a header with a trail only when a parent exists, and every named thing as a link to its own board.
+- **The phone**, 390 x 844, for every page the person uses on the phone: tab bar on every phone board, thumb buttons,
+  sheets as drawers (top radius 14, handle), root `width: 100%; max-width: 390px`, no horizontal overflow.
+- **Every state**, per page (on its own "every state" board or beside the page):
+  loading (skeleton in the shape of the rows) · empty, with its answer named: omit (render nothing), invite (an action
+  that fills it), explain (why, and the escape), reassure ("all clear") · failed, with retry inside, never drawn as
+  empty · partly failed (the section, not the page) · gone / no access · offline · long content and many items (a cap
+  and "Show all N") · first run · an action in flight, done with undo, failed · the bridge state when a change waits as
+  a proposal in the pod (`[[pending]]`).
+- **The app islands:** the service or pod down, access ended, not signed in / consent, the person's first run. An
+  island has no sidebar, one sentence, one way forward, and says what is safe.
+- **The flow:** one canvas page that lays the boards out in the order a person lives them (e.g. a week), with row
+  titles in `canvas.json` notes.
+- **The kit page:** the vocabulary sheet (`Vocabulary.dc.html`), the sidebar and the tab bar, so reviewers measure
+  against one sheet.
+
+## The sample world
+
+Use the real rows the research chose: same names, ids, dates and counts on every board. Draw "as of" a real day and
+label any future-state board ("Thursday, after Monday's interview"). The person's own words are verbatim, wrapped in
+`<mark>`; if a board needs words they have not written, it shows the empty state instead. No lorem, no invented
+companies or people (`design:check` catches the obvious ones; the rest is on you).
+
+## Fidelity (the numbers the review checks)
+
+From the template's components (shadcn base-nova), as `vocab.css` draws them: button default 32 (px 10, radius 10,
+14·500, gap 6, icon 16), `lg` 36 = the page primary, sm 28, xs 24; a larger "do it now" button only if the decisions
+added it as a cva size first (Content Studio: one `xl` 48 for Home's single action and the phone thumb buttons). Badge
+20 pill 12·500. Toggle 32, pressed = muted fill. Tabs 32 with a 3 px inset, active = background + shadow-sm; line tabs
+with a 2 px indicator. Card radius 14, padding 16 (12 small), title 16·500. Item rows px 12 py 10, radius 10, title
+14·500, description 14 muted clamped to 2 lines. Input 32, textarea min 64. Kbd 20 muted, no border. Progress 4.
+Sidebar 256, rows 32, group label 12·500 at 70 %. Empty: padding 24, gap 16, media tile 32. Type: display 60 / 36 /
+28 / 24 / 18 only, body 16 and 14, small 12, nothing else; weight 500 for UI, 600 section headings, 700 display;
+spacing on the 4 px grid. Text contrast at least 4.5:1 (muted ink on a tinted ground fails first). No shadows in flow,
+no gradients, no left accent stripes; state is a mark (glyph + one word), never a sentence.
+
+Below 768 the sidebar becomes an offcanvas sheet with a top-bar trigger, a calendar becomes an agenda, list + detail
+becomes list then push: draw one board at 768 or annotate. Dark mode is drawn or explicitly out of v1 (then no theme
+toggle on any board).
+
+## One writer, and the gates
+
+You are the one writer: reviewers report, you apply. After every round:
+
+```bash
+pnpm design:build && pnpm design:check   # lint + stale check, must be 0 problems
+pnpm design:preview                       # overflow + axe per board (run heavy previews on the devbox)
+```
+
+Quote both outputs, commit `src/` + `out/`, republish the canvas, and list every board added or changed with its
+title. Then hand off to `app-factory-design-review`.
+
+## Output
+
+The canvas link; the board list (file · title · page · states covered); a short design brief document in the pod (the
+look decisions with each colour's one meaning, the fidelity numbers used, the sample world, open questions for the
+person). Done when every page in the plan has its desktop board, its states and (if used on a phone) its phone
+board, `design:check` is clean, and `design:preview` shows no overflow and no serious or critical axe issue.