npm - @almadar/skills - Versions diffs - 1.0.0 - Mend

@almadar/skills 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/dist/index.js ADDED Viewed

@@ -0,0 +1,3383 @@
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { generateBehaviorsDocs, getAllBehaviors, generateModulesDocs, getAllStdOperators } from '@almadar/std';
+import { OPERATORS, UI_SLOTS, PATTERN_TYPES, ViewTypeSchema } from '@almadar/core/types';
+import { getPatternPropsCompact, getPatternActionsRef, getAllPatternTypes, getPatternsGroupedByCategory } from '@almadar/patterns';
+// src/generators/utils.ts
+function formatFrontmatter(fm) {
+  const lines = ["---"];
+  lines.push(`name: ${fm.name}`);
+  lines.push(`description: ${fm.description}`);
+  if (fm.allowedTools?.length) {
+    lines.push(`allowed-tools: ${fm.allowedTools.join(", ")}`);
+  }
+  if (fm.version) {
+    lines.push(`version: ${fm.version}`);
+  }
+  lines.push("---");
+  return lines.join("\n");
+}
+function writeSkill(skill, baseDir) {
+  const skillDir = join(baseDir, skill.name);
+  if (!existsSync(skillDir)) {
+    mkdirSync(skillDir, { recursive: true });
+  }
+  const skillMd = formatFrontmatter(skill.frontmatter) + "\n\n" + skill.content;
+  writeFileSync(join(skillDir, "SKILL.md"), skillMd);
+  console.log(`  \u2713 ${skill.name}/SKILL.md`);
+  if (skill.references) {
+    const refsDir = join(skillDir, "references");
+    if (!existsSync(refsDir)) {
+      mkdirSync(refsDir, { recursive: true });
+    }
+    for (const [filename, content] of Object.entries(skill.references)) {
+      writeFileSync(join(refsDir, filename), content);
+      console.log(`  \u2713 ${skill.name}/references/${filename}`);
+    }
+  }
+}
+function writeAllSkills(skills, baseDir) {
+  console.log(`
+Writing ${skills.length} skills to ${baseDir}...`);
+  for (const skill of skills) {
+    writeSkill(skill, baseDir);
+  }
+  console.log(`
+\u2713 Generated ${skills.length} skills`);
+}
+function getMinimalTypeReference() {
+  const patternsByCategory = getPatternsGroupedByCategory();
+  const categories = Object.keys(patternsByCategory);
+  return `## Type Reference
+### Pattern Types
+${categories.map((cat) => `- **${cat}**: ${patternsByCategory[cat].slice(0, 5).join(", ")}...`).join("\n")}
+Total: ${PATTERN_TYPES.length} patterns
+### Operators
+Use S-expressions for guards and effects. See std library for full list.
+**Math**: \`+\`, \`-\`, \`*\`, \`/\`, \`>\`, \`<\`, \`>=\`, \`<=\`, \`=\`, \`!=\`
+**Logic**: \`and\`, \`or\`, \`not\`
+**Effects**: \`set\`, \`++\`, \`--\`, \`persist\`, \`fetch\`, \`emit\`, \`render-ui\`
+`;
+}
+function getSExprQuickRef() {
+  return `## S-Expression Syntax
+**Bindings** (read data):
+- \`@entity.field\` - Entity field value
+- \`@payload.data\` - Event payload data
+- \`@state\` - Current state name
+- \`@now\` - Current timestamp
+**Guards** (boolean expressions):
+\`\`\`json
+[">", "@entity.count", 0]
+["and", ["=", "@state", "Active"], ["<", "@entity.value", 100]]
+\`\`\`
+**Effects** (actions):
+\`\`\`json
+["set", "@entity.count", ["+", "@entity.count", 1]]
+["persist", "update", "Task", "@entity.id", "@payload.data"]
+["emit", "TASK_COMPLETED", { "id": "@entity.id" }]
+\`\`\`
+`;
+}
+function getRenderUIQuickRef() {
+  return `## Render-UI Reference
+**Syntax**: \`["render-ui", slot, config]\`
+**Slots**: \`main\`, \`modal\`, \`drawer\`, \`sidebar\`, \`hud-top\`, \`hud-bottom\`
+**Example**:
+\`\`\`json
+["render-ui", "main", {
+  "type": "entity-table",
+  "entity": "Task",
+  "columns": ["title", "status"]
+}]
+\`\`\`
+Clear a slot: \`["render-ui", "modal", null]\`
+`;
+}
+function getStdMinimalReference() {
+  const operators = getAllStdOperators();
+  return `## Standard Library
+**Operators**: ${operators.length} total
+**Key Categories**:
+- Math: \`clamp\`, \`lerp\`, \`random\`, \`abs\`, \`min\`, \`max\`
+- String: \`concat\`, \`upper\`, \`lower\`, \`trim\`, \`split\`
+- Array: \`filter\`, \`map\`, \`find\`, \`contains\`, \`length\`
+- Time: \`now\`, \`format\`, \`diff\`, \`isPast\`, \`isFuture\`
+Import with: \`uses: [{ from: "std/operators/math", as: "Math" }]\`
+`;
+}
+function getStdFullReference() {
+  const modulesDocs = generateModulesDocs();
+  return `## Standard Library (Full Reference)
+${modulesDocs.modules.map((mod) => `### ${mod.name}
+${mod.description}
+${mod.operators.map((op) => `- **${op.name}**: ${op.description}`).join("\n")}
+`).join("\n")}
+`;
+}
+function getStdBehaviorsWithStateMachines() {
+  const behaviors = getAllBehaviors();
+  const nonGameBehaviors = behaviors.filter(
+    (b) => !b.category?.includes("game") && b.stateMachine
+  );
+  return `## Standard Behaviors
+${nonGameBehaviors.map((behavior) => `### ${behavior.name}
+**States**: ${behavior.stateMachine.states.map((s) => s.name).join(", ")}
+**Events**: ${behavior.stateMachine.events.join(", ")}
+\`\`\`json
+${JSON.stringify(behavior, null, 2)}
+\`\`\`
+`).join("\n\n")}
+`;
+}
+function getKeyBehaviorsReference() {
+  const behaviorsDocs = generateBehaviorsDocs();
+  return `## Key Standard Behaviors
+${behaviorsDocs.categories.map((cat) => `### ${cat.name}
+${cat.behaviors.map((b) => `- **${b.name}**: ${b.description}`).join("\n")}
+`).join("\n")}
+Use with: \`uses: [{ from: "std/behaviors/crud", as: "CRUD" }]\`
+`;
+}
+// src/prompts/skill-sections/architecture.ts
+function getArchitectureSection() {
+  return `## Orbital Architecture
+### Schema Format (IMPORTANT)
+The correct schema format uses **orbitals** array at root:
+\`\`\`json
+{
+  "name": "MyApp",
+  "version": "1.0.0",
+  "orbitals": [           // \u2190 CORRECT: orbitals array
+    {
+      "name": "Task Management",
+      "entity": { ... },
+      "traits": [ ... ],
+      "pages": [ ... ]
+    }
+  ]
+}
+\`\`\`
+**DO NOT** confuse with legacy format that had \`dataEntities\`, \`traits\`, \`pages\` at root level.
+The \`orbitals[]\` format IS the standard format - do not "fix" it to something else.
+**NOTE**: There is NO schema-level \`traits[]\` array. All traits belong inside orbitals.
+### Core Formula
+\`\`\`
+Orbital Unit = Entity \xD7 Traits \xD7 Patterns
+Application  = \u03A3(Orbital Units)
+\`\`\`
+### The Closed Circuit Pattern
+\`\`\`
+Trait State Machine \u2192 render-ui \u2192 UI Component \u2192 User Action \u2192 Event \u2192 Trait
+        \u2191                                                           |
+        \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+\`\`\`
+1. **Trait** transitions to state, fires \`render-ui\` effect
+2. **UI Component** renders with actions (buttons, forms)
+3. **User clicks** \u2192 Component emits event (e.g., \`UI:CREATE\`)
+4. **Trait receives** event, transitions, cycle repeats
+### Key Principles
+| Principle | Rule |
+|-----------|------|
+| **One trait per slot** | Each slot (main, modal, drawer) owned by ONE trait |
+| **INIT renders UI** | Every trait needs INIT self-loop to render initial UI |
+| **One page per entity** | Use trait's render-ui for create/edit/view, not separate pages |
+| **form-section has onSubmit** | Connects form to trait events |
+| **std/* are templates** | Guide LLM generation, not runtime code |
+### Slot Ownership
+\`\`\`
+\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+\u2502 Page: /tasks                                \u2502
+\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524
+\u2502 TaskManagement trait OWNS:                  \u2502
+\u2502   \u2022 main \u2192 entity-table, page-header        \u2502
+\u2502   \u2022 modal \u2192 form-section (create/edit)      \u2502
+\u2502   \u2022 drawer \u2192 entity-detail (view)           \u2502
+\u2502                                             \u2502
+\u2502 NO other trait should render to these slots \u2502
+\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+\`\`\`
+`;
+}
+function getPatternCategories() {
+  const categories = {
+    Header: PATTERN_TYPES.filter(
+      (p) => p.includes("header") || p === "title-only"
+    ),
+    Display: PATTERN_TYPES.filter(
+      (p) => p.startsWith("entity-") || p === "stats"
+    ),
+    Form: PATTERN_TYPES.filter((p) => p.startsWith("form-")),
+    Filter: PATTERN_TYPES.filter(
+      (p) => p.includes("search") || p.includes("filter")
+    ),
+    State: PATTERN_TYPES.filter((p) => p.includes("-state")),
+    Navigation: PATTERN_TYPES.filter((p) => ["tabs", "breadcrumb"].includes(p)),
+    Layout: PATTERN_TYPES.filter(
+      (p) => p.includes("layout") || p.includes("grid") || p === "master-detail"
+    ),
+    Interaction: PATTERN_TYPES.filter((p) => p === "confirmation" || typeof p === "string" && p.includes("confirmation")),
+    Game: PATTERN_TYPES.filter(
+      (p) => p.startsWith("game-") || [
+        "tilemap-renderer",
+        "inventory-panel",
+        "dialogue-box",
+        "level-select"
+      ].includes(p)
+    )
+  };
+  let table = "| Category | Valid Patterns |\n|----------|----------------|\n";
+  for (const [cat, patterns] of Object.entries(categories)) {
+    if (patterns.length > 0) {
+      table += `| ${cat} | ${patterns.map((p) => `\`${p}\``).join(", ")} |
+`;
+    }
+  }
+  return table;
+}
+function getValidViewTypes() {
+  const validTypes = ViewTypeSchema.options;
+  return validTypes.map((t) => `\`${t}\``).join(", ");
+}
+function getCommonErrorsSection() {
+  return `## Critical Rules
+### NEVER Use @payload in set Effects (CRITICAL)
+The \`set\` effect modifies entity state. **@payload is READ-ONLY** - it contains event data.
+\`\`\`json
+// WRONG - @payload is read-only!
+["set", "@payload.data.createdAt", "@now"]
+["set", "@payload.data.status", "active"]
+// CORRECT - Use @entity to modify state
+["set", "@entity.createdAt", "@now"]
+["set", "@entity.status", "active"]
+\`\`\`
+**Rule:** \`set\` target MUST start with \`@entity\`, never \`@payload\`.
+### INIT Transition Required (CRITICAL)
+Every trait MUST have an INIT self-loop transition. The runtime fires \`INIT\` when page loads.
+\`\`\`json
+// REQUIRED in EVERY trait:
+{
+  "from": "Browsing",
+  "to": "Browsing",
+  "event": "INIT",  // \u2190 Runtime fires this on page load
+  "effects": [
+    ["render-ui", "main", { "type": "page-header", ... }],
+    ["render-ui", "main", { "type": "entity-table", ... }]
+  ]
+}
+\`\`\`
+Without INIT: Page loads blank, nothing renders, no UI appears.
+### Valid Patterns ONLY (CRITICAL)
+**DO NOT invent custom patterns!** Only these patterns exist:
+${getPatternCategories()}
+**NEVER use**: \`onboarding-welcome\`, \`category-selector\`, \`assessment-question\`, etc. - these DO NOT exist!
+### Valid viewType Values
+Pages must use valid viewType values: ${getValidViewTypes()}
+Invalid values like \`form\`, \`wizard\`, \`onboarding\` will cause validation errors.
+${getPatternPropsCompact()}
+${getPatternActionsRef()}
+### Page Structure Required (CRITICAL)
+Every page MUST have \`path\` and \`traits\` properties:
+\`\`\`json
+// WRONG - missing path and traits:
+{
+  "pages": [{
+    "name": "TasksPage",
+    "entity": "Task"  // \u274C Missing path and traits!
+  }]
+}
+// CORRECT - complete page definition:
+{
+  "pages": [{
+    "name": "TasksPage",
+    "path": "/tasks",           // \u2190 REQUIRED: starts with /
+    "traits": [{ "ref": "TaskManagement" }]  // \u2190 REQUIRED: trait-driven UI
+  }]
+}
+\`\`\`
+Without \`path\`: Validation error \`ORB_P_MISSING_PATH\`
+Without \`traits\`: Validation error \`ORB_P_MISSING_TRAITS\`
+### Valid Field Types ONLY (CRITICAL)
+Field types MUST be one of: \`string\`, \`number\`, \`boolean\`, \`date\`, \`timestamp\`, \`datetime\`, \`array\`, \`object\`, \`enum\`, \`relation\`
+\`\`\`json
+// WRONG - using entity name as type:
+{ "name": "author", "type": "User" }           // \u274C "User" is not a valid type!
+{ "name": "post", "type": "BlogPost" }         // \u274C Invalid!
+// CORRECT - use relation type with entity reference:
+{ "name": "author", "type": "relation", "relation": { "entity": "User", "cardinality": "one" } }
+{ "name": "post", "type": "relation", "relation": { "entity": "BlogPost", "cardinality": "one" } }
+// CORRECT for arrays of primitives:
+{ "name": "tags", "type": "array", "items": { "type": "string" } }
+// CORRECT for enums:
+{ "name": "status", "type": "enum", "values": ["pending", "active", "done"] }
+\`\`\`
+### Event Listeners Structure
+Event listeners go INSIDE traits, not at orbital level:
+\`\`\`json
+// WRONG - at orbital level:
+{
+  "name": "Task Management",
+  "listens": ["SOME_EVENT"]  // \u274C Wrong location, wrong format
+}
+// CORRECT - inside trait:
+{
+  "traits": [{
+    "name": "TaskInteraction",
+    "listens": [
+      { "event": "USER_UPDATED", "handler": "REFRESH_LIST" }  // \u2705 Object format
+    ]
+  }]
+}
+\`\`\`
+---
+## Common Errors (AVOID)
+### 1. Missing INIT Transition
+\`\`\`
+WRONG: No INIT transition \u2192 Page loads blank
+CORRECT: { "from": "browsing", "to": "browsing", "event": "INIT", "effects": [...render-ui...] }
+\`\`\`
+### 2. Over-Generating Pages
+\`\`\`
+WRONG: TaskListPage, TaskCreatePage, TaskEditPage, TaskViewPage (4 pages!)
+CORRECT: TasksPage with EntityManagement trait (1 page)
+\`\`\`
+### 3. Duplicate Slot Rendering
+\`\`\`
+WRONG: Two traits both render to "main" on page load
+CORRECT: ONE trait owns each slot
+\`\`\`
+### 4. Missing onSubmit in form-section
+\`\`\`
+WRONG: { "type": "form-section", "entity": "Task" }
+CORRECT: { "type": "form-section", "entity": "Task", "onSubmit": "SAVE" }
+\`\`\`
+### 5. Duplicate Transitions (Same from+event)
+\`\`\`
+WRONG: Two transitions with same "from" and "event" without guards
+CORRECT: Use GUARDS to differentiate transitions
+\`\`\`
+### 6. Using "render" Instead of "render-ui"
+\`\`\`
+WRONG: ["render", "main", {...}]
+CORRECT: ["render-ui", "main", {...}]
+\`\`\`
+### 7. Generating Sections Array (Legacy)
+\`\`\`
+WRONG: { "pages": [{ "sections": [...] }] }
+CORRECT: { "pages": [{ "traits": [...] }] } - UI comes from render-ui effects
+\`\`\`
+### 8. Using form-actions Pattern (DOES NOT EXIST!)
+\`\`\`
+WRONG: ["render-ui", "main", { "type": "form-actions", "actions": [...] }]
+CORRECT: Use form-section with onSubmit/onCancel props:
+         { "type": "form-section", "entity": "Task", "fields": [...], "onSubmit": "SAVE", "onCancel": "CANCEL" }
+\`\`\`
+Actions are INSIDE patterns, not separate patterns. The form-section pattern includes submit/cancel buttons.
+### 9. Forgetting itemActions in entity-table
+\`\`\`
+WRONG: { "type": "entity-table", "entity": "Task" }  // No row actions
+CORRECT: { "type": "entity-table", "entity": "Task", "itemActions": [{"label": "Edit", "event": "EDIT"}, {"label": "Delete", "event": "DELETE"}] }
+\`\`\`
+### 10. Duplicate Trait Names Across Orbitals
+\`\`\`
+WRONG: UserOrbital uses "EntityManagement", TaskOrbital uses "EntityManagement"
+CORRECT: UserOrbital uses "UserManagement", TaskOrbital uses "TaskManagement"
+\`\`\`
+Each trait name MUST be unique. Pattern: \`{Entity}{Purpose}\`
+### 11. Using @payload in set Effect
+\`\`\`
+WRONG: ["set", "@payload.acceptedAt", "@now"]  // @payload is read-only!
+CORRECT: ["set", "@entity.acceptedAt", "@now"]  // set modifies entity state
+\`\`\`
+\`set\` effect MUST use \`@entity.field\` binding. \`@payload\` is read-only event data.
+### 12. Hallucinated itemAction Properties
+\`\`\`
+WRONG: { "label": "View", "event": "VIEW", "condition": "@entity.status === 'active'" }
+CORRECT: { "label": "View", "event": "VIEW", "showWhen": ["=", "@entity.status", "active"] }
+\`\`\`
+Valid itemAction props: \`label\`, \`event\`, \`navigatesTo\`, \`placement\`, \`variant\`, \`showWhen\`
+Note: \`showWhen\` is defined but NOT yet implemented - actions always visible.
+### 14. Missing Page Path
+\`\`\`
+WRONG: { "pages": [{ "name": "TasksPage", "entity": "Task" }] }
+CORRECT: { "pages": [{ "name": "TasksPage", "path": "/tasks", "traits": [...] }] }
+\`\`\`
+### 15. Using Entity Name as Field Type
+\`\`\`
+WRONG: { "name": "author", "type": "User" }
+CORRECT: { "name": "author", "type": "relation", "relation": { "entity": "User", "cardinality": "one" } }
+\`\`\`
+### 16. Missing Traits Array on Page
+\`\`\`
+WRONG: { "pages": [{ "name": "TasksPage", "path": "/tasks" }] }
+CORRECT: { "pages": [{ "name": "TasksPage", "path": "/tasks", "traits": [{ "ref": "TaskManagement" }] }] }
+\`\`\`
+### 13. Modal State Machine Pattern (CRITICAL)
+When a transition opens a modal (renders to \`modal\` or \`drawer\` slot), the target state MUST have:
+1. A **CLOSE** transition to clear the modal and return to browsing state
+2. A **CANCEL** transition (for forms with cancel buttons)
+3. The CLOSE/CANCEL effects MUST include \`["render-ui", "modal", null]\` to clear the slot
+\`\`\`json
+// WRONG - Modal opens but no way to close it!
+{
+  "from": "browsing", "to": "creating", "event": "CREATE",
+  "effects": [["render-ui", "modal", { "type": "form-section", ... }]]
+}
+// No CLOSE or CANCEL transition from "creating" \u2192 Page gets stuck!
+// CORRECT - Full modal open/close cycle:
+{
+  "from": "browsing", "to": "creating", "event": "CREATE",
+  "effects": [["render-ui", "modal", { "type": "form-section", "cancelEvent": "CANCEL", ... }]]
+},
+{
+  "from": "creating", "to": "browsing", "event": "CANCEL",
+  "effects": [["render-ui", "modal", null]]
+},
+{
+  "from": "creating", "to": "browsing", "event": "CLOSE",
+  "effects": [["render-ui", "modal", null]]
+},
+{
+  "from": "creating", "to": "browsing", "event": "SAVE",
+  "effects": [
+    ["persist", "create", "Entity", "@payload.data"],
+    ["render-ui", "modal", null],  // \u2190 IMPORTANT: Clear modal on save too!
+    ["fetch", "Entity", {}]
+  ]
+}
+\`\`\`
+**Why CLOSE is needed:** The UI sends \`CLOSE\` when user clicks outside the modal or presses Escape.
+**Why CANCEL is needed:** Forms emit \`CANCEL\` when user clicks the Cancel button.
+**Both are needed** for complete modal behavior. Without them, the modal cannot be dismissed and reopened.
+### 14. Wrong Filtering Pattern (Use Query Singleton)
+\`\`\`
+WRONG: Individual filter buttons with manual FILTER events
+       { "type": "button", "label": "Active", "action": "FILTER", "data": { "status": "active" } }
+CORRECT: Use Query Singleton entity + filter-group pattern:
+\`\`\`
+**Query Singleton Pattern for Filtering:**
+1. Define a singleton entity to hold filter state:
+\`\`\`json
+{
+  "name": "TaskQuery",
+  "entity": {
+    "name": "TaskQuery",
+    "singleton": true,
+    "runtime": true,
+    "fields": [
+      { "name": "status", "type": "string" },
+      { "name": "search", "type": "string" }
+    ]
+  }
+}
+\`\`\`
+2. Use \`set\` effects to update filter state:
+\`\`\`json
+{
+  "from": "Browsing", "to": "Browsing", "event": "FILTER",
+  "effects": [["set", "@TaskQuery.status", "@payload.status"]]
+}
+\`\`\`
+3. Reference query in patterns:
+\`\`\`json
+["render-ui", "main", {
+  "type": "entity-table",
+  "entity": "Task",
+  "query": "@TaskQuery"
+}]
+\`\`\`
+`;
+}
+function getValidationHintsSection() {
+  return `## Validation Error Quick Fixes
+| Error | Fix |
+|-------|-----|
+| ORB_P_MISSING_PATH | Add \`path\` property starting with "/" to page (e.g., "/tasks") |
+| ORB_P_MISSING_TRAITS | Add \`traits\` array to page with at least one trait ref |
+| ORB_E_INVALID_FIELD_TYPE | Use valid type: string, number, boolean, date, enum, relation. NOT entity names! |
+| ORB_INIT_MISSING | Add INIT self-loop transition with render-ui effects |
+| ORB_FORM_SUBMIT | Add onSubmit event name to form-section pattern |
+| ORB_DUPE_TRANS | Add guards to differentiate same-event transitions |
+| ORB_SLOT_CONTENTION | Merge traits or use different slots |
+| ORB_DUPE_PAGE_TRAITS | Remove duplicate trait references from page |
+| ORB_T_DUPLICATE_NAME | Use unique trait names per entity: UserManagement, TaskManagement |
+| ORB_EFF_SET_REQUIRES_ENTITY | Change @payload.field to @entity.field in set effects |
+| ORB_RUI_UNKNOWN_ITEM_ACTION_PROP | Remove invalid props (like \`condition\`), use \`showWhen\` |
+| ORB_MODAL_NO_CLOSE | Add CLOSE/CANCEL transitions from modal states with \`["render-ui", "modal", null]\` |
+`;
+}
+// src/prompts/skill-sections/decomposition.ts
+function getDecompositionSection() {
+  return `## Orbital Decomposition Protocol
+### Step 0: Classify Domain
+| Domain | Keywords | Key Traits |
+|--------|----------|------------|
+| business | manage, track, workflow | EntityManagement, SearchAndFilter |
+| game | play, score, level | Physics2D, Health, GameState |
+| form | wizard, onboarding | Wizard, FormSubmission |
+| dashboard | metrics, KPI | EntityManagement |
+| content | blog, CMS | none (page navigation) |
+### Step 1: Identify Entities (ONE Orbital Per Entity)
+- What are the core data objects?
+- persistent (DB), runtime (memory), or singleton (config)?
+- **CRITICAL: Create exactly ONE orbital per entity** - do NOT split CRUD operations into separate orbitals
+### Step 2: Select Interaction Model
+| Domain | Create | View | Edit | Delete |
+|--------|--------|------|------|--------|
+| business | modal | drawer | modal | confirm |
+| game | none | none | none | none |
+| form | wizard | drawer | page | confirm |
+### Step 3: Choose Traits
+- Business: EntityManagement (handles CRUD via render-ui)
+- Game: Physics2D, Health, Score, Collision
+- Form: Wizard (multi-step) or FormSubmission (single)
+### Step 4: Define State Machine
+\`\`\`
+states: Identify user-facing modes (browsing, creating, editing, viewing)
+events: Identify user actions (INIT, CREATE, VIEW, EDIT, SAVE, CLOSE)
+transitions: Map (from, event) \u2192 (to, effects)
+\`\`\`
+### Step 5: Add INIT Transition (CRITICAL)
+Every trait MUST have:
+\`\`\`json
+{ "from": "initial", "to": "initial", "event": "INIT", "effects": [["render-ui", ...]] }
+\`\`\`
+Without INIT, the page loads blank!
+### Step 6: Define Pages
+- ONE page per entity (business) or workflow (form)
+- Attach traits to pages via \`traits\` array
+- No \`sections\` array - UI comes from render-ui effects
+### Step 7: Add Guards (CRITICAL for Business Rules)
+**Guards enforce business rules as S-expressions on transitions.**
+#### When to use guards:
+1. **Business rule validation** - Enforce constraints on SAVE transitions
+2. **Conditional routing** - Same (from, event) leads to different states
+#### Business Rule Guards (on SAVE):
+\`\`\`json
+{
+  "from": "Editing", "to": "Browsing", "event": "SAVE",
+  "guard": ["and",
+    ["<=", "@payload.data.age", 120],
+    [">=", "@payload.data.balance", 0]
+  ],
+  "effects": [["persist", "update", "Account", "@payload.data"], ...]
+}
+\`\`\`
+#### Conditional Routing Guards:
+\`\`\`json
+{ "from": "A", "to": "B", "event": "X", "guard": [">", "@entity.health", 0] }
+{ "from": "A", "to": "C", "event": "X", "guard": ["<=", "@entity.health", 0] }
+\`\`\`
+**IMPORTANT**:
+- Use \`"guard"\` (singular) on transitions, NOT \`"guards"\` (plural)
+- Business rules MUST be S-expression guards on the transition, NOT just UI messages!
+`;
+}
+function getDecompositionChecklist() {
+  return `## Decomposition Checklist
+- [ ] Domain classified (business/game/form/dashboard/content)
+- [ ] Entities identified with persistence type
+- [ ] **ONE orbital per entity** (not multiple orbitals for same entity!)
+- [ ] Traits selected (EntityManagement for CRUD, domain-specific for others)
+- [ ] State machine has states, events, transitions
+- [ ] INIT transition exists with render-ui effects
+- [ ] Pages defined (ONE per entity/workflow)
+- [ ] Traits attached to pages
+- [ ] **Business rule guards as S-expressions on SAVE transitions**
+- [ ] Entity relations defined for cross-orbital links
+- [ ] emits/listens defined for cross-orbital events
+`;
+}
+function getFlowPatternSection() {
+  return `## Flow Pattern Selection
+Select a flow pattern based on application type:
+| App Type | Flow Pattern | Structure |
+|----------|--------------|-----------|
+| Dashboard/Admin | hub-spoke | Central hub \u2192 feature pages \u2192 back to hub |
+| CRM/List-focused | master-detail | List with drill-down drawer or split view |
+| CRUD App | crud-cycle | List \u2194 modal forms for create/edit |
+| Onboarding/Checkout | linear | Step-by-step wizard flow |
+| Multi-role | role-based | Role guards determine visible features |
+**Flow \u2192 Orbital Structure:**
+- hub-spoke: Dashboard orbital + feature orbitals with navigation
+- master-detail: Entity orbital with detail drawer state
+- crud-cycle: Entity orbital with modal form states
+- linear: Step orbitals connected via navigation
+- role-based: Shared orbitals with role-based guards
+`;
+}
+function getPortableOrbitalOutputSection() {
+  return `## Orbital Output Format
+Each orbital MUST include embedded context for portability:
+\`\`\`json
+{
+  "name": "Order Management",
+  "entity": {
+    "name": "Order",
+    "persistence": "persistent",
+    "fields": [
+      { "name": "customerId", "type": "relation", "relation": { "entity": "Customer", "cardinality": "one" } },
+      { "name": "items", "type": "relation", "relation": { "entity": "MenuItem", "cardinality": "many" } }
+    ]
+  },
+  "traits": ["EntityManagement"],
+  "domainContext": {
+    "request": "<full user request>",
+    "requestFragment": "<verbatim excerpt for THIS orbital>",
+    "category": "business",
+    "vocabulary": { "item": "Order", "create": "Place Order", "delete": "Cancel" }
+  },
+  "design": {
+    "style": "modern",
+    "uxHints": { "flowPattern": "crud-cycle", "listPattern": "entity-table", "formPattern": "modal" }
+  },
+  "emits": ["ORDER_READY", "ORDER_COMPLETED"],
+  "listens": [{ "event": "MENU_ITEM_UNAVAILABLE", "triggers": "DISABLE_ITEM" }],
+  "relations": [
+    { "entity": "Customer", "cardinality": "one" },
+    { "entity": "MenuItem", "cardinality": "many" }
+  ]
+}
+\`\`\`
+**Required context fields:**
+- \`domainContext.requestFragment\` - What user said that produced this orbital
+- \`domainContext.category\` - Domain classification
+- \`domainContext.vocabulary\` - Domain-specific naming
+- \`design.uxHints\` - Pattern selection hints
+**Cross-orbital connectivity (for multi-entity apps):**
+- \`entity.fields[].relation\` - Link to related entities
+- \`emits\` - Events this orbital emits when state changes
+- \`listens\` - Events from other orbitals to handle
+- \`relations\` - Summary of entity relationships
+`;
+}
+function getOrbitalConnectivitySection() {
+  return `## Orbital Connectivity (CRITICAL)
+Orbitals must NOT be discrete islands. For multi-entity apps, connect orbitals properly:
+### 1. Entity Relations (REQUIRED for related entities)
+When Entity A references Entity B, add a relation field:
+\`\`\`json
+// In Order orbital's entity.fields:
+{ "name": "customerId", "type": "relation", "relation": { "entity": "Customer", "cardinality": "one" } }
+{ "name": "items", "type": "relation", "relation": { "entity": "MenuItem", "cardinality": "many" } }
+\`\`\`
+### 2. Navigation Links (in design.uxHints.relatedLinks)
+Enable drill-down from one orbital to another:
+\`\`\`json
+{ "relatedLinks": [{ "relation": "customerId", "label": "View Customer", "targetView": "detail" }] }
+\`\`\`
+### 3. Cross-Orbital Events (emits/listens)
+Orbitals communicate via events:
+\`\`\`json
+// Order orbital emits when status changes:
+{ "emits": ["ORDER_READY", "ORDER_COMPLETED"] }
+// Notification orbital listens:
+{ "listens": [{ "event": "ORDER_READY", "triggers": "NOTIFY_CUSTOMER" }] }
+\`\`\`
+**CRITICAL: For multi-entity apps:**
+- Add relation fields to connect entities (e.g., Order \u2192 Customer, Order \u2192 MenuItem)
+- Add emits/listens when one orbital's state change affects another
+- Add relatedLinks for navigation between related records
+`;
+}
+// src/prompts/skill-sections/custom-traits.ts
+function getCustomTraitSection() {
+  return `## Custom Trait Guide
+### When to Create Custom Traits
+| Scenario | Approach |
+|----------|----------|
+| Standard CRUD list/view/edit | Use \`std/List\` behavior pattern |
+| Multi-step wizard | Custom trait with states = steps |
+| Approval workflow | Custom trait (Drafting \u2192 InReview \u2192 Published) |
+| Payment processing | Custom \`integration\` trait with call-service |
+| Domain-specific workflow | Custom trait matching business states |
+### Trait Categories
+| Category | Purpose | Requires render-ui? |
+|----------|---------|---------------------|
+| \`interaction\` | UI state machine | **YES** - must render UI |
+| \`integration\` | Backend service calls | No |
+### Interaction Trait Requirements (CRITICAL)
+Every \`interaction\` trait MUST have:
+1. **States as objects** with \`isInitial\` flag
+2. **INIT transition** (self-loop on initial state) that renders UI
+3. **render-ui effects** for every state transition
+4. **form-section with onSubmit** to connect forms to events
+### Example: Document Publishing Workflow
+\`\`\`json
+{
+  "name": "DocumentPublishing",
+  "category": "interaction",
+  "linkedEntity": "Document",
+  "stateMachine": {
+    "states": [
+      { "name": "Drafting", "isInitial": true },
+      { "name": "InReview" },
+      { "name": "Published" }
+    ],
+    "events": [
+      { "key": "INIT" },
+      { "key": "SUBMIT" },
+      { "key": "APPROVE" },
+      { "key": "REJECT" }
+    ],
+    "transitions": [
+      {
+        "from": "Drafting",
+        "to": "Drafting",
+        "event": "INIT",
+        "effects": [
+          ["render-ui", "main", {
+            "type": "page-header",
+            "title": "Edit Document",
+            "actions": [{ "label": "Submit", "event": "SUBMIT" }]
+          }],
+          ["render-ui", "main", {
+            "type": "form-section",
+            "entity": "Document",
+            "fields": ["title", "content"],
+            "onSubmit": "SUBMIT"
+          }]
+        ]
+      },
+      {
+        "from": "Drafting",
+        "to": "InReview",
+        "event": "SUBMIT",
+        "effects": [
+          ["set", "@entity.status", "review"],
+          ["persist", "update"],
+          ["render-ui", "main", {
+            "type": "page-header",
+            "title": "In Review"
+          }],
+          ["render-ui", "main", {
+            "type": "entity-detail",
+            "entity": "Document",
+            "fieldNames": ["title", "content"]
+          }],
+          ["render-ui", "main", {
+            "type": "form-section",
+            "submitLabel": "Approve",
+            "cancelLabel": "Reject",
+            "onSubmit": "APPROVE",
+            "onCancel": "REJECT"
+          }]
+        ]
+      },
+      {
+        "from": "InReview",
+        "to": "Drafting",
+        "event": "REJECT",
+        "effects": [
+          ["set", "@entity.status", "draft"],
+          ["persist", "update"],
+          ["emit", "INIT"]
+        ]
+      },
+      {
+        "from": "InReview",
+        "to": "Published",
+        "event": "APPROVE",
+        "effects": [
+          ["set", "@entity.status", "published"],
+          ["set", "@entity.publishedAt", "@now"],
+          ["persist", "update"],
+          ["render-ui", "main", {
+            "type": "page-header",
+            "title": "Published!"
+          }],
+          ["render-ui", "main", {
+            "type": "entity-detail",
+            "entity": "Document"
+          }]
+        ]
+      }
+    ]
+  }
+}
+\`\`\`
+**Key Points:**
+- INIT is a self-loop that renders the initial UI
+- Every state transition has render-ui effects
+- form-section always has onSubmit
+- REJECT emits INIT to re-render Drafting state
+### Example: Integration Trait (Payment)
+\`\`\`json
+{
+  "name": "PaymentProcessing",
+  "category": "integration",
+  "linkedEntity": "Order",
+  "emits": [
+    {
+      "event": "ORDER_PAID",
+      "scope": "external",
+      "description": "Emitted when payment succeeds",
+      "payload": [
+        { "name": "orderId", "type": "string", "required": true, "description": "The paid order ID" },
+        { "name": "total", "type": "number", "required": true, "description": "Order total amount" }
+      ]
+    }
+  ],
+  "stateMachine": {
+    "states": [
+      { "name": "Pending", "isInitial": true },
+      { "name": "Processing" },
+      { "name": "Completed" },
+      { "name": "Failed" }
+    ],
+    "events": [
+      { "key": "PROCESS" },
+      { "key": "SUCCESS" },
+      { "key": "FAILURE" }
+    ],
+    "transitions": [
+      {
+        "from": "Pending",
+        "to": "Processing",
+        "event": "PROCESS",
+        "effects": [
+          ["call-service", "stripe", "charge", {
+            "amount": "@entity.total",
+            "onSuccess": "SUCCESS",
+            "onError": "FAILURE"
+          }]
+        ]
+      },
+      {
+        "from": "Processing",
+        "to": "Completed",
+        "event": "SUCCESS",
+        "effects": [
+          ["set", "@entity.paidAt", "@now"],
+          ["persist", "update"],
+          ["emit", "ORDER_PAID", { "orderId": "@entity.id", "total": "@entity.total" }]
+        ]
+      },
+      {
+        "from": "Processing",
+        "to": "Failed",
+        "event": "FAILURE",
+        "effects": [
+          ["notify", "Payment failed", "error"]
+        ]
+      }
+    ]
+  }
+}
+\`\`\`
+**Note:** Integration traits don't need INIT or render-ui - they're triggered by events, not page load.
+### Cross-Orbital Communication (CRITICAL)
+When traits need to communicate across orbitals, you MUST:
+1. **Declare emits with payload contract:**
+\`\`\`json
+"emits": [
+  {
+    "event": "ORDER_PAID",
+    "scope": "external",
+    "description": "Emitted when payment is confirmed",
+    "payload": [
+      { "name": "orderId", "type": "string", "required": true },
+      { "name": "total", "type": "number", "required": true }
+    ]
+  }
+]
+\`\`\`
+2. **Include payload data in emit effect:**
+\`\`\`json
+["emit", "ORDER_PAID", { "orderId": "@entity.id", "total": "@entity.total" }]
+\`\`\`
+3. **Declare listeners with payloadMapping:**
+\`\`\`json
+"listens": [
+  {
+    "event": "PaymentProcessing.ORDER_PAID",
+    "scope": "external",
+    "triggers": "SEND_RECEIPT",
+    "payloadMapping": {
+      "orderId": "@payload.orderId",
+      "amount": "@payload.total"
+    }
+  }
+]
+\`\`\`
+### Anti-Patterns to Avoid
+| Anti-Pattern | Problem | Fix |
+|--------------|---------|-----|
+| Missing INIT | Page is blank | Add self-loop with render-ui |
+| States as strings | Validation fails | Use \`{ "name": "...", "isInitial": true }\` |
+| No render-ui | UI doesn't update | Add render-ui to every transition |
+| form-section no onSubmit | Form does nothing | Add \`onSubmit: "EVENT"\` |
+| **Using form-actions** | **Pattern doesn't exist!** | **Use form-section with onSubmit/onCancel** |
+| Duplicate (from, event) | Second unreachable | Use guards or different events |
+| from: '*' | Non-deterministic | Use explicit from state |
+| **External emit no payload** | **Listeners have no data** | **Add payload array with typed fields** |
+| **emit effect no data** | **Payload is empty at runtime** | **Pass payload object: \`["emit", "EVT", {...}]\`** |
+### Pattern Action Props Quick Reference
+| Pattern | Action Props | Purpose |
+|---------|--------------|---------|
+| \`page-header\` | \`actions: [{label, event}]\` | Top-right buttons (New, Export) |
+| \`form-section\` | \`onSubmit\`, \`onCancel\` | Form submit/cancel buttons |
+| \`entity-table\` | \`itemActions: [{label, event}]\` | Row action buttons (Edit, Delete) |
+| \`entity-detail\` | \`headerActions: [{label, event}]\` | Detail view header buttons |
+| \`confirmation\` | \`onConfirm\`, \`onCancel\` | Confirmation dialog buttons |
+`;
+}
+function getCustomTraitCompact() {
+  return `## Custom Traits
+**Interaction traits** (UI): MUST have INIT self-loop with render-ui
+**Integration traits** (backend): call-service, no render-ui needed
+States = \`{ "name": "...", "isInitial": true }\` (objects, not strings)
+form-section = always include \`onSubmit: "EVENT"\`
+`;
+}
+// src/prompts/skill-sections/schema-updates.ts
+function getSchemaUpdateSection() {
+  return `## Updating Existing Schemas
+When modifying an existing orbital schema, follow this systematic approach:
+### Step 1: Locate the Target
+Use grep/search to find the right location:
+\`\`\`bash
+# Find entity by name
+grep -n '"entity"' schema.orb -A 5 | grep "TaskEntity"
+# Find trait by name
+grep -n '"traits"' schema.orb | head -10
+# Find specific trait definition
+grep -n '"TaskInteraction"' schema.orb
+# Find state machine transitions
+grep -n '"transitions"' schema.orb -A 30 | head -50
+# Find all events
+grep -n '"events"' schema.orb
+# Find all pages
+grep -n '"pages"' schema.orb -A 10
+\`\`\`
+### Step 2: Identify What to Modify
+| Change Type | Location to Find | What to Modify |
+|-------------|------------------|----------------|
+| Add field | \`"fields": [\` | Add to entity.fields array |
+| Add event | \`"events": [\` | Add to stateMachine.events |
+| Add state | \`"states": [\` | Add to stateMachine.states |
+| Add transition | \`"transitions": [\` | Add to stateMachine.transitions |
+| Add action button | \`"page-header"\` or \`"itemActions"\` | Add to pattern props |
+| Add page | \`"pages": [\` | Add to orbital.pages array |
+| Modify UI | \`"render-ui"\` | Find transition with target slot |
+### Step 3: Common Modifications
+**Add a new field to entity:**
+\`\`\`json
+// Find: "fields": [
+// Add before the closing bracket:
+{ "name": "priority", "type": "enum", "values": ["low", "medium", "high"] }
+\`\`\`
+**Add a new action button to page-header:**
+\`\`\`json
+// Find: INIT transition's page-header
+// Add to actions array:
+{ "label": "Export", "event": "EXPORT", "variant": "secondary" }
+\`\`\`
+**Add a new event:**
+\`\`\`json
+// Find: "events": [
+// Add the event:
+{ "key": "EXPORT", "name": "Export Data" }
+\`\`\`
+**Add a new transition:**
+\`\`\`json
+// Find: "transitions": [
+// Add after existing transitions:
+{
+  "from": "Browsing",
+  "to": "Exporting",
+  "event": "EXPORT",
+  "effects": [
+    ["render-ui", "modal", { "type": "confirmation", "title": "Export?", "onConfirm": "CONFIRM_EXPORT", "onCancel": "CANCEL" }]
+  ]
+}
+\`\`\`
+**Add itemActions to entity-table:**
+\`\`\`json
+// Find: "entity-table" in INIT transition
+// Add itemActions prop:
+"itemActions": [
+  { "label": "View", "event": "VIEW" },
+  { "label": "Edit", "event": "EDIT" },
+  { "label": "Delete", "event": "DELETE", "isDestructive": true }
+]
+\`\`\`
+### Step 4: Ensure Completeness
+After any modification, verify:
+1. **New events have matching transitions** - Every event must have at least one transition that uses it
+2. **New states are reachable** - Every state must have a transition leading to it
+3. **New states have exit transitions** - Every state (except browsing) needs a way back
+4. **UI slots are cleared** - Modals/drawers opened must be closed with \`["render-ui", "modal", null]\`
+### Quick Reference: Finding Traits
+Traits are defined in two places:
+1. **Inline in orbital** (most common):
+\`\`\`json
+"orbitals": [{
+  "traits": [{
+    "name": "TaskInteraction",
+    "stateMachine": { ... }  // <-- trait definition here
+  }]
+}]
+\`\`\`
+2. **Referenced from library**:
+\`\`\`json
+"orbitals": [{
+  "traits": [{
+    "ref": "std/crud"  // <-- references external trait
+  }]
+}]
+\`\`\`
+For inline traits, grep for the trait name. For library traits, find the library file.
+---
+## Large Schema Handling (40KB+)
+For schemas exceeding 40KB, use the **chunking tools** instead of direct editing:
+### Available Tools
+| Tool | Purpose |
+|------|---------|
+| \`query_schema_structure\` | Get lightweight map (~500 bytes): orbitals, traits, sizes |
+| \`extract_chunk\` | Extract orbital/trait to \`.chunks/chunk-{id}.json\` |
+| \`apply_chunk\` | Merge edited chunk back into schema |
+**Note**: These tools work with both \`schema.json\` and \`schema.orb\` files. Changes are auto-persisted.
+### Chunking Workflow
+\`\`\`
+1. DISCOVER: query_schema_structure("schema.orb")
+   \u2192 Returns structure map with orbital/trait names
+2. EXTRACT: extract_chunk({ file: "schema.orb", type: "orbital", name: "Task Management" })
+   \u2192 Creates .chunks/chunk-{id}.json (2-5KB, easy to edit)
+3. EDIT: Use edit_file on chunk file (NOT full schema)
+   \u2192 Much smaller = reliable edits
+4. APPLY: apply_chunk({ chunkId: "..." })
+   \u2192 Merges changes back into schema.orb, auto-persists to database
+\`\`\`
+### Chunk Types
+| Type | When to Use |
+|------|-------------|
+| \`orbital\` | Adding fields, modifying inline traits |
+| \`inline-trait\` | Editing trait inside an orbital (requires \`parentOrbital\`) |
+**Note**: There is no schema-level \`traits[]\` array. All traits belong inside orbitals.
+### When to Use Chunking
+| Schema Size | Strategy |
+|-------------|----------|
+| < 15KB | Direct edit (works fine) |
+| 15-40KB | Targeted edit_file |
+| > 40KB | **Use chunking tools** |`;
+}
+function getSchemaUpdateCompact() {
+  return `## Schema Updates Quick Reference
+**Find location:**
+\`\`\`bash
+grep -n '"entity"' schema.orb -A 5     # Find entities
+grep -n '"traits"' schema.orb          # Find traits
+grep -n '"transitions"' schema.orb     # Find transitions
+\`\`\`
+**Common changes:**
+| Change | Find | Add to |
+|--------|------|--------|
+| Field | \`"fields": [\` | Entity fields array |
+| Event | \`"events": [\` | StateMachine events |
+| State | \`"states": [\` | StateMachine states |
+| Transition | \`"transitions": [\` | StateMachine transitions |
+| Button | \`"page-header"\` | actions array |
+| Row action | \`"entity-table"\` | itemActions array |
+**After changes, verify:**
+- New events have transitions using them
+- New states are reachable and have exits
+- Modals/drawers are closed on completion`;
+}
+// src/prompts/skill-sections/context-usage.ts
+function getContextUsageSection() {
+  return `## Using Embedded Context
+When generating, read context from the orbital:
+| Context Field | Usage |
+|---------------|-------|
+| \`domainContext.requestFragment\` | Understand what user asked for |
+| \`domainContext.category\` | Influences pattern selection |
+| \`domainContext.vocabulary\` | Use for button labels, titles, messages |
+| \`design.style\` | Influences visual density and components |
+| \`design.uxHints.flowPattern\` | Determines overall navigation structure |
+| \`design.uxHints.listPattern\` | Use for entity display (table/cards/list) |
+| \`design.uxHints.formPattern\` | Use for create/edit (modal/drawer/page) |
+| \`design.uxHints.detailPattern\` | Use for detail view (drawer/page/split) |
+| \`design.uxHints.relatedLinks\` | Add navigation to related orbitals |
+**Example usage in generation:**
+\`\`\`
+If domainContext.vocabulary.create = "Recruit"
+  \u2192 Button label: "Recruit" instead of "Create"
+If design.uxHints.listPattern = "entity-cards"
+  \u2192 Use entity-cards pattern instead of entity-table
+If design.uxHints.formPattern = "drawer"
+  \u2192 Render create/edit forms in drawer slot
+\`\`\`
+`;
+}
+function getContextUsageCompact() {
+  return `## Context Usage
+- \`domainContext.vocabulary\` \u2192 labels (item, create, delete)
+- \`design.uxHints.listPattern\` \u2192 entity-table | entity-cards | entity-list
+- \`design.uxHints.formPattern\` \u2192 modal | drawer | page
+- \`design.uxHints.relatedLinks\` \u2192 navigation to related orbitals
+`;
+}
+// src/prompts/skill-sections/design-errors.ts
+function getDesignErrorsSection() {
+  return `## \u274C Design-Specific Errors
+| Error | Wrong | Correct |
+|-------|-------|---------|
+| Entity binding | \`@entity.task.title\` | \`@entity.title\` |
+| Toast effect | \`["toast", "success", "msg"]\` | \`["notify", "in_app", "msg"]\` |
+| Select missing options | \`{ "type": "select" }\` | Add \`"options": [{ "value": "x", "label": "X" }]\` |
+| Undefined trait | \`{ "ref": "NewTrait" }\` | Define trait in \`traits[]\` FIRST |
+| Missing action | \`{ "type": "button" }\` | \`{ "type": "button", "action": "SAVE" }\` |
+### Entity Bindings (CRITICAL)
+\`@entity\` already knows the entity type. Access fields directly:
+\`\`\`
+\u2705 @entity.title        - Direct field access
+\u2705 @entity.address.city - Nested object field (address is an object)
+\u274C @entity.task.title   - Wrong! "task" is the entity type, not a field
+\`\`\`
+### Notification Effects
+Use \`notify\` effect, NOT \`toast\`:
+\`\`\`json
+["notify", "in_app", "Saved!", "success"]  // \u2705 Correct
+["toast", "success", "Saved!"]              // \u274C Invalid effect
+\`\`\`
+Variants: \`success\`, \`error\`, \`warning\`, \`info\`
+### Form Select Fields
+Select fields REQUIRE options array:
+\`\`\`json
+// \u274C Wrong - missing options
+{ "name": "status", "type": "select" }
+// \u2705 Correct - options provided
+{
+  "name": "status",
+  "type": "select",
+  "options": [
+    { "value": "todo", "label": "To Do" },
+    { "value": "done", "label": "Done" }
+  ]
+}
+\`\`\`
+`;
+}
+function getDesignErrorsCompact() {
+  return `## \u274C Design Errors
+| Wrong | Correct |
+|-------|---------|
+| \`@entity.task.title\` | \`@entity.title\` |
+| \`["toast", "success", "msg"]\` | \`["notify", "in_app", "msg"]\` |
+| \`{ "type": "select" }\` | Add \`options: [{value, label}]\` |
+| \`{ "ref": "NewTrait" }\` | Define in \`traits[]\` first |
+`;
+}
+function getIconLibrarySection() {
+  return `### Icons (Lucide)
+Use kebab-case icon names from Lucide:
+| Category | Icons |
+|----------|-------|
+| Actions | \`plus\`, \`pencil\`, \`trash\`, \`eye\`, \`check\`, \`x\`, \`save\` |
+| Navigation | \`chevron-left\`, \`chevron-right\`, \`arrow-left\`, \`home\`, \`menu\` |
+| Status | \`check-circle\`, \`x-circle\`, \`alert-circle\`, \`clock\`, \`loader\` |
+| Content | \`file\`, \`folder\`, \`image\`, \`list\`, \`grid\`, \`clipboard\` |
+| UI | \`search\`, \`filter\`, \`settings\`, \`more-horizontal\`, \`bell\` |
+\`\`\`json
+{ "type": "button", "icon": "plus", "label": "Add" }
+{ "label": "Delete", "icon": "trash", "event": "DELETE" }
+\`\`\`
+`;
+}
+function getIconLibraryCompact() {
+  return `**Icons (Lucide)**: \`plus\`, \`pencil\`, \`trash\`, \`check-circle\`, \`x-circle\`, \`eye\`, \`settings\`, \`search\`, \`filter\``;
+}
+// src/prompts/skill-sections/fixing-guidance.ts
+function getFixingWorkflowSection() {
+  return `## Fixing Workflow
+### Step 1: Validate and Analyze
+\`\`\`
+validate_schema()
+\`\`\`
+Group errors by orbital component:
+- **Entity errors**: Field types, relations, collection names
+- **Trait errors**: State machine, events, transitions
+- **Page errors**: Missing traits, invalid references
+- **Pattern errors**: Missing required fields in render-ui
+### Step 2: Apply Batched Fixes
+Fix ALL errors of the same type in one edit. Priority order:
+1. **Entity fixes** (field types, enums, relations)
+2. **State machine fixes** (initial state, orphan states)
+3. **Transition fixes** (missing INIT, unreachable states)
+4. **Pattern fixes** (missing props in render-ui effects)
+### Step 3: Re-validate
+\`\`\`
+validate_schema()
+\`\`\`
+**STOP when "valid": true** - do not add more tasks or re-verify.`;
+}
+function getCommonFixPatternsSection() {
+  return `## Common Fix Patterns
+### Entity Fixes
+| Error | Before | After |
+|-------|--------|-------|
+| Wrong enum syntax | \`"enumValues": [...]\` | \`"values": [...]\` |
+| Wrong relation | \`"type": "many-to-one"\` | \`"relationType": "many-to-one"\` |
+| Missing collection | (none) | \`"collection": "tasks"\` |
+### State Machine Fixes
+| Error | Before | After |
+|-------|--------|-------|
+| No initial state | \`{ "name": "Idle" }\` | \`{ "name": "Idle", "isInitial": true }\` |
+| String states | \`"states": ["Idle"]\` | \`"states": [{ "name": "Idle", "isInitial": true }]\` |
+| Missing event | (not in events) | Add to \`"events": [...]\` |
+### Transition Fixes
+| Error | Fix |
+|-------|-----|
+| No INIT transition | Add self-loop: \`{ "from": "Browsing", "to": "Browsing", "event": "INIT", "effects": [...] }\` |
+| Orphan state | Add transition TO the state from initial |
+| No exit from state | Add transition FROM the state back to browsing |
+### Pattern Fixes (in render-ui effects)
+| Pattern | Missing | Add |
+|---------|---------|-----|
+| \`entity-table\` | columns | \`"columns": ["field1", "field2"]\` |
+| \`entity-table\` | itemActions | \`"itemActions": [{ "label": "Edit", "event": "EDIT" }]\` |
+| \`form-section\` | onSubmit | \`"onSubmit": "SAVE"\` |
+| \`form-section\` | fields | \`"fields": ["field1", "field2"]\` |
+| \`entity-detail\` | fieldNames | \`"fieldNames": ["field1", "field2"]\` |
+| \`page-header\` | actions | \`"actions": [{ "label": "New", "event": "CREATE" }]\` |`;
+}
+function getOverGenerationSection() {
+  return `## Over-Generation Detection
+**Signs of over-generation:**
+- TaskListPage + TaskCreatePage + TaskEditPage + TaskViewPage (4 pages for 1 entity!)
+- Multiple pages for the same entity CRUD
+**Fix:** Consolidate to ONE page with trait-driven UI:
+\`\`\`json
+// KEEP only:
+{
+  "pages": [{
+    "name": "TasksPage",
+    "path": "/tasks",
+    "viewType": "list",
+    "traits": [{ "ref": "TaskInteraction" }]
+  }]
+}
+// DELETE separate create/edit/view pages
+\`\`\`
+The trait's render-ui effects handle all UI (modals for create/edit, drawers for view).`;
+}
+function getEfficiencySection() {
+  return `## Efficiency Guidelines
+Target: **30-50 tool calls** for most fixes.
+**DO:**
+- Batch related changes (read once, edit all, write once)
+- Fix all same-type errors together
+- Run validation once after all changes
+**DON'T:**
+- Read schema multiple times without changes
+- Make one small change per tool call
+- Re-verify after validation passes
+- Create documentation files`;
+}
+function getCompletionRulesSection() {
+  return `## Completion Rules
+**STOP IMMEDIATELY when:**
+- \`validate_schema()\` returns \`"valid": true\`
+**After validation passes:**
+1. Mark todos complete
+2. STOP - do not add more tasks
+3. Do NOT create documentation
+4. Do NOT "verify" or "confirm"
+5. Do NOT validate again
+The validated schema.json IS your only deliverable.`;
+}
+// src/prompts/skill-sections/game-guidance.ts
+function getGameAsOrbitalsSection() {
+  return `## Games as Orbital Composition
+A game is a **list of orbitals**, each representing a game element:
+\`\`\`
+Game Application = \u03A3(Game Orbitals)
+\u251C\u2500\u2500 Player Orbital (runtime entity + input/physics traits)
+\u251C\u2500\u2500 Enemy Orbital (runtime entity + AI/physics traits)
+\u251C\u2500\u2500 Item Orbital (runtime entity + collectible trait)
+\u251C\u2500\u2500 Level Orbital (singleton entity + level loader trait)
+\u2514\u2500\u2500 GameState Orbital (singleton + score/health traits)
+\`\`\`
+### Persistence Types for Games
+| Type | Use Case | Example |
+|------|----------|---------|
+| \`runtime: true\` | Active game objects | Player, Enemy, Bullet |
+| \`singleton: true\` | Global state | GameConfig, LevelState |
+| \`collection: "..."\` | Saved data | HighScores, SavedGames |`;
+}
+function getGameEntityTemplatesSection() {
+  return `## Game Entity Templates
+### Player Entity (runtime)
+\`\`\`json
+{
+  "name": "Player",
+  "runtime": true,
+  "fields": [
+    { "name": "x", "type": "number", "default": 100 },
+    { "name": "y", "type": "number", "default": 100 },
+    { "name": "velocityX", "type": "number", "default": 0 },
+    { "name": "velocityY", "type": "number", "default": 0 },
+    { "name": "health", "type": "number", "default": 100 },
+    { "name": "facing", "type": "enum", "values": ["left", "right"], "default": "right" }
+  ]
+}
+\`\`\`
+### GameState Entity (singleton)
+\`\`\`json
+{
+  "name": "GameState",
+  "singleton": true,
+  "fields": [
+    { "name": "score", "type": "number", "default": 0 },
+    { "name": "level", "type": "number", "default": 1 },
+    { "name": "lives", "type": "number", "default": 3 },
+    { "name": "state", "type": "enum", "values": ["menu", "playing", "paused", "gameOver"] }
+  ]
+}
+\`\`\`
+### Enemy Entity (runtime)
+\`\`\`json
+{
+  "name": "Enemy",
+  "runtime": true,
+  "fields": [
+    { "name": "x", "type": "number" },
+    { "name": "y", "type": "number" },
+    { "name": "health", "type": "number", "default": 30 },
+    { "name": "damage", "type": "number", "default": 10 },
+    { "name": "patrolStart", "type": "number" },
+    { "name": "patrolEnd", "type": "number" }
+  ]
+}
+\`\`\``;
+}
+function getGameTraitsSection() {
+  return `## Game Traits
+### Core Game Traits
+| Trait | Purpose | Key States |
+|-------|---------|------------|
+| \`Physics2D\` | Gravity, velocity | grounded, airborne, falling |
+| \`PlatformerInput\` | Movement controls | idle, moving, jumping |
+| \`Health\` | Damage, death | alive, hurt, dead |
+| \`Score\` | Points tracking | (stateless - just effects) |
+| \`Collectible\` | Pickup items | available, collected |
+| \`Patrol\` | Enemy AI | patrolling, reversing |
+| \`GameState\` | Game flow | menu, playing, paused, gameOver |
+### Game Trait Example
+\`\`\`json
+{
+  "name": "Physics2D",
+  "category": "interaction",
+  "linkedEntity": "Player",
+  "stateMachine": {
+    "states": [
+      { "name": "grounded", "isInitial": true },
+      { "name": "airborne" }
+    ],
+    "events": [
+      { "key": "JUMP", "name": "Jump" },
+      { "key": "LAND", "name": "Land" }
+    ],
+    "transitions": [
+      {
+        "from": "grounded",
+        "to": "airborne",
+        "event": "JUMP",
+        "effects": [
+          ["set", "@entity.velocityY", -15],
+          ["emit", "PLAYER_JUMPED", "@entity"]
+        ]
+      },
+      {
+        "from": "airborne",
+        "to": "grounded",
+        "event": "LAND",
+        "effects": [
+          ["set", "@entity.velocityY", 0],
+          ["set", "@entity.isGrounded", true]
+        ]
+      }
+    ]
+  }
+}
+\`\`\``;
+}
+function getGamePatternsSection() {
+  return `## Game UI Patterns
+| Pattern | Slot | Purpose |
+|---------|------|---------|
+| \`game-canvas\` | main | Main game rendering |
+| \`game-hud\` | overlay | Score, health, lives |
+| \`game-controls\` | overlay | Touch/keyboard hints |
+| \`game-menu\` | modal | Pause, settings |
+### Game Canvas Effect
+\`\`\`json
+["render-ui", "main", {
+  "type": "game-canvas",
+  "entities": ["Player", "Enemy", "Coin", "Platform"],
+  "camera": { "follow": "Player" },
+  "physics": { "gravity": 980 }
+}]
+\`\`\`
+### Game HUD Effect
+\`\`\`json
+["render-ui", "overlay", {
+  "type": "game-hud",
+  "elements": [
+    { "type": "health-bar", "entity": "Player", "field": "health" },
+    { "type": "score-display", "entity": "GameState", "field": "score" },
+    { "type": "lives-counter", "entity": "GameState", "field": "lives" }
+  ]
+}]
+\`\`\``;
+}
+function getAssetRefSection() {
+  return `## Asset References
+**NEVER hardcode asset paths. Use assetRef:**
+\`\`\`json
+{
+  "entity": {
+    "name": "Player",
+    "assetRef": {
+      "role": "player",
+      "category": "hero",
+      "animations": ["idle", "run", "jump", "fall", "hurt"],
+      "style": "pixel"
+    }
+  }
+}
+\`\`\`
+The compiler resolves \`assetRef\` to actual sprite paths at build time.
+### Animation Mapping
+| State | Animation |
+|-------|-----------|
+| grounded + idle | \`idle\` |
+| grounded + moving | \`run\` |
+| airborne + velocityY < 0 | \`jump\` |
+| airborne + velocityY > 0 | \`fall\` |
+| taking damage | \`hurt\` |
+| health <= 0 | \`die\` |`;
+}
+function getMultiFileSection() {
+  return `## Multi-File Composition
+Split large games into multiple .orb files:
+\`\`\`
+game/
+\u251C\u2500\u2500 game.orb          # Main schema with Player, GameState
+\u251C\u2500\u2500 enemies.orb       # Enemy orbital definitions
+\u251C\u2500\u2500 items.orb         # Collectibles, powerups
+\u2514\u2500\u2500 tiles.orb         # Platforms, terrain
+\`\`\`
+### External Reference Syntax
+\`\`\`json
+{
+  "name": "Level1Enemies",
+  "ref": "./enemies.orb#Slime",
+  "instances": [
+    { "id": "slime-1", "position": { "x": 300, "y": 400 } },
+    { "id": "slime-2", "position": { "x": 600, "y": 400 } }
+  ]
+}
+\`\`\``;
+}
+function getGameTypesSection() {
+  return `## Game Type Templates
+### Platformer
+- Player with Physics2D + PlatformerInput
+- Platform entities for level layout
+- Collectible coins/items
+- Enemies with Patrol trait
+### Puzzle (Match-3, Tetris)
+- Grid-based entity (runtime singleton)
+- Tile/Piece entities
+- Match detection logic in trait
+- Score tracking
+### Roguelike
+- Player with Health + Inventory
+- Dungeon/Room singleton for level gen
+- Enemy entities with AI traits
+- Turn-based or real-time movement
+### Endless Runner
+- Player at fixed X, jumping
+- Obstacles spawning and moving
+- Procedural difficulty scaling
+- Distance-based scoring`;
+}
+// src/prompts/skill-sections/uses-imports.ts
+function getUsesImportSection() {
+  return `## Orbital Import System (\`uses\`)
+Orbitals can import other orbitals to reuse their components.
+### Basic Usage
+\`\`\`json
+{
+  "name": "Level1",
+  "uses": [
+    { "from": "./goblin.orb", "as": "Goblin" },
+    { "from": "./health.orb", "as": "Health" }
+  ],
+  "entity": "Goblin.entity",
+  "traits": [
+    "Goblin.traits.Movement",
+    "Health.traits.Health"
+  ],
+  "pages": []
+}
+\`\`\`
+### Component References
+After importing with \`uses\`, access components via:
+| Component | Reference Format | Example |
+|-----------|------------------|---------|
+| Entity | \`Alias.entity\` | \`"entity": "Goblin.entity"\` |
+| Trait | \`Alias.traits.TraitName\` | \`"traits": ["Health.traits.Health"]\` |
+| Page | \`Alias.pages.PageName\` | \`"pages": ["User.pages.Profile"]\` |
+### Page Path Override
+When importing a page, you can override its URL path:
+\`\`\`json
+{
+  "pages": [
+    { "ref": "User.pages.Profile", "path": "/my-profile" }
+  ]
+}
+\`\`\`
+### Entity Persistence Semantics
+When you reference an imported entity, the behavior depends on its persistence type:
+| Persistence | Sharing Behavior | Use Case |
+|-------------|------------------|----------|
+| \`persistent\` | **Shared** - Same DB collection | Users, Products, Orders |
+| \`runtime\` | **Isolated** - Each orbital gets own instances | Game entities, UI state |
+| \`singleton\` | **Shared** - Single global instance | Config, Game state |
+**Example**: Two orbitals importing a \`runtime\` entity each get separate instances:
+\`\`\`json
+// level1.orb
+{ "entity": "Goblin.entity" }  // Level1's goblins
+// level2.orb
+{ "entity": "Goblin.entity" }  // Level2's goblins (separate!)
+\`\`\`
+### Import Sources
+| Source Format | Description |
+|---------------|-------------|
+| \`"./path.orb"\` | Local relative path |
+| \`"../shared/health.orb"\` | Parent directory |
+| \`"std/behaviors/game-core"\` | Standard library |
+| \`"@game-lib/enemies.orb"\` | Scoped package |
+### Key Rules
+1. **Alias must be PascalCase** - e.g., \`"as": "Health"\`, NOT \`"as": "health"\`
+2. **All traits belong in orbitals** - No schema-level \`traits[]\` array
+3. **References must match imports** - \`Goblin.entity\` requires \`{ "as": "Goblin" }\` in \`uses\`
+4. **Inline OR reference** - Each component slot accepts either form
+`;
+}
+function getUsesImportCompact() {
+  return `## Orbital Imports (\`uses\`)
+Import other orbitals and reference their components:
+\`\`\`json
+{
+  "uses": [{ "from": "./health.orb", "as": "Health" }],
+  "entity": "Health.entity",           // Reference entity
+  "traits": ["Health.traits.Health"],  // Reference trait
+  "pages": ["Health.pages.Dashboard"]  // Reference page
+}
+\`\`\`
+**Alias must be PascalCase.** No schema-level \`traits[]\` array exists.
+`;
+}
+// src/orbitals-skills-generators/lean-orbital-skill-generator.ts
+function generateLeanOrbitalSkill(options = {}) {
+  const {
+    includeExample = true,
+    includeToolWorkflow = true,
+    includeStdLibrary = true,
+    stdLibraryFull = false,
+    includeStdStateMachines = true,
+    includeSchemaUpdates = true
+  } = options;
+  let stdSection = "";
+  if (includeStdLibrary) {
+    if (includeStdStateMachines) {
+      stdSection = `---
+${getKeyBehaviorsReference()}
+---
+${getStdBehaviorsWithStateMachines()}
+`;
+    } else if (stdLibraryFull) {
+      stdSection = `---
+${getStdFullReference()}
+`;
+    } else {
+      stdSection = `---
+${getStdMinimalReference()}
+`;
+    }
+  }
+  return `# Orbital Generation Skill
+> Generate Orbital applications using Orbital Units: Entity \xD7 Traits \xD7 Patterns
+${getArchitectureSection()}
+---
+${getMinimalTypeReference()}
+---
+${getSExprQuickRef()}
+---
+${getRenderUIQuickRef()}
+${stdSection}
+---
+${getFlowPatternSection()}
+---
+${getDecompositionSection()}
+---
+${getPortableOrbitalOutputSection()}
+---
+${getOrbitalConnectivitySection()}
+---
+${getContextUsageCompact()}
+---
+${getCommonErrorsSection()}
+---
+${getCustomTraitSection()}
+${includeToolWorkflow ? getToolWorkflowSection() : ""}
+${includeSchemaUpdates ? `---
+${getSchemaUpdateSection()}
+` : ""}
+${getCriticalOutputRequirements()}
+${includeExample ? getMinimalExample() : ""}
+`;
+}
+function getCriticalOutputRequirements() {
+  return `---
+## CRITICAL: Output Requirements
+Every orbital MUST include:
+### 1. domainContext (REQUIRED)
+\`\`\`json
+"domainContext": {
+  "request": "<original user request>",
+  "requestFragment": "<what part produced THIS orbital>",
+  "category": "business",
+  "vocabulary": { "item": "Task", "create": "Add", "delete": "Remove" }
+}
+\`\`\`
+### 2. design (REQUIRED)
+\`\`\`json
+"design": {
+  "style": "modern",
+  "uxHints": {
+    "flowPattern": "crud-cycle",
+    "listPattern": "entity-table",
+    "formPattern": "modal"
+  }
+}
+\`\`\`
+### 3. Business Rule Guards on SAVE (when rules exist)
+If the user specifies validation constraints, add S-expression guards on transitions:
+\`\`\`json
+{
+  "from": "Creating", "to": "Browsing", "event": "SAVE",
+  "guard": ["<=", "@payload.data.score", 100],
+  "effects": [["persist", "create", "Entry", "@payload.data"], ...]
+}
+\`\`\`
+### 4. ONE Orbital Per Entity
+Do NOT create multiple orbitals for the same entity. All CRUD operations belong in ONE orbital.
+**Missing context fields = validation warnings. Missing guards = unenforced business rules!**`;
+}
+function getToolWorkflowSection() {
+  return `---
+## Tool Workflow
+1. **DECOMPOSE**: Break requirements into OrbitalUnits
+2. **GENERATE**: Call \`generate_orbital\` for each orbital
+3. **COMBINE**: Call \`construct_combined_schema\` (FINAL STEP)
+\`\`\`
+generate_orbital({ orbital: {...}, orbitalIndex: 0, totalOrbitals: N })
+generate_orbital({ orbital: {...}, orbitalIndex: 1, totalOrbitals: N })
+...
+construct_combined_schema({ name: "App", description: "..." })
+# STOP HERE - job is done
+\`\`\`
+`;
+}
+function getMinimalExample() {
+  return `---
+## Example: Task Manager
+\`\`\`json
+{
+  "name": "Taskly",
+  "orbitals": [{
+    "name": "Task Management",
+    "entity": {
+      "name": "Task",
+      "collection": "tasks",
+      "fields": [
+        { "name": "title", "type": "string", "required": true },
+        { "name": "status", "type": "enum", "values": ["pending", "active", "done"] }
+      ]
+    },
+    "traits": [{
+      "name": "TaskInteraction",
+      "category": "interaction",
+      "linkedEntity": "Task",
+      "stateMachine": {
+        "states": [
+          { "name": "Browsing", "isInitial": true },
+          { "name": "Creating" },
+          { "name": "Viewing" },
+          { "name": "Editing" },
+          { "name": "Deleting" }
+        ],
+        "events": ["INIT", "CREATE", "VIEW", "EDIT", "DELETE", "SAVE", "CANCEL", "CONFIRM_DELETE"],
+        "transitions": [
+          {
+            "from": "Browsing", "to": "Browsing", "event": "INIT",
+            "effects": [
+              ["render-ui", "main", { "type": "page-header", "title": "Tasks", "actions": [{ "label": "New Task", "event": "CREATE", "variant": "primary" }] }],
+              ["render-ui", "main", { "type": "entity-table", "entity": "Task", "columns": ["title", "status"], "itemActions": [{ "label": "View", "event": "VIEW" }, { "label": "Edit", "event": "EDIT" }, { "label": "Delete", "event": "DELETE" }] }]
+            ]
+          },
+          {
+            "from": "Browsing", "to": "Creating", "event": "CREATE",
+            "effects": [["render-ui", "modal", { "type": "form-section", "entity": "Task", "fields": ["title", "status"], "submitEvent": "SAVE", "cancelEvent": "CANCEL" }]]
+          },
+          {
+            "from": "Browsing", "to": "Viewing", "event": "VIEW",
+            "effects": [["render-ui", "drawer", { "type": "entity-detail", "entity": "Task", "actions": [{ "label": "Edit", "event": "EDIT" }, { "label": "Delete", "event": "DELETE", "variant": "danger" }] }]]
+          },
+          {
+            "from": "Browsing", "to": "Editing", "event": "EDIT",
+            "effects": [["render-ui", "modal", { "type": "form-section", "entity": "Task", "fields": ["title", "status"], "submitEvent": "SAVE", "cancelEvent": "CANCEL" }]]
+          },
+          {
+            "from": "Browsing", "to": "Deleting", "event": "DELETE",
+            "effects": [["render-ui", "overlay", { "type": "confirmation", "title": "Delete Task?", "message": "This action cannot be undone." }]]
+          },
+          {
+            "from": "Creating", "to": "Browsing", "event": "SAVE",
+            "effects": [["persist", "create", "Task", "@payload.data"], ["render-ui", "modal", null], ["emit", "INIT"]]
+          },
+          {
+            "from": "Creating", "to": "Browsing", "event": "CANCEL",
+            "effects": [["render-ui", "modal", null]]
+          },
+          {
+            "from": "Viewing", "to": "Browsing", "event": "CANCEL",
+            "effects": [["render-ui", "drawer", null]]
+          },
+          {
+            "from": "Editing", "to": "Browsing", "event": "SAVE",
+            "effects": [["persist", "update", "Task", "@payload.data"], ["render-ui", "modal", null], ["emit", "INIT"]]
+          },
+          {
+            "from": "Editing", "to": "Browsing", "event": "CANCEL",
+            "effects": [["render-ui", "modal", null]]
+          },
+          {
+            "from": "Deleting", "to": "Browsing", "event": "CONFIRM_DELETE",
+            "effects": [["persist", "delete", "Task"], ["render-ui", "overlay", null], ["emit", "INIT"]]
+          },
+          {
+            "from": "Deleting", "to": "Browsing", "event": "CANCEL",
+            "effects": [["render-ui", "overlay", null]]
+          }
+        ]
+      }
+    }],
+    "pages": [{ "name": "TasksPage", "path": "/tasks", "traits": [{ "ref": "TaskInteraction" }] }]
+  }]
+}
+\`\`\`
+**Key points**:
+- ONE page (TasksPage) not four (list/create/edit/view)
+- INIT transition renders initial UI (page-header + entity-table)
+- States are OBJECTS with \`isInitial\` flag
+- **Actions are INSIDE patterns (use unified props)**:
+  - \`page-header\` has \`actions: [{label, event, variant}]\`
+  - \`entity-table\` has \`itemActions: [{label, event}]\`
+  - \`form-section\` has \`submitEvent\` and \`cancelEvent\` (NOT onSubmit/onCancel!)
+  - \`entity-detail\` has \`actions\` (NOT headerActions!)
+  - \`confirmation\` emits action events
+- **NEVER use**: \`onSubmit\`, \`onCancel\`, \`headerActions\`, \`loading\` (use \`isLoading\`)
+- NO separate "form-actions" pattern - it doesn't exist!
+`;
+}
+// src/generators/kflow-orbitals.ts
+function generateKflowOrbitalsSkill(compact = false) {
+  const frontmatter = {
+    name: "kflow-orbitals",
+    description: "Generate KFlow schemas using the Orbitals composition model. Decomposes applications into atomic Orbital Units (Entity x Traits x Patterns) with structural caching for efficiency.",
+    allowedTools: ["Read", "Write", "Edit"],
+    version: "3.1.0"
+    // Bumped version for compact option
+  };
+  const content = generateLeanOrbitalSkill({
+    includeExample: true,
+    includeToolWorkflow: true,
+    includeStdStateMachines: !compact
+    // Full std/* examples (21K chars)
+  });
+  return {
+    name: "kflow-orbitals",
+    frontmatter,
+    content
+  };
+}
+function generateLeanFixingSkill(options = {}) {
+  const {
+    includeOverGeneration = true,
+    includeSchemaUpdates = true,
+    includeEfficiency = true
+  } = options;
+  return `# Orbital Fixing Skill
+> Fix validation errors using orbital understanding: Entity \xD7 Traits \xD7 Patterns
+## Key Principle
+\`\`\`
+\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+\u2502  When fixing errors:                                                 \u2502
+\u2502  1. Identify which ORBITAL the error belongs to                      \u2502
+\u2502  2. Identify which COMPONENT (entity/trait/page/pattern)             \u2502
+\u2502  3. Apply targeted fix for that component                            \u2502
+\u2502                                                                      \u2502
+\u2502  This gives you CONTEXT that improves fix accuracy.                  \u2502
+\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+\`\`\`
+---
+${getFixingWorkflowSection()}
+${includeEfficiency ? `---
+${getEfficiencySection()}` : ""}
+---
+${getArchitectureSection()}
+---
+${getMinimalTypeReference()}
+---
+${getSExprQuickRef()}
+---
+${getRenderUIQuickRef()}
+---
+${getPatternActionsRef()}
+---
+${getCommonFixPatternsSection()}
+${includeOverGeneration ? `---
+${getOverGenerationSection()}` : ""}
+---
+${getCommonErrorsSection()}
+${includeSchemaUpdates ? `---
+${getSchemaUpdateSection()}` : ""}
+---
+${getCompletionRulesSection()}
+---
+## Schema File Rule
+\`\`\`
+\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+\u2502  ALWAYS write to: schema.json                                        \u2502
+\u2502                                                                      \u2502
+\u2502  NEVER use other file names like:                                   \u2502
+\u2502  - schema_with_fixes.json  \u274C                                        \u2502
+\u2502  - new_schema.json         \u274C                                        \u2502
+\u2502  - updated_schema.json     \u274C                                        \u2502
+\u2502                                                                      \u2502
+\u2502  The persistence system ONLY reads from schema.json                 \u2502
+\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+\`\`\`
+`;
+}
+function getFixingSkillMetadata() {
+  return {
+    name: "kflow-orbital-fixing",
+    description: "Fix validation errors using orbital understanding (lean version)",
+    version: "2.0.0"
+  };
+}
+// src/generators/kflow-orbital-fixing.ts
+function generateKflowOrbitalFixingSkill() {
+  const metadata = getFixingSkillMetadata();
+  const frontmatter = {
+    name: metadata.name,
+    description: metadata.description,
+    allowedTools: ["Read", "Edit", "Bash"],
+    version: metadata.version
+  };
+  const content = generateLeanFixingSkill({
+    includeOverGeneration: true,
+    includeSchemaUpdates: true,
+    includeEfficiency: true
+  });
+  return {
+    name: metadata.name,
+    frontmatter,
+    content
+  };
+}
+// src/generators/domain-language.ts
+var ODL_SYNTAX_REFERENCE = `
+## Domain Language Syntax
+Entity: \`A [Name] is a [persistent] entity that: - has [field] as [type]\`
+Page: \`[PageName] at /[path]: - shows [Entity] using [Behavior]\`
+`;
+var ODL_EXAMPLES = `
+## Examples
+\`\`\`
+A Task is a persistent entity that:
+  - has title as text (required)
+  - has status as enum [pending, active, done]
+TasksPage at /tasks:
+  - shows Task using List behavior
+\`\`\`
+`;
+var ODL_PATTERNS = `
+## Patterns
+Use patterns like entity-table, form-section in domain language.
+`;
+var ODL_TO_SCHEMA_MAPPING = `
+## Mapping
+Domain language converts to OrbitalSchema JSON via compiler.
+`;
+function generateDomainLanguageSkill() {
+  const frontmatter = {
+    name: "domain-language",
+    description: "Understand, generate, and summarize KFlow domain language. Convert natural language requirements to domain language and provide human-readable summaries.",
+    allowedTools: ["Read", "Write", "Edit"],
+    version: "1.0.0"
+  };
+  const content = `
+# KFlow Domain Language Skill
+This skill enables you to understand, generate, and summarize KFlow domain language - a human-readable format for defining application schemas.
+## What is Domain Language?
+Domain language is a structured text format that represents KFlow schemas in a readable way:
+- **Entities** - Data models with fields and relationships
+- **Pages** - UI views with patterns and traits
+- **Behaviors** - State machines and workflows
+## Capabilities
+### 1. Generate Domain Language from Requirements
+Convert natural language requirements into domain language text.
+### 2. Summarize Domain Language
+Create human-readable summaries of existing domain language definitions.
+### 3. Edit Domain Language
+Make targeted edits to existing domain language text.
+## Domain Language Syntax Reference
+${ODL_SYNTAX_REFERENCE}
+## Patterns Reference
+${ODL_PATTERNS}
+## Full Examples
+${ODL_EXAMPLES}
+## Mapping to Schema
+${ODL_TO_SCHEMA_MAPPING}
+## Generation Workflow
+### Step 1: Analyze Requirements
+Extract key concepts:
+- **Entities** - What data objects are needed?
+- **Fields** - What properties does each entity have?
+- **Pages** - What views are required?
+- **Behaviors** - What workflows or state machines are needed?
+### Step 2: Generate Domain Language
+Use the syntax reference to create valid domain language:
+\`\`\`
+ENTITY TaskEntity:
+  - title: string (required)
+  - description: text
+  - status: enum [pending, in_progress, done]
+  - dueDate: date
+  - assignee: relation -> User
+PAGE TaskListPage:
+  path: /tasks
+  entity: Task
+  viewType: list
+  sections:
+    - header (page-header): title="Tasks"
+    - taskList (entity-list): entity="Task", presentation="table"
+  traits: []
+PAGE TaskCreateForm:
+  path: /tasks/new
+  entity: Task
+  viewType: create
+  sections:
+    - header (page-header): title="Create Task"
+    - form (form-section): entity="Task", layout="vertical"
+    - actions (form-actions): submitLabel="Create Task"
+  traits: [FormSubmission, FormValidation]
+\`\`\`
+### Step 3: Validate Structure
+Ensure:
+1. All entities have required fields
+2. Pages reference valid entities
+3. Traits are from the library or properly defined
+4. Section patterns are valid
+## Summarization Workflow
+### Step 1: Parse Domain Language
+Identify:
+- Number of entities and their purposes
+- Number of pages and their types
+- Key behaviors and workflows
+### Step 2: Generate Summary
+Create a concise summary:
+**Format:**
+\`\`\`
+**{App Name}** - {one-line description}
+**Entities:**
+- {Entity1} - {brief description}
+- {Entity2} - {brief description}
+**Pages:**
+- {Page1} ({viewType}) - {purpose}
+- {Page2} ({viewType}) - {purpose}
+**Features:**
+- {Key behavior 1}
+- {Key behavior 2}
+\`\`\`
+### Summary Requirements
+1. Keep it concise (200 words max)
+2. Focus on business functionality
+3. Use bullet points for clarity
+4. Include entity count and page count
+5. Highlight key workflows
+## Output Format
+### For Generation
+Output ONLY the domain language text - no explanations or commentary.
+### For Summary
+Output a structured summary following the format above.
+### For Edits
+Output the complete updated domain language text.
+## Best Practices
+1. **Use library traits** - Prefer existing traits over custom behaviors
+2. **Follow naming conventions** - PascalCase for entities/pages, camelCase for fields
+3. **Include all required fields** - Every entity needs at least one field
+4. **Define page paths** - Use RESTful URL patterns
+5. **Match patterns to view types** - list\u2192entity-list, detail\u2192entity-detail, create/edit\u2192form-section
+`.trim();
+  return {
+    name: "domain-language",
+    frontmatter,
+    content
+  };
+}
+// src/orbitals-skills-generators/lean/lean-orbital-generator.ts
+var LEAN_CORE_INSTRUCTIONS = `
+## Core Instructions
+Generate orbital schemas using **Domain Language** - a natural, readable format.
+**Output Format**: Domain Language text (NOT JSON)
+**Token Efficiency**: ~5x fewer tokens than JSON format
+`;
+var LEAN_OUTPUT_FORMAT = `
+## Output Format
+Output ONLY domain language text. No JSON, no code blocks, no explanations.
+Example Output:
+\`\`\`
+A Task is a persistent entity that:
+  - has title as text (required)
+  - has status as enum [pending, active, done]
+  - has dueDate as date
+TasksPage at /tasks:
+  - shows Task using List behavior
+  - view type: list
+\`\`\`
+`;
+var LEAN_VALIDATION_RULES = `
+## Validation
+- Every entity needs at least one field
+- Pages must reference valid entities
+- Use standard behaviors from std library
+- S-expressions for guards/effects
+`;
+var LEAN_DECOMPOSITION_PROTOCOL = `
+## Decomposition
+1. Identify entities from requirements
+2. Define fields for each entity
+3. Create pages for each entity (list, create, edit)
+4. Apply std behaviors (List, Detail, Form)
+`;
+var ODL_SYNTAX_REFERENCE2 = `
+## Domain Language Syntax
+**Entity**:
+\`\`\`
+A [Name] is a [persistent/runtime/singleton] entity that:
+  - has [field] as [type] (required)
+  - belongs to [Related]
+  - has many [Related]s
+\`\`\`
+**Page**:
+\`\`\`
+[PageName] at /[path]:
+  - shows [Entity] using [Behavior]
+  - view type: [list|detail|create|edit]
+\`\`\`
+`;
+var LEAN_STD_LIST_BEHAVIOR = `
+## List Behavior
+Use std/behaviors/crud List behavior for entity browsing.
+`;
+var LEAN_EFFECT_GUARD_SYNTAX = `
+## S-Expressions
+Use S-expressions for guards and effects:
+- Guards: \`[">", "@entity.count", 0]\`
+- Effects: \`["set", "@entity.field", value]\`
+`;
+var LEAN_CRITICAL_RULES = `
+## Critical Rules
+1. Use domain language format (NOT JSON)
+2. One page per entity (list view)
+3. Use std behaviors
+`;
+var LEAN_COMMON_ERRORS = `
+## Common Errors
+- Don't generate JSON
+- Don't create separate create/edit/view pages
+- Use std behaviors
+`;
+var ODL_PATTERNS2 = `
+## Patterns
+Entity patterns: entity-table, entity-list, entity-cards
+Form patterns: form-section
+`;
+var ODL_TO_SCHEMA_MAPPING2 = `
+## Mapping
+Domain language is converted to OrbitalSchema JSON by the compiler.
+`;
+var LEAN_ERROR_HANDLING = `
+## Error Handling
+Output corrected domain language when errors occur.
+`;
+function generateLeanOrbitalSkill2() {
+  return `---
+name: kflow-lean-orbitals
+description: Generate OrbitalSchema applications using Domain Language with S-Expression effects.
+allowed-tools: Read, generate_orbital_domain
+version: 2.1.0
+---
+# kflow-lean-orbitals
+> Generate OrbitalSchema applications using Domain Language
+>
+> **Output**: Domain Language text with S-Expression effects
+> **Tools**: \`generate_orbital_domain\` (per-orbital generation with auto-persist)
+---
+${LEAN_CORE_INSTRUCTIONS}
+---
+${LEAN_DECOMPOSITION_PROTOCOL}
+---
+${LEAN_STD_LIST_BEHAVIOR}
+---
+${LEAN_OUTPUT_FORMAT}
+---
+${ODL_SYNTAX_REFERENCE2}
+---
+${LEAN_EFFECT_GUARD_SYNTAX}
+---
+${LEAN_CRITICAL_RULES}
+---
+${LEAN_COMMON_ERRORS}
+---
+${ODL_PATTERNS2}
+---
+${ODL_TO_SCHEMA_MAPPING2}
+---
+${LEAN_VALIDATION_RULES}
+---
+${LEAN_ERROR_HANDLING}
+---
+## Workflow Summary (MANDATORY TOOL USAGE)
+\u26A0\uFE0F **CRITICAL: You MUST use \`generate_orbital_domain\` for EACH orbital.**
+\u26A0\uFE0F **NEVER use Write/Edit to create domain language directly - always use the tools.**
+The tools handle proper prompting, caching, and S-Expression syntax. Writing directly will fail.
+### Phase 1: Decomposition (CRITICAL - NO tool calls yet)
+**You MUST decompose the application into orbitals BEFORE calling any tools.**
+1. **Classify domain** - business, game, form, dashboard, content
+2. **Identify entities** - List ALL data objects with:
+   - Fields (name, type, required, default)
+   - Relationships (belongs_to, has_many)
+   - Persistence type (persistent, runtime, singleton)
+3. **Resolve cross-references** - Ensure every "belongs to X" has entity X planned
+4. **Plan orbitals** - Create a spec for each:
+\`\`\`json
+{
+  "name": "Task Management",
+  "entity": {
+    "name": "Task",
+    "persistence": "persistent",
+    "fields": [
+      { "name": "title", "type": "text", "required": true },
+      { "name": "status", "type": "enum [todo, done]", "default": "todo" }
+    ],
+    "relations": [
+      { "entity": "User", "type": "belongs_to" }
+    ]
+  },
+  "pages": [
+    { "name": "TasksPage", "path": "/tasks", "viewType": "list", "isInitial": true }
+  ],
+  "traits": ["TaskManager"],
+  "patterns": ["page-header", "entity-table", "form-section", "entity-detail"]
+}
+\`\`\`
+### Phase 2: Chunked Generation (generate_orbital_domain)
+For EACH orbital spec, call the \`generate_orbital_domain\` tool:
+\`\`\`json
+{
+  "sessionId": "my-app-session",
+  "orbital": { ... orbital spec from Phase 1 ... },
+  "orbitalIndex": 0,
+  "totalOrbitals": 3
+}
+\`\`\`
+This tool:
+- Uses LLM with proper prompts (S-Expression syntax, patterns, CRUD template)
+- Caches results by fingerprint
+- **Auto-persists**: Each orbital is immediately converted to OrbitalSchema and saved
+### Phase 3: Finish
+After ALL orbitals are generated, call \`finish_task\` to complete the workflow.
+No manual merging needed - the schema is built incrementally as each orbital is generated.
+---
+## Tool Reference
+### generate_orbital_domain
+Generate domain language for ONE orbital using LLM with proper prompts.
+**Input:**
+- \`sessionId\`: Unique session ID for this batch
+- \`orbital\`: Orbital spec (entity, pages, traits, patterns)
+- \`orbitalIndex\`: Position in batch (0-based)
+- \`totalOrbitals\`: Total orbitals being generated
+**Output:**
+- \`success\`: Whether generation succeeded
+- \`domainText\`: Generated domain language
+- \`cached\`: Whether result was from cache
+- \`usage\`: Token usage
+- \`schema\`: The orbital converted to OrbitalSchema (auto-persisted)
+---
+## Complete Example
+**User**: Create a task management app
+**Assistant** writes domain.txt:
+\`\`\`
+# Entities
+A Task is a persistent entity that:
+  - has title as text (required)
+  - has description as long text
+  - has status as enum [todo, in_progress, done] with default "todo"
+  - has priority as enum [low, medium, high] with default "medium"
+  - has dueDate as date
+# Pages
+TasksPage at /tasks:
+  - shows Task using TaskManager
+  - view type: list
+  - is initial page
+# Behaviors
+TaskManager behavior:
+  Entity: Task
+  States: Browsing, Creating, Viewing, Editing, Deleting
+  Initial: Browsing
+  Transitions:
+    - From Browsing to Browsing on INIT
+      then ["render-ui", "main", {"type": "page-header", "title": "Tasks", "actions": [{"label": "New Task", "event": "CREATE", "variant": "primary"}]}]
+      then ["render-ui", "center", {"type": "entity-table", "entity": "Task", "columns": ["title", "status", "priority", "dueDate"], "itemActions": [{"label": "View", "event": "VIEW"}, {"label": "Edit", "event": "EDIT"}, {"label": "Delete", "event": "DELETE", "variant": "danger"}]}]
+    - From Browsing to Creating on CREATE
+      then ["render-ui", "modal", {"type": "form-section", "entity": "Task", "fields": ["title", "description", "status", "priority", "dueDate"], "submitEvent": "SAVE", "cancelEvent": "CANCEL"}]
+    - From Creating to Browsing on SAVE
+      then ["persist", "create", "Task", "@payload.data"]
+      then ["render-ui", "modal", null]
+      then ["emit", "INIT"]
+    - From Creating to Browsing on CANCEL
+      then ["render-ui", "modal", null]
+    - From Browsing to Viewing on VIEW
+      then ["render-ui", "drawer", {"type": "entity-detail", "entity": "Task", "fieldNames": ["title", "description", "status", "priority", "dueDate"], "actions": [{"label": "Edit", "event": "EDIT"}, {"label": "Delete", "event": "DELETE", "variant": "danger"}]}]
+    - From Viewing to Editing on EDIT
+      then ["render-ui", "drawer", null]
+      then ["render-ui", "modal", {"type": "form-section", "entity": "Task", "submitEvent": "SAVE", "cancelEvent": "CANCEL"}]
+    - From Browsing to Editing on EDIT
+      then ["render-ui", "modal", {"type": "form-section", "entity": "Task", "submitEvent": "SAVE", "cancelEvent": "CANCEL"}]
+    - From Editing to Browsing on SAVE
+      then ["persist", "update", "Task", "@payload.data"]
+      then ["render-ui", "modal", null]
+      then ["emit", "INIT"]
+    - From Editing to Browsing on CANCEL
+      then ["render-ui", "modal", null]
+    - From Viewing to Browsing on CANCEL
+      then ["render-ui", "drawer", null]
+    - From Browsing to Deleting on DELETE
+      then ["render-ui", "overlay", {"type": "confirmation", "title": "Delete Task?", "message": "This action cannot be undone."}]
+    - From Viewing to Deleting on DELETE
+      then ["render-ui", "drawer", null]
+      then ["render-ui", "overlay", {"type": "confirmation", "title": "Delete Task?", "message": "This action cannot be undone."}]
+    - From Deleting to Browsing on CONFIRM_DELETE
+      then ["persist", "delete", "Task"]
+      then ["render-ui", "overlay", null]
+      then ["emit", "INIT"]
+    - From Deleting to Browsing on CANCEL
+      then ["render-ui", "overlay", null]
+\`\`\`
+**Key points in this example:**
+- **Entity: Task** explicitly links the behavior to the Task entity (REQUIRED)
+- INIT renders BOTH page-header (with "New Task" action) AND entity-table (with View/Edit/Delete itemActions)
+- All effects use S-Expression format
+- Modal for create/edit, drawer for view, overlay for delete confirmation
+- Each open slot is closed with \`null\` when done
+- SAVE emits INIT to refresh the list
+`;
+}
+// src/orbitals-skills-generators/lean/lean-fixing-generator.ts
+var LEAN_CORE_INSTRUCTIONS2 = `
+## Core Instructions
+Fix validation errors by outputting corrected Domain Language text.
+`;
+var LEAN_ERROR_HANDLING2 = `
+## Error Handling
+1. Read the error message carefully
+2. Locate the problematic section
+3. Output corrected domain language
+`;
+var LEAN_VALIDATION_RULES2 = `
+## Validation Rules
+- Required fields must be marked
+- Entity references must be valid
+- Page paths must be unique
+- Behaviors must be from std library
+`;
+var ODL_SYNTAX_REFERENCE3 = `
+## Domain Language Syntax
+See kflow-lean-orbitals skill for full syntax reference.
+`;
+var LEAN_EFFECT_GUARD_SYNTAX2 = `
+## S-Expressions
+Use S-expressions in domain language for guards and effects.
+`;
+var ODL_TO_SCHEMA_MAPPING3 = `
+## Schema Mapping
+Domain language maps to OrbitalSchema JSON structure.
+`;
+function generateLeanFixingSkill2() {
+  return `---
+name: kflow-lean-fixing
+description: Fix OrbitalSchema validation errors using Domain Language format.
+allowed-tools: Read, Write, Edit
+version: 1.0.0
+---
+# kflow-lean-fixing
+> Fix OrbitalSchema validation errors using Domain Language
+>
+> **Input**: Validation errors + current ODL
+> **Output**: Fixed Domain Language sections
+---
+${LEAN_CORE_INSTRUCTIONS2}
+---
+## Error Fixing Protocol
+1. **Parse error code** - Identify the error type (ORB_E_*, ORB_T_*, etc.)
+2. **Locate section** - Find the corresponding ODL section
+3. **Apply fix** - Correct the issue in ODL format
+4. **Output fixed section only** - Don't re-output unchanged sections
+---
+${LEAN_ERROR_HANDLING2}
+---
+## Common Fixes
+### ORB_E_MISSING_NAME
+**Error**: Entity missing name
+**Fix**: Ensure entity definition starts with "A [Name] is..."
+Before:
+\`\`\`
+is a persistent entity that:
+  - has title as text
+\`\`\`
+After:
+\`\`\`
+A Task is a persistent entity that:
+  - has title as text
+\`\`\`
+### ORB_E_NO_FIELDS
+**Error**: Entity has no fields
+**Fix**: Add at least one field definition
+Before:
+\`\`\`
+A Task is a persistent entity that:
+\`\`\`
+After:
+\`\`\`
+A Task is a persistent entity that:
+  - has title as text (required)
+\`\`\`
+### ORB_T_NO_INITIAL_STATE
+**Error**: Behavior has no initial state
+**Fix**: Add "Initial: [StateName]" line
+Before:
+\`\`\`
+TaskManager behavior:
+  States: Viewing, Editing
+  Transitions:
+    ...
+\`\`\`
+After:
+\`\`\`
+TaskManager behavior:
+  States: Viewing, Editing
+  Initial: Viewing
+  Transitions:
+    ...
+\`\`\`
+### ORB_T_INVALID_TRANSITION
+**Error**: Transition references non-existent state
+**Fix**: Ensure From/To states exist in States list
+Before:
+\`\`\`
+TaskManager behavior:
+  States: Viewing, Editing
+  Initial: Viewing
+  Transitions:
+    - From Viewing to Creating on CREATE  # 'Creating' not in States
+\`\`\`
+After:
+\`\`\`
+TaskManager behavior:
+  States: Viewing, Editing, Creating  # Added Creating
+  Initial: Viewing
+  Transitions:
+    - From Viewing to Creating on CREATE
+\`\`\`
+### ORB_P_NO_PATH
+**Error**: Page has no path
+**Fix**: Add "at /[path]" to page definition
+Before:
+\`\`\`
+TasksPage:
+  - shows Task using TaskManager
+\`\`\`
+After:
+\`\`\`
+TasksPage at /tasks:
+  - shows Task using TaskManager
+\`\`\`
+### ORB_E_INVALID_RELATION
+**Error**: Relation references non-existent entity
+**Fix**: Ensure target entity is defined
+Before:
+\`\`\`
+A Task is a persistent entity that:
+  - belongs to Project  # Project not defined
+\`\`\`
+After (add missing entity):
+\`\`\`
+A Project is a persistent entity that:
+  - has name as text (required)
+A Task is a persistent entity that:
+  - belongs to Project
+\`\`\`
+---
+${ODL_SYNTAX_REFERENCE3}
+---
+${LEAN_EFFECT_GUARD_SYNTAX2}
+---
+${LEAN_VALIDATION_RULES2}
+---
+${ODL_TO_SCHEMA_MAPPING3}
+---
+## Output Format
+**IMPORTANT**: Always write your fixes to \`domain.txt\` using the Write or Edit tool.
+1. If \`domain.txt\` exists, use the Edit tool to modify it
+2. If it doesn't exist, use the Write tool to create it
+3. The file must contain the COMPLETE domain language with your fixes applied
+4. Do NOT just output text to the chat - you must write to the file
+When fixing errors:
+- Read the existing domain.txt (if present)
+- Apply fixes to the affected sections
+- Write the complete fixed content to domain.txt
+- Confirm the changes were applied
+Example workflow:
+1. Read domain.txt to understand current structure
+2. Edit the specific section that has errors
+3. Verify the fix by reading the file again
+`;
+}
+// src/generators/index.ts
+function generateAllBuilderSkills() {
+  return [
+    generateKflowOrbitalsSkill(),
+    generateKflowOrbitalFixingSkill(),
+    {
+      name: "kflow-lean-orbitals",
+      frontmatter: {
+        name: "kflow-lean-orbitals",
+        description: "Generate schemas using Domain Language (~5x fewer tokens)",
+        allowedTools: ["Read", "Write", "Edit"]
+      },
+      content: generateLeanOrbitalSkill2()
+    },
+    {
+      name: "kflow-lean-fixing",
+      frontmatter: {
+        name: "kflow-lean-fixing",
+        description: "Fix validation errors using Domain Language",
+        allowedTools: ["Read", "Write", "Edit"]
+      },
+      content: generateLeanFixingSkill2()
+    },
+    generateDomainLanguageSkill()
+  ];
+}
+function getMinimalTypeReference2() {
+  return `
+## Orbital Schema Structure
+\`\`\`typescript
+interface OrbitalDefinition {
+  name: string;              // Entity name (PascalCase)
+  entity: Entity;            // Data model
+  traits: TraitRef[];        // State machines (names or definitions)
+  pages: Page[];             // Routes and views
+  emits?: string[];          // Events this orbital emits
+  listens?: EventListener[]; // Events this orbital listens to
+}
+\`\`\`
+### Entity Fields
+\`\`\`typescript
+{ name: "title", type: "string", required: true }
+{ name: "count", type: "number", default: 0 }
+{ name: "status", type: "enum", values: ["pending", "active", "done"] }
+{ name: "dueDate", type: "date" }
+\`\`\`
+### Trait State Machine
+\`\`\`typescript
+{
+  states: [{ name: "Idle", isInitial: true }, { name: "Active" }],
+  events: ["INIT", "ACTIVATE", "COMPLETE"],
+  transitions: [
+    { from: "Idle", to: "Active", event: "ACTIVATE",
+      guards: [["condition"]],
+      effects: [["action"]] }
+  ]
+}
+\`\`\`
+`.trim();
+}
+function getPatternTypesCompact() {
+  const patterns = getAllPatternTypes();
+  return `
+## Available Pattern Types
+${patterns.map((p) => `- \`${p}\``).join("\n")}
+${getPatternPropsCompact()}
+`.trim();
+}
+function getSExprQuickRef2() {
+  const operators = Object.keys(OPERATORS).slice(0, 15);
+  return `
+## S-Expression Quick Reference
+### Guard Expressions (Conditions)
+\`\`\`typescript
+["=", "@entity.status", "active"]        // Equality
+[">", "@entity.count", 0]                 // Greater than
+["and", ["cond1"], ["cond2"]]            // Logical AND
+["or", ["cond1"], ["cond2"]]             // Logical OR
+["not", ["condition"]]                    // Logical NOT
+\`\`\`
+### Effect Expressions (Actions)
+\`\`\`typescript
+["set", "@entity.field", value]          // Update field
+["emit", "EVENT_NAME", payload]          // Emit event
+["navigate", "/path"]                     // Navigate to route
+["render-ui", "main", { type, props }]   // Render pattern
+["persist", "create", "Entity", data]    // Database operation
+\`\`\`
+### Available Operators
+${operators.map((op) => `- \`${op}\``).join("\n")}
+`.trim();
+}
+function getRenderUIQuickRef2() {
+  const slots = UI_SLOTS;
+  return `
+## Render-UI Effect Reference
+### Syntax
+\`\`\`typescript
+["render-ui", slot, patternConfig | null]
+\`\`\`
+### UI Slots
+${slots.map((slot) => `- \`${slot}\``).join("\n")}
+### Example
+\`\`\`typescript
+["render-ui", "main", {
+  type: "entity-table",
+  entity: "Task",
+  columns: ["title", "status"],
+  itemActions: [{ label: "Edit", event: "EDIT" }]
+}]
+\`\`\`
+Clear slot: \`["render-ui", "modal", null]\`
+`.trim();
+}
+function getFieldTypesCompact() {
+  return `
+## Field Types
+| Type | Example | Notes |
+|------|---------|-------|
+| \`string\` | \`{ name: "title", type: "string" }\` | Text |
+| \`number\` | \`{ name: "count", type: "number" }\` | Integer or float |
+| \`boolean\` | \`{ name: "active", type: "boolean" }\` | true/false |
+| \`date\` | \`{ name: "birthday", type: "date" }\` | Date only |
+| \`timestamp\` | \`{ name: "createdAt", type: "timestamp" }\` | Date + time |
+| \`enum\` | \`{ name: "status", type: "enum", values: ["a", "b"] }\` | Fixed options |
+| \`array\` | \`{ name: "tags", type: "array", items: "string" }\` | List |
+| \`relation\` | \`{ name: "user", type: "relation", relation: { entity: "User", cardinality: "one" } }\` | Foreign key |
+### Field Properties
+- \`required: true\` - Must have value
+- \`default: value\` - Default value
+- \`unique: true\` - Must be unique
+`.trim();
+}
+// src/prompts/generation-prompts.ts
+function getOrbitalDecompositionPrompt() {
+  return `
+## Orbital Unit Decomposition Protocol
+${getArchitectureSection()}
+---
+${getDecompositionSection()}
+---
+${getDecompositionChecklist()}
+---
+## Pattern Selection
+${getPatternTypesCompact()}
+---
+${getValidationHintsSection()}
+`.trim();
+}
+function getFullOrbitalPrompt() {
+  return `
+# Subagent: Expand Lightweight Orbital to Full Orbital
+You receive a lightweight OrbitalDefinition and must expand it into a complete FullOrbitalUnit with traits, state machines, and UI.
+---
+${getArchitectureSection()}
+---
+${getMinimalTypeReference2()}
+---
+${getSExprQuickRef2()}
+---
+${getRenderUIQuickRef2()}
+---
+${getFieldTypesCompact()}
+---
+${getCustomTraitSection()}
+---
+${getUsesImportSection()}
+---
+${getCommonErrorsSection()}
+---
+## Output Format
+Return ONLY valid JSON matching the FullOrbitalUnit structure. No markdown, no explanations.
+\`\`\`json
+{
+  "name": "EntityName",
+  "entity": { ... },
+  "traits": [ ... ],
+  "pages": [ ... ]
+}
+\`\`\`
+`.trim();
+}
+function getRequirementsDecomposePrompt() {
+  return `
+## Requirements-Aware Decomposition
+When decomposing with extracted requirements, use them to improve orbital identification:
+### Using Entity Requirements
+For each entity in \`requirements.entities\`:
+- Create one OrbitalUnit per **primary** entity
+- Group related entities (e.g., Order + OrderItem in same orbital)
+- Consider entity relationships when grouping
+### Using State Requirements
+For each state in \`requirements.states\`:
+- Identify which entity lifecycle it belongs to
+- Create states in that entity's trait state machine
+### Using Event Requirements
+For each event in \`requirements.events\`:
+- Map to trait events (UPPERCASE)
+- Connect to appropriate transitions
+### Using Guard Requirements
+For each guard in \`requirements.guards\`:
+- Identify which entity the guard applies to
+- Include guard description in that entity's orbital
+- The subagent will convert to guard expression
+### Using Effect Requirements
+For each effect in \`requirements.effects\`:
+- Identify the trigger (e.g., "on confirmation")
+- Identify the action (e.g., "send email")
+- Include in relevant orbital's effects list
+${getValidationHintsSection()}
+`.trim();
+}
+function getRequirementsTraitPrompt() {
+  return `
+## Generating Traits from Requirements
+When generating a FullOrbitalUnit, convert requirements to schema elements:
+### Guard Patterns
+Common guard patterns to recognize:
+| Requirement | Guard Expression |
+|-------------|-----------------|
+| "only managers can approve" | \`["=", "@context.user.role", "manager"]\` |
+| "amount must be positive" | \`[">", "@entity.amount", 0]\` |
+| "if status is pending" | \`["=", "@entity.status", "pending"]\` |
+| "user is authenticated" | \`["=", "@context.user.authenticated", true]\` |
+### Effect Patterns
+Common effect patterns to recognize:
+| Requirement | Effect Type | Template |
+|-------------|------------|----------|
+| "send email" | \`emit\` | \`["emit", "EMAIL_SEND", { "to": "...", "subject": "..." }]\` |
+| "update status" | \`set\` | \`["set", "@entity.status", "newValue"]\` |
+| "navigate to page" | \`navigate\` | \`["navigate", "/page"]\` |
+| "show notification" | \`emit\` | \`["emit", "NOTIFY", { "message": "..." }]\` |
+### State Machine Construction
+1. Extract states from requirements.states
+2. Create events for state transitions (UPPERCASE)
+3. Add transitions with appropriate guards
+4. Include render-ui effects for each state
+${getCommonErrorsSection()}
+`.trim();
+}
+function getKeyBehaviorsReference2() {
+  const behaviorsDocs = generateBehaviorsDocs();
+  return `## Key Standard Behaviors
+${behaviorsDocs.categories.map((cat) => `### ${cat.name}
+${cat.behaviors.map((b) => `- **${b.name}**: ${b.description}`).join("\n")}
+`).join("\n")}
+Use with: \`uses: [{ from: "std/behaviors/crud", as: "CRUD" }]\`
+`;
+}
+export { formatFrontmatter, generateAllBuilderSkills, generateDomainLanguageSkill, generateKflowOrbitalFixingSkill, generateKflowOrbitalsSkill, generateLeanFixingSkill2 as generateLeanFixingSkill, generateLeanFixingSkill as generateLeanFixingSkillFull, generateLeanOrbitalSkill2 as generateLeanOrbitalSkill, generateLeanOrbitalSkill as generateLeanOrbitalSkillFull, getArchitectureSection, getAssetRefSection, getCommonErrorsSection, getCommonFixPatternsSection, getCompletionRulesSection, getContextUsageCompact, getContextUsageSection, getCustomTraitCompact, getCustomTraitSection, getDecompositionChecklist, getDecompositionSection, getDesignErrorsCompact, getDesignErrorsSection, getEfficiencySection, getFieldTypesCompact, getFixingWorkflowSection, getFlowPatternSection, getFullOrbitalPrompt, getGameAsOrbitalsSection, getGameEntityTemplatesSection, getGamePatternsSection, getGameTraitsSection, getGameTypesSection, getIconLibraryCompact, getIconLibrarySection, getKeyBehaviorsReference2 as getKeyBehaviorsReference, getMinimalTypeReference2 as getMinimalTypeReference, getMultiFileSection, getOrbitalConnectivitySection, getOrbitalDecompositionPrompt, getOverGenerationSection, getPatternTypesCompact, getPortableOrbitalOutputSection, getRenderUIQuickRef2 as getRenderUIQuickRef, getRequirementsDecomposePrompt, getRequirementsTraitPrompt, getSExprQuickRef2 as getSExprQuickRef, getSchemaUpdateCompact, getSchemaUpdateSection, getUsesImportCompact, getUsesImportSection, getValidationHintsSection, writeAllSkills, writeSkill };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map