@compilr-dev/sdk 0.7.2 → 0.7.4

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, } 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, } 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

@@ -54,6 +54,13 @@ export const ACTION_META_REGISTRY = {
         icon: 'ShieldCheck',
         description: 'Review the paper',
     },
+    // ── Business Plan project actions ──────────────────────────────────────────
+    '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,8 +351,8 @@ export const businessPlanConfig = {
         { type: 'pitch', label: 'Pitch Narrative', description: 'Investor pitch content' },
         { type: 'session-notes', label: 'Session Notes', description: 'Summary of work done' },
     ],
-    projectActions: ['session-notes'],
-    workItemActions: ['explain'],
+    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' },
         bug: { short: 'IS', full: 'Issue' },

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

@@ -106,6 +106,13 @@ export const SKILL_META_REGISTRY = {
         icon: 'Layers',
         category: 'research',
     },
+    // ── Business Plan Skills ──────────────────────────────────────────────────
+    '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, } 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, } 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

@@ -22,8 +22,14 @@ export declare const literatureReviewSkill: Skill;
 export declare const draftSectionSkill: Skill;
 export declare const peerReviewSkill: Skill;
 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 (14 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

@@ -1410,10 +1410,341 @@ After scaffolding, tell the user:
     tags: ['research', 'scaffold', 'setup'],
 });
 // =============================================================================
+// Business Plan Skills
+// =============================================================================
+export const businessVisionSkill = defineSkill({
+    name: 'business-vision',
+    description: 'Define the business identity, problem, solution, and value proposition',
+    prompt: `You are in BUSINESS VISION MODE. Help the user define and articulate their business idea.
+
+## Step 1: Assess Current State
+1. Use \`business_model_get\` with scope: "identity" to check if a model exists
+2. Report what's already defined
+
+## Step 2: Gather Core Information
+Ask in batches (only what's not already defined):
+- **Business name** and tagline
+- **Problem**: What specific pain point do your target customers experience?
+- **Solution**: How does your product/service solve this?
+- **Unique value**: Why you instead of alternatives? What's the unfair advantage?
+- **Target customer**: Who specifically are you building for?
+- **Stage**: idea, pre-seed, seed, series-a, growth, or established?
+- **Industry/sector**
+
+## Step 3: Craft the Value Proposition
+Help refine the problem-solution-uniqueValue into a compelling narrative:
+- Problem should be specific and relatable
+- Solution should directly address the problem
+- Unique value should differentiate from ALL alternatives (including doing nothing)
+
+## Step 4: Save to Model
+- \`business_model_update\` with op: "set_identity" for name, tagline, mission, stage, industry, sector
+- \`business_model_update\` with op: "set_value_proposition" for problem, solution, uniqueValue, targetCustomer
+
+## Step 5: Suggest Next Steps
+After saving, suggest:
+- "Run /market-analysis to size your market and define customer segments"
+- "Run /competitor-analysis to map the competitive landscape"
+
+## Rules
+- Interactive — ask questions, don't assume
+- Push back on vague answers ("everyone" is not a target customer)
+- A good value proposition is specific, measurable, and defensible`,
+    tags: ['business', 'planning', 'vision'],
+});
+export const marketAnalysisSkill = defineSkill({
+    name: 'market-analysis',
+    description: 'Analyze market size, trends, and customer segments',
+    prompt: `You are in MARKET ANALYSIS MODE. Help the user understand their market.
+
+## Step 1: Assess Current State
+1. Use \`business_model_get\` with scope: "overview" for context
+2. Use \`business_model_get\` with scope: "market" for existing market data
+3. Check Knowledge Base for market research sources
+
+## Step 2: Define Customer Segments
+For each segment:
+- Name and description
+- Estimated size (number of potential customers or revenue opportunity)
+- Key pain points (what problems they face)
+- Willingness to pay
+
+Save each: \`business_model_update\` with op: "segment_add", segment: { name, description, size, painPoints, willingness }
+
+## Step 3: Market Sizing
+Guide through TAM/SAM/SOM:
+- **TAM** (Total Addressable Market): If everyone who could use your product did, how big is the market?
+- **SAM** (Serviceable Addressable Market): Realistically, which portion can you reach?
+- **SOM** (Serviceable Obtainable Market): In the first 1-3 years, what share can you capture?
+
+Each should have a value (e.g., "$4.2B"), description, and source.
+Save: \`business_model_update\` with op: "set_market_size", market_size: { tam: {...}, sam: {...}, som: {...} }
+
+## Step 4: Trends and Growth
+- Identify 3-5 market trends relevant to the business
+- Estimate market growth rate
+Save: \`business_model_update\` with op: "set_market_size", market_size: { trends: [...], growthRate: "..." }
+
+## Step 5: Generate Work Items
+Create Milestone work items for:
+- "Validate segment: [name]" for each segment (priority: high)
+- "Source market data" if TAM/SAM/SOM need better sources (priority: medium)
+
+## Rules
+- Always ask for sources — investors will ask "where did you get that number?"
+- Challenge unrealistic sizing (a $100B TAM for a niche SaaS is suspicious)
+- Bottom-up sizing is more credible than top-down
+- Distinguish between potential customers and paying customers`,
+    tags: ['business', 'analysis', 'market'],
+});
+export const competitorAnalysisSkill = defineSkill({
+    name: 'competitor-analysis',
+    description: 'Map the competitive landscape — identify competitors, strengths, weaknesses, positioning',
+    prompt: `You are in COMPETITOR ANALYSIS MODE. Help the user understand their competition.
+
+## Step 1: Assess Current State
+1. Use \`business_model_get\` with scope: "competitors" for existing data
+2. Read Knowledge Base for competitor research, reports, articles
+3. Use \`business_model_get\` with scope: "identity" for context on the business
+
+## Step 2: Identify Competitors
+For each competitor (guide user to list 3-8):
+- Direct competitors (same product, same market)
+- Indirect competitors (different product, same problem)
+- Potential competitors (could enter the market)
+
+## Step 3: Analyze Each Competitor
+For each, gather:
+- **Name** and brief description
+- **Strengths** (2-4): what they do well
+- **Weaknesses** (2-4): where they fall short
+- **Market position**: leader, challenger, niche, or emerging
+- **Pricing** model/range
+- **URL** (if applicable)
+
+Save each: \`business_model_update\` with op: "competitor_add", competitor: { name, description, strengths, weaknesses, marketPosition, pricing, url }
+
+## Step 4: Define Competitive Advantages
+Based on the competitor analysis, what are YOUR advantages?
+- What do you do that no competitor does?
+- Where are the gaps in the market?
+- What would be hard for competitors to replicate?
+
+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 6: Generate Work Items
+Create work items for:
+- "Deep-dive: [competitor name]" for competitors needing more research (type: Research)
+- "Validate advantage: [advantage]" for unproven competitive claims (type: Research)
+
+## Rules
+- "We have no competitors" is always wrong — there's always an alternative (even doing nothing)
+- Be honest about competitor strengths — investors will know
+- Focus on defensible advantages, not features that can be copied
+- 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 (14 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.
  */
@@ -1432,4 +1763,10 @@ export const platformSkills = [
     draftSectionSkill,
     peerReviewSkill,
     researchScaffoldSkill,
+    businessVisionSkill,
+    marketAnalysisSkill,
+    competitorAnalysisSkill,
+    financialModelSkill,
+    pitchOutlineSkill,
+    businessReviewSkill,
 ];

package/package.json

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