@compilr-dev/sdk 0.7.7 → 0.7.9

package/dist/index.d.ts

@@ -61,7 +61,7 @@ export type { AskUserQuestion, AskUserInput, AskUserResult, AskUserHandler, AskU
 export { createPlatformTools, createProjectTools, createWorkItemTools, createDocumentTools, createPlanTools, createBacklogTools, createAnchorTools, createArtifactTools, createEpisodeTools, ProjectAnchorStore, } from './platform/index.js';
 export type { ProjectAnchorStoreConfig } from './platform/index.js';
 export { STEP_ORDER, GUIDED_STEP_CRITERIA, getNextStep, isValidTransition, getStepCriteria, formatStepDisplay, getStepNumber, } from './platform/index.js';
-export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, } from './skills/index.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, curriculumDesignSkill, lessonPlanSkill, assessmentDesignSkill, courseReviewSkill, bookOutlineSkill, characterDesignSkill, plotThreadsSkill, sceneBreakdownSkill, bookReviewSkill, } from './skills/index.js';
 export { ACTION_REGISTRY, getActionsForContext, getActionById, resolveActionPrompt, buildContextSummary, getSuggestedRole, } from './actions/index.js';
 export type { ActionContext, ActionDefinition } from './actions/index.js';
 export { PROJECT_TYPES, getProjectTypeConfig, getEnrichedProjectTypeConfig, getProjectTypesByCategory, generalConfig, softwareConfig, researchConfig, businessPlanConfig, contentConfig, techDocsConfig, courseConfig, ACTION_META_REGISTRY, SKILL_META_REGISTRY, resolveActionMeta, getSkillMeta, getAllSkillMeta, } from './project-types/index.js';

package/dist/index.js

@@ -139,7 +139,7 @@ export { STEP_ORDER, GUIDED_STEP_CRITERIA, getNextStep, isValidTransition, getSt
 // =============================================================================
 // Platform Skills (platform-specific prompt expansions)
 // =============================================================================
-export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, } from './skills/index.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, curriculumDesignSkill, lessonPlanSkill, assessmentDesignSkill, courseReviewSkill, bookOutlineSkill, characterDesignSkill, plotThreadsSkill, sceneBreakdownSkill, bookReviewSkill, } from './skills/index.js';
 // =============================================================================
 // Contextual Actions (skill invocations with context)
 // =============================================================================

package/dist/platform/sqlite/document-repository.js

@@ -120,6 +120,8 @@ export class SQLiteDocumentRepository {
             'research-model': 0,
             'business-model': 0,
             'brand-model': 0,
+            'curriculum-model': 0,
+            'book-model': 0,
         };
         for (const row of results) {
             counts[row.doc_type] = row.count;

package/dist/platform/tools/document-tools.js

@@ -18,6 +18,8 @@ const DOC_TYPE_ENUM = [
     'research-model',
     'business-model',
     'brand-model',
+    'curriculum-model',
+    'book-model',
 ];
 // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export function createDocumentTools(config) {

package/dist/platform/types.d.ts

@@ -10,7 +10,7 @@
  * - Data models: camelCase properties (output types)
  * - Input types: snake_case properties (matching CLI tool input schemas)
  */
-export type ProjectType = 'general' | 'web' | 'cli' | 'library' | 'api' | 'research' | 'business-plan' | 'content' | 'tech-docs' | 'course';
+export type ProjectType = 'general' | 'web' | 'cli' | 'library' | 'api' | 'research' | 'business-plan' | 'content' | 'tech-docs' | 'course' | 'book';
 export type ProjectStatus = 'active' | 'paused' | 'completed' | 'archived';
 export type RepoPattern = 'single' | 'two-repo';
 export type WorkflowMode = 'flexible' | 'guided';
@@ -19,7 +19,7 @@ export type WorkItemType = 'feature' | 'bug' | 'tech-debt' | 'chore';
 export type WorkItemStatus = 'backlog' | 'in_progress' | 'completed' | 'skipped';
 export type WorkItemPriority = 'critical' | 'high' | 'medium' | 'low';
 export type GuidedStep = 'plan' | 'implement' | 'test' | 'commit' | 'review';
-export type DocumentType = 'prd' | 'architecture' | 'design' | 'notes' | 'plan' | 'app-model' | 'research-model' | 'business-model' | 'brand-model';
+export type DocumentType = 'prd' | 'architecture' | 'design' | 'notes' | 'plan' | 'app-model' | 'research-model' | 'business-model' | 'brand-model' | 'curriculum-model' | 'book-model';
 export type PlanStatus = 'draft' | 'approved' | 'in_progress' | 'completed' | 'abandoned';
 export interface Project {
     id: number;

package/dist/project-types/action-meta.js

@@ -64,6 +64,17 @@ export const ACTION_META_REGISTRY = {
     'content-calendar': { id: 'content-calendar', label: 'Calendar', icon: 'Calendar', description: 'Plan content' },
     'create-content': { id: 'create-content', label: 'Create', icon: 'PenTool', description: 'Write content' },
     'content-review': { id: 'content-review', label: 'Review', icon: 'CheckCircle', description: 'Check quality' },
+    // ── Book actions ─────────────────────────────────────────────────────────
+    'book-outline': { id: 'book-outline', label: 'Outline', icon: 'BookOpen', description: 'Plan structure' },
+    'character-design': { id: 'character-design', label: 'Characters', icon: 'Users', description: 'Build cast' },
+    'plot-threads': { id: 'plot-threads', label: 'Threads', icon: 'GitBranch', description: 'Map plot lines' },
+    'scene-breakdown': { id: 'scene-breakdown', label: 'Scenes', icon: 'Layers', description: 'Detail scenes' },
+    'book-review': { id: 'book-review', label: 'Review', icon: 'CheckCircle', description: 'Structure check' },
+    // ── Course / Training actions ─────────────────────────────────────────────
+    'curriculum-design': { id: 'curriculum-design', label: 'Curriculum', icon: 'School', description: 'Define structure' },
+    'lesson-plan': { id: 'lesson-plan', label: 'Lessons', icon: 'BookOpen', description: 'Plan lessons' },
+    'assessment-design': { id: 'assessment-design', label: 'Assess', icon: 'ClipboardCheck', description: 'Create assessments' },
+    'course-review': { id: 'course-review', label: 'Review', icon: 'CheckCircle', description: 'Quality check' },
     'financial-model': { id: 'financial-model', label: 'Financials', icon: 'DollarSign', description: 'Build projections' },
     'pitch-outline': { id: 'pitch-outline', label: 'Pitch', icon: 'Rocket', description: 'Structure a pitch' },
     'business-review': { id: 'business-review', label: 'Review', icon: 'ShieldCheck', description: 'Validate the plan' },

package/dist/project-types/configs.d.ts

@@ -9,3 +9,4 @@ export declare const businessPlanConfig: ProjectTypeConfig;
 export declare const contentConfig: ProjectTypeConfig;
 export declare const techDocsConfig: ProjectTypeConfig;
 export declare const courseConfig: ProjectTypeConfig;
+export declare const bookConfig: ProjectTypeConfig;

package/dist/project-types/configs.js

@@ -577,47 +577,47 @@ export const courseConfig = {
         {
             id: 'curriculum',
             label: 'Curriculum',
-            description: 'Define learning objectives',
+            description: 'Define modules and learning objectives',
             completionCheck: 'has-document',
-            completionDocType: 'syllabus',
+            completionDocType: 'curriculum-model',
         },
         {
             id: 'lessons',
-            label: 'Lessons',
-            description: 'Create lesson content',
+            label: 'Lesson Plans',
+            description: 'Break modules into lessons',
             completionCheck: 'has-workitems',
         },
         {
-            id: 'exercises',
-            label: 'Exercises',
-            description: 'Create practice exercises',
+            id: 'content',
+            label: 'Content',
+            description: 'Write lesson materials',
             completionCheck: 'has-workitems',
         },
         {
             id: 'assessment',
             label: 'Assessment',
-            description: 'Create quizzes and tests',
+            description: 'Create exercises and quizzes',
             completionCheck: 'manual',
         },
-    ],
-    suggestedAgents: [
-        { role: 'instructor', label: 'Instructor', description: 'Course design and lesson planning' },
         {
-            role: 'content-designer',
-            label: 'Content Designer',
-            description: 'Exercise and assessment creation',
+            id: 'review',
+            label: 'Review',
+            description: 'Pedagogical quality review',
+            completionCheck: 'manual',
         },
-        { role: 'reviewer', label: 'Reviewer', description: 'Content review and quality assurance' },
+    ],
+    suggestedAgents: [
+        { role: 'instructor', label: 'Instructor', description: 'Curriculum design, sequencing, pedagogy' },
+        { role: 'content-designer', label: 'Content Designer', description: 'Lesson planning, exercises, assessments' },
+        { role: 'reviewer', label: 'Reviewer', description: 'Pedagogical quality, balance, coverage' },
     ],
     documentTemplates: [
-        { type: 'syllabus', label: 'Syllabus', description: 'Course overview and objectives' },
-        { type: 'lesson', label: 'Lesson', description: 'Lesson content' },
-        { type: 'exercise', label: 'Exercise', description: 'Practice exercise' },
-        { type: 'assessment', label: 'Assessment', description: 'Quiz or test' },
+        { type: 'curriculum-model', label: 'Curriculum', description: 'Course structure, modules, lessons, assessments' },
+        { type: 'notes', label: 'Lesson Notes', description: 'Lesson content and materials' },
         { type: 'session-notes', label: 'Session Notes', description: 'Summary of work done' },
     ],
-    projectActions: ['session-notes'],
-    workItemActions: ['explain'],
+    projectActions: ['curriculum-design', 'lesson-plan', 'assessment-design', 'course-review', 'session-notes'],
+    workItemActions: ['refine-item', 'explain'],
     workItemLabels: {
         feature: { short: 'LS', full: 'Lesson' },
         bug: { short: 'FX', full: 'Fix' },
@@ -625,34 +625,121 @@ export const courseConfig = {
         chore: { short: 'TK', full: 'Task' },
     },
     systemPromptContext: 'This is an educational project. The user is creating a course or training material. Focus on clear explanations, progressive complexity, and effective learning design.',
-    systemPromptSection: `## Project Context: Course / Training Material
+    systemPromptSection: `## Project Context: Course / Training
+
+You are assisting with an educational project. Your role is to help the user create an effective, well-structured curriculum. You are a **curriculum designer**, not a subject matter expert — the user provides domain knowledge via the Knowledge Base.
 
-You are assisting with an educational project. Your role is to help the user create an effective, well-structured learning experience.
+### Curriculum Model
+This project uses a Curriculum Model that tracks the course structure: modules (with learning objectives), lessons (typed: theory, hands-on, demo, discussion, reading), and assessments (quiz, exercise, project). Always read the model before making suggestions.
 
 ### Workflow
-1. **Curriculum Design** — Define learning objectives, prerequisites, progression
-2. **Module Structure** — Organize into modules/lessons with clear scope
-3. **Content Creation** — Write lessons with explanations, examples, visuals
-4. **Exercises** — Create practice activities, coding challenges, projects
-5. **Assessment** — Design quizzes, tests, rubrics
-6. **Review** — Pedagogical review, difficulty calibration, accessibility
+1. **Curriculum Design** — Define modules, learning objectives, prerequisites, progression
+2. **Lesson Plans** — Break modules into typed lessons with time estimates
+3. **Content** — Write lesson materials (user provides domain expertise, you help structure)
+4. **Assessment** — Design quizzes, exercises, projects linked to objectives
+5. **Review** — Check pedagogical quality, balance, coverage
 
 ### Work Items
-- **Lesson** (type: feature) — a lesson or module to create
-- **Fix** (type: bug) — corrections, confusing explanations to clarify
-- **Refactor** (type: tech-debt) — restructuring content flow or difficulty curve
-- **Task** (type: chore) — formatting, media assets, publishing
+- **Lesson** (type: feature) — a lesson to develop
+- **Fix** (type: bug) — corrections, unclear explanations
+- **Refactor** (type: tech-debt) — restructuring content flow
+- **Task** (type: chore) — formatting, media, publishing
+
+### Pedagogical Principles
+- Every module needs clear learning objectives (what can the student DO after?)
+- Balance theory and practice — at least 40% hands-on
+- Build progressively — prerequisites before advanced concepts
+- Assess what you teach — every objective should be testable
+- Vary lesson types to maintain engagement
+- Check time balance — modules should be roughly similar in length
 
-### Writing Conventions
-- Start every lesson with clear learning objectives (use Bloom's taxonomy)
-- Build knowledge progressively — prerequisites before advanced concepts
-- Include hands-on exercises for every concept taught
-- Use varied examples — abstract + concrete, simple + complex
-- Provide "check your understanding" moments before moving forward
-- Consider different learning styles (reading, doing, watching)
+### Team Agents
+- **Instructor** — curriculum design, sequencing, pedagogy
+- **Content Designer** — lesson planning, exercises, assessments
+- **Reviewer** — pedagogical quality, balance, difficulty calibration`,
+};
+// =============================================================================
+// Book
+// =============================================================================
+export const bookConfig = {
+    id: 'book',
+    label: 'Book',
+    description: 'Plan and write fiction or non-fiction books',
+    icon: 'BookOpen',
+    category: 'writing',
+    phases: [
+        {
+            id: 'outline',
+            label: 'Outline',
+            description: 'Define structure, beats, and chapters',
+            completionCheck: 'has-document',
+            completionDocType: 'book-model',
+        },
+        {
+            id: 'characters',
+            label: 'Characters',
+            description: 'Build character profiles and relationships',
+            completionCheck: 'has-workitems',
+        },
+        {
+            id: 'scenes',
+            label: 'Scenes',
+            description: 'Break chapters into scenes',
+            completionCheck: 'has-workitems',
+        },
+        { id: 'draft', label: 'Draft', description: 'Write chapter drafts', completionCheck: 'has-workitems' },
+        { id: 'review', label: 'Review', description: 'Structural review', completionCheck: 'manual' },
+    ],
+    suggestedAgents: [
+        { role: 'plotter', label: 'Plotter', description: 'Story architecture, beats, pacing, plot threads' },
+        { role: 'character-dev', label: 'Character Dev', description: 'Characters, arcs, relationships, voice' },
+        { role: 'scene-writer', label: 'Scene Writer', description: 'Scene construction, setting, POV, transitions' },
+    ],
+    documentTemplates: [
+        { type: 'book-model', label: 'Book Model', description: 'Story structure, characters, plot threads, beats' },
+        { type: 'notes', label: 'Chapter Draft', description: 'Chapter content' },
+        { type: 'session-notes', label: 'Session Notes', description: 'Summary of work done' },
+    ],
+    projectActions: ['book-outline', 'character-design', 'plot-threads', 'scene-breakdown', 'book-review', 'session-notes'],
+    workItemActions: ['refine-item', 'explain'],
+    workItemLabels: {
+        feature: { short: 'CH', full: 'Chapter' },
+        bug: { short: 'RV', full: 'Revision' },
+        'tech-debt': { short: 'RS', full: 'Research' },
+        chore: { short: 'TK', full: 'Task' },
+    },
+    systemPromptContext: 'This is a book project. The user is writing a fiction or non-fiction book. Focus on narrative structure, character development, and story pacing.',
+    systemPromptSection: `## Project Context: Book
+
+You are assisting with a book project. Your role is to help the user plan and structure their book — fiction or non-fiction. You are a **story architect**, helping with structure, not writing prose for the user.
+
+### Book Model
+This project uses a Book Model that tracks: chapters (with scenes), characters (with relationships and arcs), plot threads, themes, settings, and a beat sheet (story structure). Always read the model before making suggestions.
+
+### Workflow
+1. **Outline** — Define the book's structure using a story template (Hero's Journey, Three-Act, etc.)
+2. **Characters** — Build character profiles, arcs, and relationship maps
+3. **Plot Threads** — Define main plot and subplots, map to chapters
+4. **Scenes** — Break chapters into detailed scenes with characters, settings, and threads
+5. **Draft** — User writes chapter content (you help structure, not generate prose)
+6. **Review** — Check structural integrity: beat coverage, character arc completion, plot thread balance
+
+### Work Items
+- **Chapter** (type: feature) — a chapter to write
+- **Revision** (type: bug) — structural issues to fix
+- **Research** (type: tech-debt) — worldbuilding, reference material
+- **Task** (type: chore) — formatting, notes, organization
+
+### Storytelling Principles
+- Every scene should advance at least one plot thread
+- Characters need arcs — they should change by the end
+- Balance showing vs telling
+- Maintain consistent POV within scenes
+- Pacing: alternate tension and relief
+- Subplots should connect to the main theme
 
 ### Team Agents
-- **Instructor** — curriculum design, lesson planning, pedagogy
-- **Writer** — content creation, explanations, narratives
-- **Reviewer** — accuracy, difficulty assessment, completeness`,
+- **Plotter** — story architecture, beats, pacing, plot threads
+- **Character Dev** — characters, arcs, relationships, dialogue voice
+- **Scene Writer** — scene construction, setting, POV, transitions`,
 };

package/dist/project-types/index.d.ts

@@ -6,7 +6,7 @@
  * for all types.
  */
 export type { ProjectTypeConfig, ProjectPhase, SuggestedAgent, DocumentTemplate, ActionMeta, SkillMeta, } from './types.js';
-export { generalConfig, softwareConfig, researchConfig, businessPlanConfig, contentConfig, techDocsConfig, courseConfig, } from './configs.js';
+export { generalConfig, softwareConfig, researchConfig, businessPlanConfig, contentConfig, techDocsConfig, courseConfig, bookConfig, } from './configs.js';
 export { SKILL_META_REGISTRY, getSkillMeta, getAllSkillMeta } from './skill-meta.js';
 export { ACTION_META_REGISTRY, resolveActionMeta } from './action-meta.js';
 import type { ProjectTypeConfig } from './types.js';

package/dist/project-types/index.js

@@ -6,12 +6,12 @@
  * for all types.
  */
 // Configs
-export { generalConfig, softwareConfig, researchConfig, businessPlanConfig, contentConfig, techDocsConfig, courseConfig, } from './configs.js';
+export { generalConfig, softwareConfig, researchConfig, businessPlanConfig, contentConfig, techDocsConfig, courseConfig, bookConfig, } from './configs.js';
 // Action & Skill metadata
 export { SKILL_META_REGISTRY, getSkillMeta, getAllSkillMeta } from './skill-meta.js';
 export { ACTION_META_REGISTRY, resolveActionMeta } from './action-meta.js';
 import { resolveActionMeta } from './action-meta.js';
-import { generalConfig, softwareConfig, researchConfig, businessPlanConfig, contentConfig, techDocsConfig, courseConfig, } from './configs.js';
+import { generalConfig, softwareConfig, researchConfig, businessPlanConfig, contentConfig, techDocsConfig, courseConfig, bookConfig, } from './configs.js';
 /** All registered project types */
 export const PROJECT_TYPES = [
     softwareConfig,
@@ -21,6 +21,7 @@ export const PROJECT_TYPES = [
     contentConfig,
     techDocsConfig,
     courseConfig,
+    bookConfig,
 ];
 /** Type aliases — legacy or alternative IDs that map to a canonical config */
 const TYPE_ALIASES = {

package/dist/project-types/skill-meta.js

@@ -119,6 +119,17 @@ export const SKILL_META_REGISTRY = {
     'content-calendar': { id: 'content-calendar', label: 'Content Calendar', description: 'Plan content for a period', icon: 'Calendar', category: 'planning' },
     'create-content': { id: 'create-content', label: 'Create Content', description: 'Write copy and visual brief', icon: 'PenTool', category: 'development' },
     'content-review': { id: 'content-review', label: 'Content Review', description: 'Review for brand consistency', icon: 'CheckCircle', category: 'analysis' },
+    // ── Course / Training Skills ─────────────────────────────────────────────
+    'curriculum-design': { id: 'curriculum-design', label: 'Curriculum', description: 'Define modules and learning objectives', icon: 'School', category: 'planning' },
+    'lesson-plan': { id: 'lesson-plan', label: 'Lesson Plan', description: 'Break modules into lessons', icon: 'BookOpen', category: 'planning' },
+    'assessment-design': { id: 'assessment-design', label: 'Assessment', description: 'Create quizzes and exercises', icon: 'ClipboardCheck', category: 'planning' },
+    'course-review': { id: 'course-review', label: 'Course Review', description: 'Pedagogical quality check', icon: 'CheckCircle', category: 'analysis' },
+    // ── Book Skills ──────────────────────────────────────────────────────────
+    'book-outline': { id: 'book-outline', label: 'Book Outline', description: 'Define structure, beats, and chapters', icon: 'BookOpen', category: 'planning' },
+    'character-design': { id: 'character-design', label: 'Characters', description: 'Build character profiles and relationships', icon: 'Users', category: 'planning' },
+    'plot-threads': { id: 'plot-threads', label: 'Plot Threads', description: 'Define and track narrative threads', icon: 'GitBranch', category: 'planning' },
+    'scene-breakdown': { id: 'scene-breakdown', label: 'Scenes', description: 'Break chapters into scenes', icon: 'Layers', category: 'development' },
+    'book-review': { id: 'book-review', label: 'Book Review', description: 'Structural review of the book', icon: 'CheckCircle', category: 'analysis' },
     // ── Builtin Skills (agents library) ──────────────────────────────────────
     'code-review': {
         id: 'code-review',

package/dist/skills/book-skills.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Book Skills
+ *
+ * book-outline, character-design, plot-threads, scene-breakdown, book-review
+ */
+export declare const bookOutlineSkill: import("@compilr-dev/agents").Skill;
+export declare const characterDesignSkill: import("@compilr-dev/agents").Skill;
+export declare const plotThreadsSkill: import("@compilr-dev/agents").Skill;
+export declare const sceneBreakdownSkill: import("@compilr-dev/agents").Skill;
+export declare const bookReviewSkill: import("@compilr-dev/agents").Skill;

package/dist/skills/book-skills.js

@@ -0,0 +1,195 @@
+/**
+ * Book Skills
+ *
+ * book-outline, character-design, plot-threads, scene-breakdown, book-review
+ */
+import { defineSkill } from '@compilr-dev/agents';
+export const bookOutlineSkill = defineSkill({
+    name: 'book-outline',
+    description: 'Define book structure — beats, chapters, and story template',
+    prompt: `You are in BOOK OUTLINE MODE. Help the user structure their book.
+
+## Step 1: Book Overview
+1. Use \`book_model_get\` scope: "overview" to check existing state
+2. Ask: title, genre, mode (fiction/non-fiction), logline (one sentence), target word count
+3. Save: \`book_model_update\` op: "set_book_info"
+
+## Step 2: Choose Story Structure
+Ask which template to use (or custom):
+- **Three-Act Structure** — Setup, Confrontation, Resolution
+- **Hero's Journey** — 12 stages from Ordinary World to Return
+- **Save the Cat** — 15 beats (Opening Image to Final Image)
+- **Seven-Point** — Hook, Plot Turns, Pinch Points, Midpoint, Resolution
+- **Kishōtenketsu** — Introduction, Development, Twist, Conclusion
+- **Non-fiction: Argument** — Thesis, Evidence, Counter, Synthesis
+- **Non-fiction: Transformation** — Where You Are, Why Stuck, Framework, Apply, Where You'll Be
+- **Custom** — user defines their own beats
+
+Save beats: \`book_model_update\` op: "beat_add" for each
+
+## Step 3: Chapter Breakdown
+Map beats to chapters:
+- Each major beat gets at least one chapter
+- Suggest chapter count based on target word count
+- For each chapter: title, synopsis, which beat it fulfills
+
+Save: \`book_model_update\` op: "chapter_add" for each
+
+## Step 4: Generate Work Items
+Create one "Chapter" work item per chapter.
+
+## Rules
+- Interactive — discuss structure before committing
+- For fiction: ask about POV style (first/third, single/multiple)
+- For non-fiction: ask about the core argument or transformation
+- Beat percentages are guidelines, not rigid rules`,
+    tags: ['book', 'planning', 'structure'],
+});
+export const characterDesignSkill = defineSkill({
+    name: 'character-design',
+    description: 'Build character profiles, arcs, and relationship maps',
+    prompt: `You are in CHARACTER DESIGN MODE. Help the user build their cast.
+
+## Step 1: Read Context
+1. \`book_model_get\` scope: "characters" for existing characters
+2. \`book_model_get\` scope: "overview" for book context
+
+## Step 2: Define Characters
+For each character ask:
+- Name, role (protagonist/antagonist/supporting/minor)
+- Brief description
+- Arc: how do they change from beginning to end?
+- Key traits, motivations, flaws
+
+Save: \`book_model_update\` op: "character_add"
+
+## Step 3: Map Relationships
+For each significant relationship:
+- Who relates to whom?
+- Type: ally, rival, mentor, family, love, colleague
+- Optional label for nuance
+
+Save: \`book_model_update\` op: "character_update" with relationships
+
+## Step 4: Scene Appearances
+Ask which chapters/scenes each character appears in.
+This feeds the Character Map visualization.
+
+## Rules
+- Protagonist needs a clear arc (internal change)
+- Antagonist should have understandable motivations
+- Every character should serve the story — no passengers
+- For non-fiction: "characters" are key concepts with relationships`,
+    tags: ['book', 'characters'],
+});
+export const plotThreadsSkill = defineSkill({
+    name: 'plot-threads',
+    description: 'Define and track plot threads across chapters',
+    prompt: `You are in PLOT THREADS MODE. Map the story's narrative threads.
+
+## Step 1: Read Context
+1. \`book_model_get\` scope: "full" for complete model
+2. Review existing chapters and beats
+
+## Step 2: Define Threads
+For each plot thread:
+- Name, description
+- Type: main / subplot / background
+- Color (for timeline visualization)
+
+Save: \`book_model_update\` op: "thread_add"
+
+## Step 3: Map Threads to Chapters
+For each chapter/scene, identify which threads are active.
+Save via scene updates: \`book_model_update\` op: "scene_update" with plotThreadIds
+
+## Step 4: Balance Check
+- Are there chapters with no active threads? (dead spots)
+- Are subplots resolved before the end?
+- Does the main plot have continuous presence?
+- Do threads converge toward the climax?
+
+Report issues and suggest fixes.
+
+## Rules
+- Main plot should be active in most chapters
+- Subplots should connect to the main theme
+- Every thread started must be resolved
+- For non-fiction: threads are argument lines`,
+    tags: ['book', 'plotting'],
+});
+export const sceneBreakdownSkill = defineSkill({
+    name: 'scene-breakdown',
+    description: 'Break a chapter into detailed scenes',
+    prompt: `You are in SCENE BREAKDOWN MODE. Detail a chapter's scenes.
+
+## Step 1: Read Context
+1. \`book_model_get\` scope: "full" for model
+2. Identify target chapter
+
+## Step 2: Propose Scenes
+For each scene:
+- Title, synopsis
+- Characters present
+- Setting/location
+- Plot threads advanced
+- Themes explored
+- Estimated word count
+
+Save: \`book_model_update\` op: "scene_add"
+
+## Step 3: Scene Flow
+- Does each scene end with a hook or transition?
+- Is POV consistent within scenes?
+- Does each scene advance at least one thread?
+- Are character entrances/exits natural?
+
+## Rules
+- Every scene needs a purpose (advances plot, reveals character, or builds world)
+- Avoid scenes that only deliver information
+- Vary scene length for pacing
+- End chapters on moments of tension or decision`,
+    tags: ['book', 'scenes'],
+});
+export const bookReviewSkill = defineSkill({
+    name: 'book-review',
+    description: 'Structural review — beats, arcs, threads, pacing',
+    prompt: `You are in BOOK REVIEW MODE. Evaluate the book's structure.
+
+## Step 1: Load
+1. \`book_model_get\` scope: "full"
+2. Run \`book_model_validate\`
+
+## Step 2: Beat Coverage
+- Are all beats from the template assigned to chapters?
+- Are beats in the right order and at roughly correct percentages?
+- Flag unassigned beats.
+
+## Step 3: Character Arcs
+- Does the protagonist have a clear arc (start state → end state)?
+- Are supporting characters developed enough?
+- Are there characters who appear but serve no purpose?
+
+## Step 4: Plot Thread Balance
+- Any dead spots (chapters with no active threads)?
+- Are all threads resolved?
+- Does tension build toward the climax?
+- Are subplots properly woven into the main plot?
+
+## Step 5: Pacing
+- Chapter length distribution (are some much longer/shorter?)
+- Scene count per chapter (balance)
+- Ratio of action to reflection scenes
+
+## Step 6: Report
+- Scorecard (beats, characters, threads, pacing)
+- Strengths
+- Critical issues + recommendations
+- Create revision work items
+
+## Rules
+- Focus on structure, not prose
+- Be specific: "Chapter 4 has no active plot thread" not "pacing needs work"
+- 3-5 most impactful recommendations`,
+    tags: ['book', 'review', 'structure'],
+});

package/dist/skills/business-skills.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Business Plan Skills
+ *
+ * business-vision, market-analysis, competitor-analysis, financial-model, pitch-outline, business-review
+ */
+export declare const businessVisionSkill: import("@compilr-dev/agents").Skill;
+export declare const marketAnalysisSkill: import("@compilr-dev/agents").Skill;
+export declare const competitorAnalysisSkill: import("@compilr-dev/agents").Skill;
+export declare const financialModelSkill: import("@compilr-dev/agents").Skill;
+export declare const pitchOutlineSkill: import("@compilr-dev/agents").Skill;
+export declare const businessReviewSkill: import("@compilr-dev/agents").Skill;