create-dss-project 0.1.0

package/bin/create-dss-project.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+const { main } = require('../lib/index.js');
+main(process.argv[2]);

package/lib/index.js

@@ -0,0 +1,80 @@
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const { askQuestions } = require('./prompts');
+const { scaffold } = require('./scaffold');
+
+async function main(nameArg) {
+  console.log('\n  DS Strategy Stack\n');
+
+  const answers = await askQuestions(nameArg);
+
+  if (!answers.projectName || !answers.projectType || !answers.structure) {
+    console.log('Missing required answers. Exiting.');
+    process.exit(1);
+  }
+
+  const targetDir = path.resolve(process.cwd(), answers.projectName);
+
+  if (fs.existsSync(targetDir)) {
+    console.error(`\n  Error: Directory "${answers.projectName}" already exists.\n`);
+    process.exit(1);
+  }
+
+  // Resolve template directory — when published, it's at cli/template/
+  // When running from source, it's the repo root (parent of cli/)
+  let templateDir = path.join(__dirname, '..', 'template');
+  if (!fs.existsSync(templateDir)) {
+    templateDir = path.resolve(__dirname, '..', '..');
+  }
+
+  console.log(`\n  Creating project in ${targetDir}\n`);
+
+  const { modules } = scaffold(targetDir, templateDir, {
+    projectName: answers.projectName,
+    projectType: answers.projectType,
+    structure: answers.structure,
+  });
+
+  // Git init
+  try {
+    execSync('git init', { cwd: targetDir, stdio: 'ignore' });
+    execSync('git add -A', { cwd: targetDir, stdio: 'ignore' });
+    execSync('git commit -m "Initial project from DS Strategy Stack"', {
+      cwd: targetDir,
+      stdio: 'ignore',
+    });
+    console.log('  ✓ Git repository initialised');
+  } catch {
+    console.log('  ⚠ Could not initialise git — you can do this manually');
+  }
+
+  // Install dashboard dependencies
+  if (modules.dashboard && fs.existsSync(path.join(targetDir, 'dashboard', 'package.json'))) {
+    console.log('  ⏳ Installing dashboard dependencies...');
+    try {
+      execSync('npm install', {
+        cwd: path.join(targetDir, 'dashboard'),
+        stdio: 'ignore',
+      });
+      console.log('  ✓ Dashboard dependencies installed');
+    } catch {
+      console.log('  ⚠ Could not install dashboard deps — run "cd dashboard && npm install" manually');
+    }
+  }
+
+  console.log(`
+  ✅ Project created!
+
+  Next steps:
+
+    cd ${answers.projectName}
+    claude
+    /onboard
+
+  The /onboard skill will walk you through configuring
+  your hypothesis, scoring dimensions, and kill conditions.
+`);
+}
+
+module.exports = { main };

package/lib/project-types.js

@@ -0,0 +1,74 @@
+const PROJECT_TYPES = {
+  'market-entry': {
+    label: 'Market Entry',
+    description: 'Evaluating a new market or product opportunity',
+    discovery: true, pipeline: true, dashboard: true,
+    entityType: 'prospect',
+    scoringDimensions: ['White Space', 'Urgency', 'Feasibility', 'Defensibility', 'Revenue Potential'],
+  },
+  'growth-strategy': {
+    label: 'Growth Strategy',
+    description: 'Expanding an existing product into new channels or segments',
+    discovery: true, pipeline: true, dashboard: true,
+    entityType: 'prospect',
+    scoringDimensions: ['Growth Potential', 'CAC Efficiency', 'Retention Impact', 'Speed to Market', 'Scalability'],
+  },
+  'competitor-research': {
+    label: 'Competitor Research',
+    description: 'Competitive intelligence and landscape mapping',
+    discovery: false, pipeline: false, dashboard: true,
+    entityType: 'competitor',
+    scoringDimensions: ['Market Share', 'Product Strength', 'Pricing Power', 'Growth Trajectory', 'Threat Level'],
+  },
+  'product-launch-gtm': {
+    label: 'Product Launch / GTM',
+    description: 'Bringing a product or feature to market',
+    discovery: true, pipeline: true, dashboard: true,
+    entityType: 'prospect',
+    scoringDimensions: ['Market Readiness', 'Channel Fit', 'Competitive Timing', 'Resource Requirement', 'Revenue Impact'],
+  },
+  'internal-implementation': {
+    label: 'Internal Implementation',
+    description: 'Rolling out a new system, process, or initiative',
+    discovery: false, pipeline: true, dashboard: true,
+    entityType: 'workstream',
+    scoringDimensions: ['Business Impact', 'Technical Complexity', 'Change Readiness', 'Resource Cost', 'Timeline Risk'],
+  },
+  'vendor-partner-eval': {
+    label: 'Vendor / Partner Evaluation',
+    description: 'Selecting tools, platforms, or partners',
+    discovery: true, pipeline: true, dashboard: true,
+    entityType: 'vendor',
+    scoringDimensions: ['Capability Fit', 'Total Cost', 'Integration Effort', 'Vendor Stability', 'Lock-in Risk'],
+  },
+  'due-diligence': {
+    label: 'Due Diligence',
+    description: 'M&A, investment, or acquisition evaluation',
+    discovery: true, pipeline: true, dashboard: true,
+    entityType: 'target',
+    scoringDimensions: ['Strategic Fit', 'Financial Health', 'Integration Risk', 'Synergy Potential', 'Cultural Alignment'],
+  },
+  'business-case': {
+    label: 'Business Case',
+    description: 'Building a case for investment or strategic change',
+    discovery: false, pipeline: false, dashboard: false,
+    entityType: 'option',
+    scoringDimensions: ['ROI Potential', 'Strategic Alignment', 'Execution Risk', 'Stakeholder Support', 'Opportunity Cost'],
+  },
+  'transformation': {
+    label: 'Transformation / Change',
+    description: 'Organisational or process transformation',
+    discovery: true, pipeline: true, dashboard: true,
+    entityType: 'initiative',
+    scoringDimensions: ['Impact Scope', 'Organisational Readiness', 'Resource Requirement', 'Risk Level', 'Time to Value'],
+  },
+  'custom': {
+    label: 'Custom',
+    description: 'Something else — configure modules manually',
+    discovery: true, pipeline: true, dashboard: true,
+    entityType: 'entity',
+    scoringDimensions: ['White Space', 'Urgency', 'Feasibility', 'Defensibility', 'Revenue Potential'],
+  },
+};
+
+module.exports = { PROJECT_TYPES };

package/lib/prompts.js

@@ -0,0 +1,42 @@
+const prompts = require('prompts');
+const { PROJECT_TYPES } = require('./project-types');
+
+async function askQuestions(defaultName) {
+  const response = await prompts([
+    {
+      type: 'text',
+      name: 'projectName',
+      message: 'Project name',
+      initial: defaultName || 'my-strategy-project',
+    },
+    {
+      type: 'select',
+      name: 'projectType',
+      message: 'What type of project is this?',
+      choices: Object.entries(PROJECT_TYPES).map(([value, t]) => ({
+        title: t.label,
+        description: t.description,
+        value,
+      })),
+    },
+    {
+      type: 'select',
+      name: 'structure',
+      message: 'How much structure do you want?',
+      choices: [
+        { title: 'Full', description: 'All features: scoring, kill conditions, evidence grading, weekly reports, context snapshots', value: 'full' },
+        { title: 'Essentials', description: 'Core features: research, pipeline, decisions, dashboard', value: 'essentials' },
+        { title: 'Minimal', description: 'Bare bones: research and notes only', value: 'minimal' },
+      ],
+    },
+  ], {
+    onCancel: () => {
+      console.log('\nSetup cancelled.');
+      process.exit(0);
+    },
+  });
+
+  return response;
+}
+
+module.exports = { askQuestions };

package/lib/scaffold.js

@@ -0,0 +1,169 @@
+const fs = require('fs');
+const path = require('path');
+const { PROJECT_TYPES } = require('./project-types');
+
+const EXCLUDE_FROM_COPY = [
+  '.git',
+  'node_modules',
+  '.DS_Store',
+  'cli',
+  '.next',
+  '.claude',
+  'dashboard/data/overview.json',
+  'dashboard/data/entities.json',
+  'dashboard/data/competitors.json',
+  'dashboard/data/decisions.json',
+  'dashboard/data/scoring.json',
+  'dashboard/data/timeline.json',
+  'dashboard/data/research.json',
+  'dashboard/screenshot.png',
+  'project.config.json',
+  'CONTRIBUTING.md',
+  '.github/ISSUE_TEMPLATE',
+  '.github/pull_request_template.md',
+];
+
+function shouldExclude(relativePath) {
+  return EXCLUDE_FROM_COPY.some(ex =>
+    relativePath === ex || relativePath.startsWith(ex + '/')
+  );
+}
+
+function copyDir(src, dest, baseDir) {
+  fs.mkdirSync(dest, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    const relative = path.relative(baseDir, srcPath);
+
+    if (shouldExclude(relative)) continue;
+
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath, baseDir);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+      // Preserve executable permissions
+      const stat = fs.statSync(srcPath);
+      fs.chmodSync(destPath, stat.mode);
+    }
+  }
+}
+
+function removeIfExists(targetDir, relativePath) {
+  const full = path.join(targetDir, relativePath);
+  if (fs.existsSync(full)) {
+    fs.rmSync(full, { recursive: true, force: true });
+  }
+}
+
+function scaffold(targetDir, templateDir, options) {
+  const { projectType, structure, projectName } = options;
+  const typeConfig = PROJECT_TYPES[projectType];
+
+  // 1. Copy template
+  copyDir(templateDir, targetDir, templateDir);
+
+  // 2. Determine effective module flags
+  const modules = {
+    discovery: typeConfig.discovery,
+    pipeline: typeConfig.pipeline,
+    dashboard: typeConfig.dashboard,
+  };
+
+  const features = {
+    scoring: true,
+    killConditions: true,
+    evidenceGrading: true,
+    weeklyReports: true,
+    contextSnapshots: true,
+  };
+
+  // 3. Apply structure-level removals
+  if (structure === 'minimal') {
+    modules.discovery = false;
+    modules.pipeline = false;
+    modules.dashboard = false;
+    features.scoring = false;
+    features.killConditions = false;
+    features.evidenceGrading = false;
+    features.weeklyReports = false;
+    features.contextSnapshots = false;
+
+    removeIfExists(targetDir, 'context');
+    removeIfExists(targetDir, 'skills/compare-options');
+    removeIfExists(targetDir, 'skills/weekly-report');
+    removeIfExists(targetDir, 'skills/rebuild-snapshots');
+    removeIfExists(targetDir, 'memory/scoring.md');
+  }
+
+  if (structure === 'essentials') {
+    features.scoring = false;
+    features.killConditions = false;
+    features.evidenceGrading = false;
+
+    removeIfExists(targetDir, 'memory/scoring.md');
+    removeIfExists(targetDir, 'dashboard/scoring.html');
+    removeIfExists(targetDir, 'skills/compare-options');
+  }
+
+  // 4. Apply module-level removals
+  if (!modules.discovery) {
+    removeIfExists(targetDir, 'discovery');
+    removeIfExists(targetDir, 'memory/discovery.md');
+    removeIfExists(targetDir, 'context/pipeline-state.md');
+    removeIfExists(targetDir, 'dashboard/pipeline.html');
+    removeIfExists(targetDir, 'skills/pipeline-update');
+    removeIfExists(targetDir, 'skills/outreach-sequence');
+    removeIfExists(targetDir, 'skills/process-call');
+  }
+
+  if (!modules.pipeline && modules.discovery) {
+    // Pipeline off but discovery might still be on in custom
+    removeIfExists(targetDir, 'skills/pipeline-update');
+    removeIfExists(targetDir, 'skills/outreach-sequence');
+  }
+
+  if (!modules.dashboard) {
+    removeIfExists(targetDir, 'dashboard');
+  }
+
+  // 5. Remove template-repo-only files
+  removeIfExists(targetDir, 'project.config.example.json');
+  removeIfExists(targetDir, 'scripts/reset-to-template.sh');
+  removeIfExists(targetDir, 'scripts/validate-placeholders.sh');
+
+  // 6. Write project.config.json
+  const config = {
+    templateVersion: '1.0.0',
+    templateSource: 'github.com/DiffTheEnder/DSS-Claude-Stack',
+    projectType,
+    projectName,
+    projectSlug: projectName.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/(^-|-$)/g, ''),
+    oneLineDescription: '',
+    goal: '',
+    team: '',
+    scope: '',
+    outOfScope: '',
+    strategicHypothesis: '',
+    icpDescription: '',
+    entityType: typeConfig.entityType,
+    entityTypePlural: typeConfig.entityType + 's',
+    pipelineSourceOfTruth: 'data/entities.csv',
+    dashboardUrl: '',
+    modules,
+    features,
+    scoringDimensions: typeConfig.scoringDimensions,
+    killConditions: [],
+  };
+
+  fs.writeFileSync(
+    path.join(targetDir, 'project.config.json'),
+    JSON.stringify(config, null, 2) + '\n'
+  );
+
+  return { modules, features };
+}
+
+module.exports = { scaffold };

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "create-dss-project",
+  "version": "0.1.0",
+  "description": "Scaffold a DS Strategy Stack project for Claude Code",
+  "bin": {
+    "create-dss-project": "./bin/create-dss-project.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "template/"
+  ],
+  "scripts": {
+    "prepublishOnly": "bash ../scripts/build-cli-template.sh"
+  },
+  "keywords": [
+    "strategy",
+    "claude-code",
+    "scaffold",
+    "cli",
+    "project-template"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.7.0"
+  },
+  "dependencies": {
+    "prompts": "^2.4.2"
+  }
+}

package/template/.github/workflows/dashboard-build.yml

@@ -0,0 +1,27 @@
+name: Dashboard Build
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js 18
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18
+
+      - name: Install dependencies and build dashboard data
+        run: cd dashboard && npm install && node build-data.js
+
+      - name: Validate placeholders in built JSON
+        run: |
+          # Check only the generated dashboard JSON files for leftover placeholders
+          chmod +x scripts/validate-placeholders.sh
+          scripts/validate-placeholders.sh dashboard/data

package/template/.github/workflows/template-lint.yml

@@ -0,0 +1,71 @@
+name: Template Lint
+
+on:
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Validate SKILL.md frontmatter
+        run: |
+          # Every SKILL.md must have YAML frontmatter with 'name' and 'description' fields
+          EXIT_CODE=0
+          for skill_file in skills/*/SKILL.md; do
+            if [ ! -f "$skill_file" ]; then
+              continue
+            fi
+
+            # Check the file starts with ---
+            FIRST_LINE=$(head -n 1 "$skill_file")
+            if [ "$FIRST_LINE" != "---" ]; then
+              echo "FAIL: $skill_file — missing frontmatter (no opening ---)"
+              EXIT_CODE=1
+              continue
+            fi
+
+            # Extract frontmatter (between first and second ---)
+            FRONTMATTER=$(sed -n '2,/^---$/p' "$skill_file" | head -n -1)
+
+            # Check for 'name:' field
+            if ! echo "$FRONTMATTER" | grep -q '^name:'; then
+              echo "FAIL: $skill_file — frontmatter missing 'name' field"
+              EXIT_CODE=1
+            fi
+
+            # Check for 'description:' field
+            if ! echo "$FRONTMATTER" | grep -q '^description:'; then
+              echo "FAIL: $skill_file — frontmatter missing 'description' field"
+              EXIT_CODE=1
+            fi
+
+            if [ "$EXIT_CODE" -eq 0 ]; then
+              echo "PASS: $skill_file"
+            fi
+          done
+
+          exit $EXIT_CODE
+
+      - name: Check markdown for unclosed code blocks
+        run: |
+          # Verify all markdown files have balanced ``` fences
+          EXIT_CODE=0
+          while IFS= read -r md_file; do
+            # Count lines that start with ``` (opening or closing fence)
+            FENCE_COUNT=$(grep -c '^ *```' "$md_file" 2>/dev/null || echo 0)
+            # An odd count means an unclosed code block
+            if [ $((FENCE_COUNT % 2)) -ne 0 ]; then
+              echo "FAIL: $md_file — unclosed code block ($FENCE_COUNT fence markers, expected even)"
+              EXIT_CODE=1
+            fi
+          done < <(find . -name "*.md" -not -path "*/node_modules/*" -not -path "*/.git/*")
+
+          if [ "$EXIT_CODE" -eq 0 ]; then
+            echo "PASS: All markdown files have balanced code fences."
+          fi
+
+          exit $EXIT_CODE

package/template/CHANGELOG.md

@@ -0,0 +1,43 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.2.0] — 2026-03-26
+
+### Added
+- 6 new project types: Competitor Research, Product Launch / GTM, Internal Implementation, Vendor / Partner Evaluation, Due Diligence, Business Case, Transformation / Change
+- Alternative pipeline lifecycle for non-outreach projects (Not started → In progress → Blocked → Completed → Cancelled)
+- `projectType` field in project.config.json
+- Type-specific scoring dimensions and kill condition examples for all 10 types
+
+### Changed
+- Replaced "Corporate Strategy" with more specific types: Business Case and Transformation / Change
+- Onboarding now offers 10 project types with tailored defaults for each
+
+## [1.1.0] — 2026-03-26
+
+### Added
+- Getting Started guide for non-technical users (`docs/getting-started.md`)
+- Dashboard deployment guide (`dashboard/DEPLOY.md`)
+- Onboarding now asks about user goals (learning, real project, team coordination, exploration)
+- Onboarding now asks about experience level and feature selection (Full, Essentials, Minimal)
+- Feature toggles in `project.config.json` (scoring, kill conditions, evidence grading, weekly reports, context snapshots)
+
+### Changed
+- Simplified `/critical-reasoning` from 6 specialised lenses + leader frameworks to 4 accessible lenses (Is It True?, What Happens Next?, What Could Go Wrong?, Can It Actually Be Done?)
+- Onboarding Quick Start expanded from 5 to 7 questions (added goal and structure level)
+- Onboarding Full Setup expanded from 13 to 16 questions (added goals, experience, feature selection)
+
+## [1.0.0] — 2026-03-26
+
+### Added
+- Initial open-source release
+- 14-skill library (onboard, session-start, session-end, health-check, rebuild-snapshots, pipeline-update, outreach-sequence, process-call, enrich-entity, synthesise, critical-reasoning, decision, compare-options, weekly-report)
+- Live dashboard with 7 pages (overview, pipeline, competitors, decisions, scoring, timeline, research hub)
+- Memory layer with 5 persistent files
+- Context snapshot system (4 pre-computed snapshots)
+- 3 templates (call-prep, call-notes, entity-teardown)
+- Evidence grading system
+- Multi-agent coordination via STATUS.md
+- Vercel deployment support
+- Project template