feat: initial implementation of create-software-factory CLI

Interactive CLI to scaffold and import .continue/agents/ and .continue/checks/
files from curated templates or any GitHub repo.

- Interactive create flow with checkbox selection of checks and agents
- GitHub import flow via --from owner/repo with frontmatter parsing
- 4 curated check templates: code-review, security, test-coverage, pr-description
- 3 curated agent templates: all-green, fix-issue, triage-issues
- Semantic release workflow for npm publishing

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: sestinj

.github/workflows/release.yaml

@@ -0,0 +1,41 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
+      id-token: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Verify the integrity of provenance attestations and registry signatures for installed dependencies
+        run: npm audit signatures
+
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.SEMANTIC_RELEASE_TOKEN }}
+        run: npx semantic-release

.gitignore

@@ -0,0 +1,4 @@
+node_modules/
+.env
+.env.*
+*.tgz

README.md

@@ -0,0 +1,78 @@
+# create-software-factory
+
+Scaffold and import `.continue/agents/` and `.continue/checks/` files from curated templates or any GitHub repo.
+
+## Quick Start
+
+```bash
+npx create-software-factory
+```
+
+This launches an interactive wizard that lets you pick from curated check and agent templates and writes them to your project's `.continue/` directory.
+
+## Import from GitHub
+
+Import checks and agents from any public GitHub repo:
+
+```bash
+npx create-software-factory --from continuedev/remote-config-server
+```
+
+For private repos, pass a GitHub token:
+
+```bash
+npx create-software-factory --from myorg/private-repo --token ghp_xxxxx
+```
+
+To fetch from a specific branch:
+
+```bash
+npx create-software-factory --from owner/repo --branch develop
+```
+
+## Options
+
+```
+create-software-factory [options]
+
+Options:
+  --from <repo>      Import from GitHub repo (owner/repo)
+  --token <token>    GitHub token for private repos
+  --branch <branch>  Branch to fetch from
+  --dir <path>       Target directory (default: cwd)
+  -V, --version      Output version number
+  -h, --help         Display help
+```
+
+## Included Templates
+
+### Checks
+
+Checks run automatically on pull requests:
+
+- **Code Review** — Reviews code quality, naming conventions, and patterns
+- **Security** — Scans for OWASP vulnerabilities, hardcoded secrets, and auth issues
+- **Test Coverage** — Ensures new code has appropriate test coverage
+- **PR Description** — Validates that PR descriptions cover all meaningful changes
+
+### Agents
+
+Agents are triggered by events or invoked on-demand:
+
+- **All Green** — Fix checks, resolve conflicts, address reviews, and merge the PR (triggered by `ai-merge` label)
+- **Fix Issue** — Takes a GitHub issue and creates a fix PR (manual)
+- **Triage Issues** — Auto-label and respond to new issues (triggered on issue open)
+
+## How It Works
+
+### Interactive Create
+
+Running without `--from` shows an interactive multi-select menu. You choose which checks and agents to install, and the selected template files are copied into your project's `.continue/checks/` and `.continue/agents/` directories.
+
+### GitHub Import
+
+Running with `--from owner/repo` fetches the `.continue/checks/` and `.continue/agents/` directories from the specified GitHub repository using the GitHub Contents API. It parses YAML frontmatter to show names and descriptions, lets you select which files to import, and writes them locally.
+
+## License
+
+Apache-2.0

bin/create-software-factory.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../src/index.js';

package.json

@@ -0,0 +1,56 @@
+{
+  "name": "create-software-factory",
+  "version": "0.1.0",
+  "description": "Scaffold and import .continue/agents and .continue/checks from curated templates or any GitHub repo",
+  "type": "module",
+  "bin": {
+    "create-software-factory": "./bin/create-software-factory.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "echo 'No build step needed - create-software-factory uses plain JavaScript'",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "continue",
+    "software-factory",
+    "agents",
+    "checks",
+    "cli",
+    "scaffold"
+  ],
+  "author": "Continue",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/continuedev/create-software-factory"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.1",
+    "node-fetch": "^3.3.2",
+    "@inquirer/prompts": "^7.0.0",
+    "yaml": "^2.6.0"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^11.0.3",
+    "@semantic-release/npm": "^12.0.2",
+    "@semantic-release/release-notes-generator": "^14.0.3",
+    "semantic-release": "^24.2.7"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

src/commands/create.js

@@ -0,0 +1,103 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { checkbox } from '@inquirer/prompts';
+import chalk from 'chalk';
+import { parseFrontmatter } from '../lib/frontmatter.js';
+import { writeFile } from '../lib/writer.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const TEMPLATES_DIR = path.join(__dirname, '..', 'templates');
+
+const CHECKS = [
+  { file: 'code-review.md', name: 'Code Review', description: 'Reviews code quality and patterns' },
+  { file: 'security.md', name: 'Security', description: 'Scans for OWASP vulnerabilities, hardcoded secrets' },
+  { file: 'test-coverage.md', name: 'Test Coverage', description: 'Ensures new code has tests' },
+  { file: 'pr-description.md', name: 'PR Description', description: 'Validates PR descriptions' },
+];
+
+const AGENTS = [
+  { file: 'all-green.md', name: 'All Green', description: 'Fix checks, resolve conflicts, address reviews, merge' },
+  { file: 'fix-issue.md', name: 'Fix Issue', description: 'Takes a GitHub issue and creates a fix PR' },
+  { file: 'triage-issues.md', name: 'Triage Issues', description: 'Auto-label and respond to new issues' },
+];
+
+export function createCommand(program) {
+  program
+    .command('create', { isDefault: true })
+    .description('Interactively scaffold .continue/checks and .continue/agents')
+    .option('--dir <path>', 'Target directory', process.cwd())
+    .action(async (opts) => {
+      console.log();
+      console.log(chalk.bold('  Continue Software Factory'));
+      console.log();
+
+      const categories = await checkbox({
+        message: 'What would you like to set up?',
+        choices: [
+          { name: 'Checks (run automatically on PRs)', value: 'checks', checked: true },
+          { name: 'Agents (triggered by events or on-demand)', value: 'agents', checked: true },
+        ],
+      });
+
+      if (categories.length === 0) {
+        console.log(chalk.yellow('\n  Nothing selected. Exiting.\n'));
+        return;
+      }
+
+      let selectedChecks = [];
+      let selectedAgents = [];
+
+      if (categories.includes('checks')) {
+        selectedChecks = await checkbox({
+          message: 'Select checks:',
+          choices: CHECKS.map((c) => ({
+            name: `${c.name} — ${c.description}`,
+            value: c.file,
+            checked: false,
+          })),
+        });
+      }
+
+      if (categories.includes('agents')) {
+        selectedAgents = await checkbox({
+          message: 'Select agents:',
+          choices: AGENTS.map((a) => ({
+            name: `${a.name} — ${a.description}`,
+            value: a.file,
+            checked: false,
+          })),
+        });
+      }
+
+      const total = selectedChecks.length + selectedAgents.length;
+      if (total === 0) {
+        console.log(chalk.yellow('\n  No files selected. Exiting.\n'));
+        return;
+      }
+
+      console.log();
+
+      let written = 0;
+
+      for (const file of selectedChecks) {
+        const src = path.join(TEMPLATES_DIR, 'checks', file);
+        const dest = path.join(opts.dir, '.continue', 'checks', file);
+        const content = fs.readFileSync(src, 'utf-8');
+        if (await writeFile(dest, content)) {
+          written++;
+        }
+      }
+
+      for (const file of selectedAgents) {
+        const src = path.join(TEMPLATES_DIR, 'agents', file);
+        const dest = path.join(opts.dir, '.continue', 'agents', file);
+        const content = fs.readFileSync(src, 'utf-8');
+        if (await writeFile(dest, content)) {
+          written++;
+        }
+      }
+
+      console.log(chalk.bold(`\n  Done! ${written} file${written === 1 ? '' : 's'} created.\n`));
+    });
+}

src/commands/import.js

@@ -0,0 +1,104 @@
+import path from 'node:path';
+import { checkbox } from '@inquirer/prompts';
+import chalk from 'chalk';
+import ora from 'ora';
+import { fetchDirectory, fetchFileContent } from '../lib/github.js';
+import { parseFrontmatter } from '../lib/frontmatter.js';
+import { writeFile } from '../lib/writer.js';
+
+export function importCommand(program) {
+  program
+    .command('import')
+    .description('Import .continue/checks and agents from a GitHub repo')
+    .requiredOption('--from <repo>', 'GitHub repo (owner/repo)')
+    .option('--token <token>', 'GitHub token for private repos')
+    .option('--branch <branch>', 'Branch to fetch from')
+    .option('--dir <path>', 'Target directory', process.cwd())
+    .action(async (opts) => {
+      const { from: repo, token, branch, dir } = opts;
+      const fetchOpts = { token, branch };
+
+      console.log();
+      const spinner = ora(`Fetching from ${repo}...`).start();
+
+      let checks, agents;
+      try {
+        [checks, agents] = await Promise.all([
+          fetchDirectory(repo, '.continue/checks', fetchOpts),
+          fetchDirectory(repo, '.continue/agents', fetchOpts),
+        ]);
+      } catch (err) {
+        spinner.fail(err.message);
+        process.exit(1);
+      }
+
+      spinner.succeed(`Found ${checks.length} check${checks.length === 1 ? '' : 's'}, ${agents.length} agent${agents.length === 1 ? '' : 's'}.`);
+
+      if (checks.length === 0 && agents.length === 0) {
+        console.log(chalk.yellow('\n  No .continue/checks or .continue/agents found in this repo.\n'));
+        return;
+      }
+
+      // Fetch content for all files to parse frontmatter for display names
+      const spinnerContent = ora('Loading file metadata...').start();
+
+      const allFiles = [
+        ...checks.map((f) => ({ ...f, type: 'checks' })),
+        ...agents.map((f) => ({ ...f, type: 'agents' })),
+      ];
+
+      let fileContents;
+      try {
+        fileContents = await Promise.all(
+          allFiles.map(async (f) => {
+            const content = await fetchFileContent(repo, f.path, fetchOpts);
+            const { data } = parseFrontmatter(content);
+            return {
+              name: f.name,
+              path: f.path,
+              category: f.type,
+              displayName: data.name || f.name.replace(/\.md$/, ''),
+              description: data.description || '',
+              content,
+            };
+          }),
+        );
+      } catch (err) {
+        spinnerContent.fail(err.message);
+        process.exit(1);
+      }
+
+      spinnerContent.succeed('Loaded file metadata.');
+      console.log();
+
+      const choices = fileContents.map((f) => ({
+        name: f.description
+          ? `${f.displayName} — ${f.description}`
+          : f.displayName,
+        value: f,
+        checked: false,
+      }));
+
+      const selected = await checkbox({
+        message: 'Select files to import:',
+        choices,
+      });
+
+      if (selected.length === 0) {
+        console.log(chalk.yellow('\n  No files selected. Exiting.\n'));
+        return;
+      }
+
+      console.log();
+
+      let written = 0;
+      for (const file of selected) {
+        const dest = path.join(dir, '.continue', file.category, file.name);
+        if (await writeFile(dest, file.content)) {
+          written++;
+        }
+      }
+
+      console.log(chalk.bold(`\n  Done! ${written} file${written === 1 ? '' : 's'} imported.\n`));
+    });
+}