@compilr-dev/sdk 0.7.3 → 0.7.5

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, } 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, } 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, } 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, } from './skills/index.js';
 // =============================================================================
 // Contextual Actions (skill invocations with context)
 // =============================================================================

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

@@ -58,6 +58,9 @@ export const ACTION_META_REGISTRY = {
     'business-vision': { id: 'business-vision', label: 'Vision', icon: 'Target', description: 'Define your business' },
     'market-analysis': { id: 'market-analysis', label: 'Market', icon: 'TrendingUp', description: 'Analyze the market' },
     'competitor-analysis': { id: 'competitor-analysis', label: 'Competitors', icon: 'Swords', description: 'Map competition' },
+    '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' },
     // ── Work item actions ────────────────────────────────────────────────────
     build: {
         id: 'build',

package/dist/project-types/configs.js

@@ -351,7 +351,7 @@ export const businessPlanConfig = {
         { type: 'pitch', label: 'Pitch Narrative', description: 'Investor pitch content' },
         { type: 'session-notes', label: 'Session Notes', description: 'Summary of work done' },
     ],
-    projectActions: ['business-vision', 'market-analysis', 'competitor-analysis', 'session-notes'],
+    projectActions: ['business-vision', 'market-analysis', 'competitor-analysis', 'financial-model', 'pitch-outline', 'business-review', 'session-notes'],
     workItemActions: ['refine-item', 'explain'],
     workItemLabels: {
         feature: { short: 'ML', full: 'Milestone' },

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

@@ -110,6 +110,9 @@ export const SKILL_META_REGISTRY = {
     'business-vision': { id: 'business-vision', label: 'Business Vision', description: 'Define business identity and value proposition', icon: 'Target', category: 'planning' },
     'market-analysis': { id: 'market-analysis', label: 'Market Analysis', description: 'Analyze market size, trends, and segments', icon: 'TrendingUp', category: 'analysis' },
     'competitor-analysis': { id: 'competitor-analysis', label: 'Competitor Analysis', description: 'Map competitive landscape', icon: 'Swords', category: 'analysis' },
+    'financial-model': { id: 'financial-model', label: 'Financial Model', description: 'Build revenue and cost projections', icon: 'DollarSign', category: 'analysis' },
+    'pitch-outline': { id: 'pitch-outline', label: 'Pitch Outline', description: 'Structure an investor pitch', icon: 'Rocket', category: 'planning' },
+    'business-review': { id: 'business-review', label: 'Business Review', description: 'Validate the business plan', icon: 'ShieldCheck', category: 'analysis' },
     // ── Builtin Skills (agents library) ──────────────────────────────────────
     'code-review': {
         id: 'code-review',

package/dist/skills/index.d.ts

@@ -1,4 +1,4 @@
 /**
  * Platform Skills — barrel export
  */
-export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, } from './platform-skills.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, } from './platform-skills.js';

package/dist/skills/index.js

@@ -1,4 +1,4 @@
 /**
  * Platform Skills — barrel export
  */
-export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, } from './platform-skills.js';
+export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, } from './platform-skills.js';

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

@@ -25,8 +25,11 @@ export declare const researchScaffoldSkill: Skill;
 export declare const businessVisionSkill: Skill;
 export declare const marketAnalysisSkill: Skill;
 export declare const competitorAnalysisSkill: Skill;
+export declare const financialModelSkill: Skill;
+export declare const pitchOutlineSkill: Skill;
+export declare const businessReviewSkill: Skill;
 /**
- * All platform-specific skills (17 total).
+ * All platform-specific skills (20 total).
  * These skills reference platform tools (backlog, workitems, documents, projects)
  * and belong in the SDK rather than in generic agent/coding libraries.
  */

package/dist/skills/platform-skills.js

@@ -1532,11 +1532,18 @@ Based on the competitor analysis, what are YOUR advantages?
 
 Save: \`business_model_update\` with op: "set_competitive_advantages", advantages: [...]
 
-## Step 5: Positioning
-Help the user think about positioning:
-- On what axes do competitors differentiate? (price vs. features, simplicity vs. power, etc.)
-- Where does your business sit on those axes?
-- Is there an unoccupied position?
+## Step 5: Positioning Matrix
+Help the user define a 2D positioning matrix:
+- Ask: "What are the two most important dimensions in your market?" (e.g., price vs. features, simplicity vs. power, general vs. specialized)
+- Define axes with labels
+- Score each competitor (0-100) on both axes
+- Score the user's business position
+
+Save positioning: \`business_model_update\` op: "set_positioning", positioning: { xAxis: "Domain Specialization", yAxis: "Multi-Agent Capability", xLow: "General", xHigh: "Specialized", yLow: "Single", yHigh: "Multi-Agent", selfX: 85, selfY: 90 }
+
+Then update each competitor with position: \`business_model_update\` op: "competitor_update", competitor_id: "...", updates: { positionX: 30, positionY: 70 }
+
+This generates a visual positioning chart in the Business Model Viewer.
 
 ## Step 6: Generate Work Items
 Create work items for:
@@ -1550,11 +1557,201 @@ Create work items for:
 - Include both current competitors and potential future entrants`,
     tags: ['business', 'analysis', 'competition'],
 });
+export const financialModelSkill = defineSkill({
+    name: 'financial-model',
+    description: 'Build revenue forecasts, cost structure, and break-even analysis',
+    prompt: `You are in FINANCIAL MODEL MODE. Help the user build financial projections.
+
+## Step 1: Assess Current State
+1. Use \`business_model_get\` with scope: "financials" for existing projections
+2. Use \`business_model_get\` with scope: "canvas" for revenue streams and cost structure
+3. Use \`business_model_get\` with scope: "overview" for business context
+
+## Step 2: Define Revenue Streams
+For each revenue stream (if not already defined):
+- Name, type (subscription, one-time, usage, etc.)
+- Projected revenue
+Save: \`business_model_update\` op: "revenue_stream_add"
+
+## Step 3: Build Revenue Forecasts
+For each revenue stream, guide through assumptions:
+- Number of customers per period
+- Average revenue per customer
+- Growth rate
+- Seasonality or ramp-up time
+
+Save forecasts: \`business_model_update\` op: "forecast_add", financials_field: { type: "revenue", period, category, amount }
+
+Use realistic time horizons:
+- Startup: monthly for Year 1, quarterly for Years 2-3
+- Growth stage: quarterly for 3 years
+- Established: yearly for 5 years
+
+## Step 4: Define Cost Structure
+Guide through expense categories:
+- **Fixed costs**: salaries, rent, subscriptions, insurance
+- **Variable costs**: hosting, transaction fees, marketing spend (scales with revenue)
+
+Save each: \`business_model_update\` op: "cost_item_add"
+Save forecasts: \`business_model_update\` op: "forecast_add", financials_field: { type: "expense", period, category, amount }
+
+## Step 5: Break-Even Analysis
+Calculate:
+- Monthly burn rate (total fixed + variable costs)
+- Monthly revenue at steady state
+- Break-even point (when cumulative revenue > cumulative costs)
+
+Save: \`business_model_update\` op: "set_financials_fields", financials_field: { breakEvenPoint: "Month 18", fundingNeeds: "$2M", useOfFunds: "70% product, 20% marketing, 10% ops" }
+
+## Step 6: Document Assumptions
+List all key assumptions made:
+- Customer acquisition rate
+- Churn rate
+- Pricing changes
+- Hiring timeline
+
+Save: \`business_model_update\` op: "set_financials_fields", financials_field: { assumptions: [...] }
+
+## Rules
+- Always state assumptions explicitly — hidden assumptions kill credibility
+- Use conservative estimates (investors multiply your timeline by 2x)
+- Revenue should be bottoms-up (customers × price), not top-down (% of TAM)
+- Include a "what if" scenario: what happens if growth is 50% slower?
+- Round to meaningful numbers — $1.2M not $1,237,849`,
+    tags: ['business', 'analysis', 'financial'],
+});
+export const pitchOutlineSkill = defineSkill({
+    name: 'pitch-outline',
+    description: 'Structure an investor pitch or executive summary from the Business Model',
+    prompt: `You are in PITCH OUTLINE MODE. Help the user create a compelling pitch from their Business Model.
+
+## Step 1: Assess Readiness
+1. Use \`business_model_get\` with scope: "full" to review the complete model
+2. Check completeness: identity, value prop, market, competitors, financials
+3. If major gaps exist, note them and suggest which skills to run first
+
+## Step 2: Choose Format
+Ask the user:
+- **Elevator pitch** (30 seconds — 3 sentences)
+- **Executive summary** (1 page — for email/document)
+- **Pitch deck narrative** (10-12 slides — investor presentation)
+
+## Step 3: Structure the Pitch
+For a pitch deck (adapt for other formats):
+
+1. **Problem** — The pain point (from valueProposition.problem)
+2. **Solution** — Your approach (from valueProposition.solution)
+3. **Market** — Size and opportunity (from market TAM/SAM/SOM)
+4. **Product** — What you've built / will build
+5. **Business Model** — How you make money (from canvas.revenueStreams)
+6. **Traction** — What you've achieved so far (milestones, users, revenue)
+7. **Competition** — Why you win (from competitors + competitiveAdvantages)
+8. **Team** — Why this team (from team)
+9. **Financials** — Projections and key metrics (from financials)
+10. **The Ask** — What you need (from financials.fundingNeeds + useOfFunds)
+
+## Step 4: Draft the Narrative
+For each section:
+- Write 2-3 sentences that tell a story
+- Lead with the strongest point
+- Use specific numbers, not vague claims
+- Save as a project document
+
+## Step 5: Generate Work Items
+Create Milestone work items:
+- "Draft: [section name]" for each pitch section
+- "Prepare: supporting data" for claims that need evidence
+
+## Rules
+- The pitch tells a STORY, not a list of facts
+- Start with emotion (the problem), end with opportunity (the ask)
+- Every claim should be backed by data from the Business Model
+- If financials are weak, lead with market size and traction instead
+- The ask should be specific: "$X for Y months to achieve Z"`,
+    tags: ['business', 'writing', 'pitch'],
+});
+export const businessReviewSkill = defineSkill({
+    name: 'business-review',
+    description: 'Validate the business plan — find gaps, weak assumptions, and missing elements',
+    prompt: `You are in BUSINESS REVIEW MODE. Critically evaluate the business plan like an investor would.
+
+## Step 1: Load and Assess
+1. Use \`business_model_get\` with scope: "full" to read everything
+2. Run \`business_model_validate\` for structural issues
+
+## Step 2: Completeness Check
+Score each section (Complete / Partial / Missing):
+- Identity & Value Proposition
+- Market Analysis (TAM/SAM/SOM, segments)
+- Competitive Analysis (competitors, advantages)
+- Business Model Canvas (revenue, costs, channels, partnerships)
+- Financial Projections (revenue, expenses, break-even)
+- Go-to-Market (phases, strategy)
+- Team
+
+Present a scorecard: "7/7 complete" or "5/7 — missing Financials and GTM"
+
+## Step 3: Assumption Audit
+For each key assumption:
+- Is it stated explicitly?
+- Is there evidence supporting it?
+- What happens if it's wrong?
+
+Flag assumptions that are:
+- **Optimistic** — "We'll capture 10% of the market in Year 1" (unlikely for most startups)
+- **Unvalidated** — claims without data or customer evidence
+- **Risky** — single points of failure
+
+## Step 4: Competitive Blind Spots
+- Are there competitors missing from the analysis?
+- Are competitive advantages truly defensible?
+- What would a well-funded competitor do to beat you?
+- Is the pricing competitive given the alternatives?
+
+## Step 5: Financial Reality Check
+- Do revenue projections match the market sizing? (can't project $100M revenue in a $50M SAM)
+- Is the cost structure realistic? (engineering salaries, cloud costs, marketing spend)
+- Is the break-even timeline achievable with the stated funding?
+- What's the burn rate, and how long does the funding last?
+
+## Step 6: Generate Review Report
+Structure as:
+
+### Scorecard
+Section-by-section completeness
+
+### Strengths (what's compelling)
+2-3 strongest elements
+
+### Critical Issues (must fix)
+Problems that would stop an investor
+
+### Major Issues (should fix)
+Significant weaknesses
+
+### Recommendations
+Prioritized action items
+
+Write report to a project document.
+
+## Step 7: Create Work Items
+- Type "Issue" (bug) for critical and major issues
+- Type "Research" (tech-debt) for unvalidated assumptions
+- Type "Milestone" (feature) for missing sections
+
+## Rules
+- Be constructive but honest — sugar-coating helps nobody
+- Think like an investor: "Would I put money into this?"
+- Every issue should have a specific recommendation
+- Acknowledge what's strong — it builds credibility for the critique
+- Focus on the 3-5 things that matter most, not a list of 20 nitpicks`,
+    tags: ['business', 'review', 'validation'],
+});
 // =============================================================================
 // Aggregate export
 // =============================================================================
 /**
- * All platform-specific skills (17 total).
+ * All platform-specific skills (20 total).
  * These skills reference platform tools (backlog, workitems, documents, projects)
  * and belong in the SDK rather than in generic agent/coding libraries.
  */
@@ -1576,4 +1773,7 @@ export const platformSkills = [
     businessVisionSkill,
     marketAnalysisSkill,
     competitorAnalysisSkill,
+    financialModelSkill,
+    pitchOutlineSkill,
+    businessReviewSkill,
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.7.3",
+  "version": "0.7.5",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",