@mindfoldhq/trellis 0.3.10 → 0.4.0-beta.10

package/README.md

@@ -8,7 +8,7 @@
 
 <p align="center">
 <strong>A multi-platform AI coding framework that rules</strong><br/>
-<sub>Supports Claude Code, Cursor, OpenCode, iFlow, Codex, Kilo, Kiro, Gemini CLI, Antigravity, and Qoder.</sub>
+<sub>Supports Claude Code, Cursor, OpenCode, iFlow, Codex, Kilo, Kiro, Gemini CLI, Antigravity, Windsurf, Qoder, CodeBuddy, and GitHub Copilot.</sub>
 </p>
 
 <p align="center">
@@ -21,10 +21,19 @@
 
 <p align="center">
 <a href="https://www.npmjs.com/package/@mindfoldhq/trellis"><img src="https://img.shields.io/npm/v/@mindfoldhq/trellis.svg?style=flat-square&color=2563eb" alt="npm version" /></a>
+<a href="https://www.npmjs.com/package/@mindfoldhq/trellis"><img src="https://img.shields.io/npm/dw/@mindfoldhq/trellis?style=flat-square&color=cb3837&label=downloads" alt="npm downloads" /></a>
 <a href="https://github.com/mindfold-ai/Trellis/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-AGPL--3.0-16a34a.svg?style=flat-square" alt="license" /></a>
 <a href="https://github.com/mindfold-ai/Trellis/stargazers"><img src="https://img.shields.io/github/stars/mindfold-ai/Trellis?style=flat-square&color=eab308" alt="stars" /></a>
 <a href="https://docs.trytrellis.app/"><img src="https://img.shields.io/badge/docs-trytrellis.app-0f766e?style=flat-square" alt="docs" /></a>
 <a href="https://discord.com/invite/tWcCZ3aRHc"><img src="https://img.shields.io/badge/Discord-Join-5865F2?style=flat-square&logo=discord&logoColor=white" alt="Discord" /></a>
+<a href="https://github.com/mindfold-ai/Trellis/issues"><img src="https://img.shields.io/github/issues/mindfold-ai/Trellis?style=flat-square&color=e67e22" alt="open issues" /></a>
+<a href="https://github.com/mindfold-ai/Trellis/pulls"><img src="https://img.shields.io/github/issues-pr/mindfold-ai/Trellis?style=flat-square&color=9b59b6" alt="open PRs" /></a>
+<a href="https://deepwiki.com/mindfold-ai/Trellis"><img src="https://img.shields.io/badge/Ask-DeepWiki-blue?style=flat-square" alt="Ask DeepWiki" /></a>
+<a href="https://chatgpt.com/?q=Explain+the+project+mindfold-ai/Trellis+on+GitHub"><img src="https://img.shields.io/badge/Ask-ChatGPT-74aa9c?style=flat-square&logo=openai&logoColor=white" alt="Ask ChatGPT" /></a>
+</p>
+
+<p align="center">
+<img src="assets/trellis-demo.gif" alt="Trellis workflow demo" width="100%">
 </p>
 
 ## Why Trellis?
@@ -36,7 +45,12 @@
 | **Parallel agent execution** | Run multiple AI tasks side by side with git worktrees instead of turning one branch into a traffic jam. |
 | **Project memory** | Journals in `.trellis/workspace/` preserve what happened last time, so each new session starts with real context. |
 | **Team-shared standards** | Specs live in the repo, so one person’s hard-won workflow or rule can benefit the whole team. |
-| **Multi-platform setup** | Bring the same Trellis structure to 10 AI coding platforms instead of rebuilding your workflow per tool. |
+| **Multi-platform setup** | Bring the same Trellis structure to 13 AI coding platforms instead of rebuilding your workflow per tool. |
+
+## Prerequisites
+
+- **Node.js** ≥ 18
+- **Python** ≥ 3.10 (required for hooks and automation scripts)
 
 ## Quick Start
 
@@ -52,7 +66,7 @@ trellis init --cursor --opencode --codex -u your-name
 ```
 
 - `-u your-name` creates `.trellis/workspace/your-name/` for personal journals and session continuity.
-- Platform flags can be mixed and matched. Current options include `--cursor`, `--opencode`, `--iflow`, `--codex`, `--kilo`, `--kiro`, `--gemini`, `--antigravity`, and `--qoder`.
+- Platform flags can be mixed and matched. Current options include `--cursor`, `--opencode`, `--iflow`, `--codex`, `--kilo`, `--kiro`, `--gemini`, `--antigravity`, `--windsurf`, `--qoder`, `--codebuddy`, and `--copilot`.
 - For platform-specific setup, entry commands, and upgrade paths, use the docs:
   [Quick Start](https://docs.trytrellis.app/guide/ch02-quick-start) •
   [Supported Platforms](https://docs.trytrellis.app/guide/ch13-multi-platform) •
@@ -89,7 +103,7 @@ Trellis keeps the core workflow in `.trellis/` and generates the platform-specif
 └── scripts/                 # Utilities that power the workflow
 ```
 
-Depending on the platforms you enable, Trellis also creates tool-specific integration files such as `.claude/`, `.cursor/`, `AGENTS.md`, `.agents/`, `.kilocode/`, and `.kiro/`.
+Depending on the platforms you enable, Trellis also creates tool-specific integration files such as `.claude/`, `.cursor/`, `AGENTS.md`, `.agents/`, `.codex/`, `.kilocode/`, `.kiro/`, `.github/copilot/`, and `.github/hooks/`. For Codex, Trellis now installs both project skills under `.agents/skills/` and project-scoped config/custom agents under `.codex/`.
 
 At a high level, the workflow is simple:
 
@@ -129,7 +143,7 @@ Those files are useful, but they tend to become monolithic. Trellis adds structu
 <details>
 <summary><strong>Is Trellis only for Claude Code?</strong></summary>
 
-No. Trellis currently supports Claude Code, Cursor, OpenCode, iFlow, Codex, Kilo, Kiro, Gemini CLI, and Antigravity. The detailed setup and entry command for each tool lives in the supported platforms guide.
+No. Trellis currently supports Claude Code, Cursor, OpenCode, iFlow, Codex, Kilo, Kiro, Gemini CLI, Antigravity, Windsurf, Qoder, CodeBuddy, and GitHub Copilot. The detailed setup and entry command for each tool lives in the supported platforms guide.
 
 </details>
 

package/dist/cli/index.js

@@ -52,11 +52,16 @@ program
     .option("--kiro", "Include Kiro Code skills")
     .option("--gemini", "Include Gemini CLI commands")
     .option("--antigravity", "Include Antigravity workflows")
+    .option("--windsurf", "Include Windsurf workflows")
     .option("--qoder", "Include Qoder commands")
+    .option("--codebuddy", "Include CodeBuddy commands")
+    .option("--copilot", "Include GitHub Copilot hooks")
     .option("-y, --yes", "Skip prompts and use defaults")
     .option("-u, --user <name>", "Initialize developer identity with specified name")
     .option("-f, --force", "Overwrite existing files without asking")
     .option("-s, --skip-existing", "Skip existing files without asking")
+    .option("--monorepo", "Force monorepo mode")
+    .option("--no-monorepo", "Skip monorepo detection")
     .option("-t, --template <name>", "Use a remote spec template (e.g., electron-fullstack)")
     .option("--overwrite", "Overwrite existing spec directory when using template")
     .option("--append", "Only add missing files when using template")

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/init.d.ts

@@ -8,7 +8,10 @@ interface InitOptions {
     kiro?: boolean;
     gemini?: boolean;
     antigravity?: boolean;
+    windsurf?: boolean;
     qoder?: boolean;
+    codebuddy?: boolean;
+    copilot?: boolean;
     yes?: boolean;
     user?: string;
     force?: boolean;
@@ -17,6 +20,7 @@ interface InitOptions {
     overwrite?: boolean;
     append?: boolean;
     registry?: string;
+    monorepo?: boolean;
 }
 export declare function init(options: InitOptions): Promise<void>;
 export {};

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AA+TA,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAgBD,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAijB9D"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AA8XA,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA2DD,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAmtB9D"}

package/dist/commands/init.js

@@ -12,36 +12,60 @@ import { DIR_NAMES, FILE_NAMES, PATHS } from "../constants/paths.js";
 import { VERSION } from "../constants/version.js";
 import { agentsMdContent } from "../templates/markdown/index.js";
 import { setWriteMode, writeFile, } from "../utils/file-writer.js";
-import { detectProjectType, } from "../utils/project-detector.js";
+import { detectProjectType, detectMonorepo, sanitizePkgName, } from "../utils/project-detector.js";
 import { initializeHashes } from "../utils/template-hash.js";
 import { fetchTemplateIndex, probeRegistryIndex, downloadTemplateById, downloadRegistryDirect, parseRegistrySource, TIMEOUTS, TEMPLATE_INDEX_URL, } from "../utils/template-fetcher.js";
 import { setupProxy, maskProxyUrl } from "../utils/proxy.js";
 /**
- * Detect available Python command (python3 or python)
+ * Detect available Python command (python3 or python) and verify version >= 3.10
  */
 function getPythonCommand() {
-    // Try python3 first (preferred on macOS/Linux)
-    try {
-        execSync("python3 --version", { stdio: "pipe" });
+    const MIN_MAJOR = 3;
+    const MIN_MINOR = 10;
+    function checkVersion(cmd) {
+        try {
+            const output = execSync(`${cmd} --version`, { stdio: "pipe" })
+                .toString()
+                .trim();
+            const match = output.match(/Python (\d+)\.(\d+)/);
+            if (!match)
+                return false;
+            const [, major, minor] = match.map(Number);
+            return major > MIN_MAJOR || (major === MIN_MAJOR && minor >= MIN_MINOR);
+        }
+        catch {
+            return false;
+        }
+    }
+    if (checkVersion("python3"))
         return "python3";
+    if (checkVersion("python"))
+        return "python";
+    // Check if Python exists but is too old
+    try {
+        const output = execSync("python3 --version", { stdio: "pipe" })
+            .toString()
+            .trim();
+        console.warn(chalk.yellow(`⚠️  ${output} detected, but Trellis requires Python ≥ 3.10`));
     }
     catch {
-        // Fall back to python (common on Windows)
         try {
-            execSync("python --version", { stdio: "pipe" });
-            return "python";
+            const output = execSync("python --version", { stdio: "pipe" })
+                .toString()
+                .trim();
+            console.warn(chalk.yellow(`⚠️  ${output} detected, but Trellis requires Python ≥ 3.10`));
         }
         catch {
-            // Default to python3, let it fail with a clear error
-            return "python3";
+            // No Python at all
         }
     }
+    return "python3";
 }
 // =============================================================================
 // Bootstrap Task Creation
 // =============================================================================
 const BOOTSTRAP_TASK_NAME = "00-bootstrap-guidelines";
-function getBootstrapPrdContent(projectType) {
+function getBootstrapPrdContent(projectType, packages) {
     const header = `# Bootstrap: Fill Project Development Guidelines
 
 ## Purpose
@@ -49,7 +73,7 @@ function getBootstrapPrdContent(projectType) {
 Welcome to Trellis! This is your first task.
 
 AI agents use \`.trellis/spec/\` to understand YOUR project's coding conventions.
-**Empty templates = AI writes generic code that doesn't match your project style.**
+**Starting from scratch = AI writes generic code that doesn't match your project style.**
 
 Filling these guidelines is a one-time setup that pays off for every future AI session.
 
@@ -102,7 +126,7 @@ Many projects already have coding conventions documented. **Check these first**
 | File / Directory | Tool |
 |------|------|
 | \`CLAUDE.md\` / \`CLAUDE.local.md\` | Claude Code |
-| \`AGENTS.md\` | Claude Code |
+| \`AGENTS.md\` | Codex / Claude Code / agent-compatible tools |
 | \`.cursorrules\` | Cursor |
 | \`.cursor/rules/*.mdc\` | Cursor (rules directory) |
 | \`.windsurfrules\` | Windsurf |
@@ -160,7 +184,21 @@ After completing this task:
 4. Future developers (human or AI) will onboard faster
 `;
     let content = header;
-    if (projectType === "frontend") {
+    if (packages && packages.length > 0) {
+        // Monorepo: generate per-package sections
+        for (const pkg of packages) {
+            const pkgType = pkg.type === "unknown" ? "fullstack" : pkg.type;
+            const specName = sanitizePkgName(pkg.name);
+            content += `\n### Package: ${pkg.name} (\`spec/${specName}/\`)\n`;
+            if (pkgType !== "frontend") {
+                content += `\n- Backend guidelines: \`.trellis/spec/${specName}/backend/\`\n`;
+            }
+            if (pkgType !== "backend") {
+                content += `\n- Frontend guidelines: \`.trellis/spec/${specName}/frontend/\`\n`;
+            }
+        }
+    }
+    else if (projectType === "frontend") {
         content += frontendSection;
     }
     else if (projectType === "backend") {
@@ -174,11 +212,20 @@ After completing this task:
     content += footer;
     return content;
 }
-function getBootstrapTaskJson(developer, projectType) {
+function getBootstrapTaskJson(developer, projectType, packages) {
     const today = new Date().toISOString().split("T")[0];
     let subtasks;
     let relatedFiles;
-    if (projectType === "frontend") {
+    if (packages && packages.length > 0) {
+        // Monorepo: subtask per package
+        subtasks = packages.map((pkg) => ({
+            name: `Fill guidelines for ${pkg.name}`,
+            status: "pending",
+        }));
+        subtasks.push({ name: "Add code examples", status: "pending" });
+        relatedFiles = packages.map((pkg) => `.trellis/spec/${sanitizePkgName(pkg.name)}/`);
+    }
+    else if (projectType === "frontend") {
         subtasks = [
             { name: "Fill frontend guidelines", status: "pending" },
             { name: "Add code examples", status: "pending" },
@@ -224,7 +271,7 @@ function getBootstrapTaskJson(developer, projectType) {
 /**
  * Create bootstrap task for first-time setup
  */
-function createBootstrapTask(cwd, developer, projectType) {
+function createBootstrapTask(cwd, developer, projectType, packages) {
     const taskDir = path.join(cwd, PATHS.TASKS, BOOTSTRAP_TASK_NAME);
     const taskRelativePath = `${PATHS.TASKS}/${BOOTSTRAP_TASK_NAME}`;
     // Check if already exists
@@ -235,10 +282,10 @@ function createBootstrapTask(cwd, developer, projectType) {
         // Create task directory
         fs.mkdirSync(taskDir, { recursive: true });
         // Write task.json
-        const taskJson = getBootstrapTaskJson(developer, projectType);
+        const taskJson = getBootstrapTaskJson(developer, projectType, packages);
         fs.writeFileSync(path.join(taskDir, FILE_NAMES.TASK_JSON), JSON.stringify(taskJson, null, 2), "utf-8");
         // Write prd.md
-        const prdContent = getBootstrapPrdContent(projectType);
+        const prdContent = getBootstrapPrdContent(projectType, packages);
         fs.writeFileSync(path.join(taskDir, FILE_NAMES.PRD), prdContent, "utf-8");
         // Set as current task
         const currentTaskFile = path.join(cwd, PATHS.CURRENT_TASK_FILE);
@@ -250,6 +297,39 @@ function createBootstrapTask(cwd, developer, projectType) {
     }
 }
 const _cliFlagCheck = true;
+/**
+ * Write monorepo package configuration to config.yaml (non-destructive patch).
+ * Appends packages: and default_package: without disturbing existing config.
+ */
+function writeMonorepoConfig(cwd, packages) {
+    const configPath = path.join(cwd, DIR_NAMES.WORKFLOW, "config.yaml");
+    let content = "";
+    try {
+        content = fs.readFileSync(configPath, "utf-8");
+    }
+    catch {
+        // Config not created yet; will be created by createWorkflowStructure
+        return;
+    }
+    // Don't overwrite if packages: already exists (re-init case)
+    if (/^packages\s*:/m.test(content)) {
+        return;
+    }
+    const lines = ["\n# Auto-detected monorepo packages", "packages:"];
+    for (const pkg of packages) {
+        lines.push(`  ${sanitizePkgName(pkg.name)}:`);
+        lines.push(`    path: ${pkg.path}`);
+        if (pkg.isSubmodule) {
+            lines.push("    type: submodule");
+        }
+    }
+    // Use first non-submodule package as default, fallback to first package
+    const defaultPkg = packages.find((p) => !p.isSubmodule)?.name ?? packages[0]?.name;
+    if (defaultPkg) {
+        lines.push(`default_package: ${defaultPkg}`);
+    }
+    fs.writeFileSync(configPath, content.trimEnd() + "\n" + lines.join("\n") + "\n", "utf-8");
+}
 export async function init(options) {
     const cwd = process.cwd();
     // Generate ASCII art banner dynamically using FIGlet "Rebel" font
@@ -306,6 +386,131 @@ export async function init(options) {
     }
     // Detect project type (silent - no output)
     const detectedType = detectProjectType(cwd);
+    // Parse custom registry source early (needed by both monorepo + single-repo flows)
+    let registry;
+    if (options.registry) {
+        try {
+            registry = parseRegistrySource(options.registry);
+        }
+        catch (error) {
+            console.log(chalk.red(error instanceof Error ? error.message : "Invalid registry source"));
+            return;
+        }
+    }
+    // Determine template strategy from flags (needed before monorepo template downloads)
+    let templateStrategy = "skip";
+    if (options.overwrite) {
+        templateStrategy = "overwrite";
+    }
+    else if (options.append) {
+        templateStrategy = "append";
+    }
+    // ==========================================================================
+    // Monorepo Detection
+    // ==========================================================================
+    let monorepoPackages;
+    let remoteSpecPackages;
+    if (options.monorepo !== false) {
+        // options.monorepo: true = --monorepo, false = --no-monorepo, undefined = auto
+        const detected = detectMonorepo(cwd);
+        if (options.monorepo === true && !detected) {
+            console.log(chalk.red("Error: --monorepo specified but no monorepo configuration found."));
+            return;
+        }
+        if (detected && detected.length > 0) {
+            let enableMonorepo = false;
+            if (options.monorepo === true || options.yes) {
+                enableMonorepo = true;
+            }
+            else {
+                // Show detected packages and ask
+                console.log(chalk.blue("\n🔍 Detected monorepo packages:"));
+                for (const pkg of detected) {
+                    const sub = pkg.isSubmodule ? chalk.gray(" (submodule)") : "";
+                    console.log(chalk.gray(`   - ${pkg.name}`) +
+                        chalk.gray(` (${pkg.path})`) +
+                        chalk.gray(` [${pkg.type}]`) +
+                        sub);
+                }
+                console.log("");
+                const { useMonorepo } = await inquirer.prompt([
+                    {
+                        type: "confirm",
+                        name: "useMonorepo",
+                        message: "Enable monorepo mode?",
+                        default: true,
+                    },
+                ]);
+                enableMonorepo = useMonorepo;
+            }
+            if (enableMonorepo) {
+                monorepoPackages = detected;
+                remoteSpecPackages = new Set();
+                // Per-package template selection (unless -y mode: all use blank spec)
+                if (!options.yes && !options.template) {
+                    for (const pkg of detected) {
+                        const { specSource } = await inquirer.prompt([
+                            {
+                                type: "list",
+                                name: "specSource",
+                                message: `Spec source for ${pkg.name} (${pkg.path}):`,
+                                choices: [
+                                    { name: "From scratch (Trellis default)", value: "blank" },
+                                    { name: "Download remote template", value: "remote" },
+                                ],
+                                default: "blank",
+                            },
+                        ]);
+                        if (specSource === "remote") {
+                            // Use existing template download flow, targeting spec/<name>/
+                            const destDir = path.join(cwd, PATHS.SPEC, sanitizePkgName(pkg.name));
+                            console.log(chalk.blue(`📦 Select template for ${pkg.name}...`));
+                            // Fetch templates if not already done
+                            const templates = await fetchTemplateIndex();
+                            const specTemplates = templates
+                                .filter((t) => t.type === "spec")
+                                .map((t) => ({
+                                name: `${t.id} (${t.name})`,
+                                value: t.id,
+                            }));
+                            if (specTemplates.length > 0) {
+                                const { templateId } = await inquirer.prompt([
+                                    {
+                                        type: "list",
+                                        name: "templateId",
+                                        message: `Select template for ${pkg.name}:`,
+                                        choices: specTemplates,
+                                    },
+                                ]);
+                                const result = await downloadTemplateById(cwd, templateId, templateStrategy, templates.find((t) => t.id === templateId), undefined, destDir);
+                                if (result.success) {
+                                    console.log(chalk.green(`   ${result.message}`));
+                                    remoteSpecPackages.add(sanitizePkgName(pkg.name));
+                                }
+                                else {
+                                    console.log(chalk.yellow(`   ${result.message}`));
+                                    console.log(chalk.gray("   Falling back to blank spec..."));
+                                }
+                            }
+                            else {
+                                console.log(chalk.gray("   No templates available. Using blank spec."));
+                            }
+                        }
+                    }
+                }
+                else if (options.template) {
+                    // --template as default for all packages
+                    for (const pkg of detected) {
+                        const destDir = path.join(cwd, PATHS.SPEC, sanitizePkgName(pkg.name));
+                        const result = await downloadTemplateById(cwd, options.template, templateStrategy, undefined, registry, destDir);
+                        if (result.success && !result.skipped) {
+                            remoteSpecPackages.add(sanitizePkgName(pkg.name));
+                        }
+                    }
+                }
+            }
+        }
+    }
     // Tool definitions derived from platform registry
     const TOOLS = getInitToolChoices();
     // Build tools from explicit flags
@@ -342,35 +547,19 @@ export async function init(options) {
         return;
     }
     // ==========================================================================
-    // Template Selection
+    // Template Selection (single-repo only; monorepo handles templates above)
     // ==========================================================================
     let selectedTemplate = null;
-    let templateStrategy = "skip";
-    // Determine template strategy from flags
-    if (options.overwrite) {
-        templateStrategy = "overwrite";
-    }
-    else if (options.append) {
-        templateStrategy = "append";
-    }
-    // Parse custom registry source if provided
-    let registry;
-    if (options.registry) {
-        try {
-            registry = parseRegistrySource(options.registry);
-        }
-        catch (error) {
-            console.log(chalk.red(error instanceof Error ? error.message : "Invalid registry source"));
-            return;
-        }
-    }
     // Pre-fetched templates list (used to pass selected SpecTemplate to downloadTemplateById)
     let fetchedTemplates = [];
     // Determine the index URL based on registry
     const indexUrl = registry
         ? `${registry.rawBaseUrl}/index.json`
         : TEMPLATE_INDEX_URL;
-    if (options.template) {
+    if (monorepoPackages) {
+        // Monorepo: template selection already handled above
+    }
+    else if (options.template) {
         // Template specified via --template flag
         selectedTemplate = options.template;
     }
@@ -424,7 +613,7 @@ export async function init(options) {
                 ? specTemplates
                 : [
                     {
-                        name: "blank (default - empty templates)",
+                        name: "from scratch (default)",
                         value: "blank",
                     },
                     ...specTemplates,
@@ -557,7 +746,8 @@ export async function init(options) {
         }
     }
     // -y mode with --registry (no --template): probe index.json to detect mode
-    if (options.yes && registry && !selectedTemplate) {
+    // Skip when monorepo mode already handled templates above
+    if (options.yes && registry && !selectedTemplate && !monorepoPackages) {
         const probeResult = await probeRegistryIndex(`${registry.rawBaseUrl}/index.json`);
         if (probeResult.templates.length > 0) {
             // Marketplace mode requires interactive selection — can't auto-select
@@ -651,7 +841,14 @@ export async function init(options) {
         projectType,
         multiAgent: true,
         skipSpecTemplates: useRemoteTemplate,
+        packages: monorepoPackages,
+        remoteSpecPackages,
     });
+    // Write monorepo packages to config.yaml (non-destructive patch)
+    if (monorepoPackages) {
+        writeMonorepoConfig(cwd, monorepoPackages);
+        console.log(chalk.blue("📦 Monorepo packages written to config.yaml"));
+    }
     // Write version file for update tracking
     const versionPath = path.join(cwd, DIR_NAMES.WORKFLOW, ".version");
     fs.writeFileSync(versionPath, VERSION);
@@ -688,7 +885,7 @@ export async function init(options) {
                 stdio: "pipe", // Silent
             });
             // Create bootstrap task to guide user through filling guidelines
-            createBootstrapTask(cwd, developerName, projectType);
+            createBootstrapTask(cwd, developerName, projectType, monorepoPackages);
         }
         catch {
             // Silent failure - user can run init_developer.py manually