@mindfoldhq/trellis 0.1.0

package/LICENSE

@@ -0,0 +1,110 @@
+# Functional Source License, Version 1.1, MIT Future License
+
+## Abbreviation
+
+FSL-1.1-MIT
+
+## Notice
+
+Copyright 2026 Mindfold LLC
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the MIT License that is effective on the second anniversary of the date we make
+the Software available. On or after that date, you may use the Software under
+the MIT License, in which case the following will apply:
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,149 @@
+# Trellis
+
+English | [中文](./README-zh.md)
+
+AI capabilities grow like ivy — full of vitality but climbing in all directions. Trellis provides the structure to guide them along a disciplined path.
+
+Based on Anthropic's [Effective Harnesses for Long-Running Agents](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents), with engineering practices and improvements for real-world usage.
+
+## Installation
+
+```bash
+npm install -g @mindfoldhq/trellis    # or pnpm/yarn
+```
+
+## Quick Start
+
+```bash
+# Initialize in your project
+trellis init
+# or use short alias
+tl init
+
+# Initialize with developer name
+trellis init -u your-name
+
+# Initialize for specific tools only
+trellis init --cursor          # Cursor only
+trellis init --claude          # Claude Code only
+trellis init --cursor --claude # Both (default)
+```
+
+## What It Does
+
+Trellis creates a structured workflow system in your project:
+
+```
+your-project/
+├── .trellis/
+│   ├── .developer                 # Developer identity (gitignored)
+│   ├── workflow.md                    # Workflow guide
+│   ├── agent-traces/            # Session tracking
+│   │   └── {developer}/           # Per-developer progress
+│   │       ├── index.md           # Progress index
+│   │       ├── features/          # Feature tracking
+│   │       │   ├── {day}-{name}/  # Feature directory
+│   │       │   │   └── feature.json
+│   │       │   └── archive/       # Completed features
+│   │       └── progress-N.md      # Session records
+│   ├── structure/                 # Development guidelines
+│   │   ├── frontend/              # Frontend standards
+│   │   ├── backend/               # Backend standards
+│   │   └── guides/                # Thinking guides
+│   └── scripts/                   # Utility scripts
+│       ├── common/                # Shared utilities
+│       │   ├── paths.sh           # Path utilities
+│       │   ├── developer.sh       # Developer management
+│       │   └── git-context.sh     # Git context
+│       ├── feature.sh             # Feature management
+│       ├── add-session.sh         # Record sessions
+│       ├── get-context.sh         # Get session context
+│       ├── get-developer.sh       # Get developer name
+│       └── init-developer.sh      # Initialize developer
+├── .cursor/commands/              # Cursor slash commands
+├── .claude/commands/              # Claude Code slash commands
+├── init-agent.md                  # AI onboarding guide
+└── AGENTS.md                      # Agent instructions
+```
+
+## Key Features
+
+### 1. Multi-Developer Support
+
+Each developer (human or AI) gets their own progress tracking:
+
+```bash
+./.trellis/scripts/init-developer.sh <name>
+```
+
+### 2. Slash Commands
+
+Pre-built commands for AI assistants:
+
+| Command | Purpose |
+|---------|---------|
+| `/init-agent` | Initialize AI session with context |
+| `/before-frontend-dev` | Read frontend guidelines before coding |
+| `/before-backend-dev` | Read backend guidelines before coding |
+| `/check-frontend` | Validate frontend code against guidelines |
+| `/check-backend` | Validate backend code against guidelines |
+| `/check-cross-layer` | Verify cross-layer consistency |
+| `/finish-work` | Pre-commit checklist |
+| `/record-agent-flow` | Record session progress |
+| `/break-loop` | Deep bug analysis |
+| `/onboard-developer` | Full workflow onboarding |
+
+### 3. Thinking Guides
+
+Structured guides to prevent common mistakes:
+
+- Cross-layer thinking guide
+- Code reuse thinking guide
+- Pre-implementation checklist
+
+### 4. Feature Tracking
+
+Track features with directory-based structure:
+
+```bash
+./.trellis/scripts/feature.sh create my-feature  # Create feature
+./.trellis/scripts/feature.sh list               # List active features
+./.trellis/scripts/feature.sh archive my-feature # Archive completed
+```
+
+## CLI Commands
+
+```bash
+trellis init              # Initialize workflow
+trellis init -u <name>    # Initialize with developer name
+trellis init -y           # Skip prompts, use defaults
+trellis init -f           # Force overwrite existing files
+trellis init -s           # Skip existing files
+```
+
+## How It Works
+
+1. **AI reads `init-agent.md`** at session start
+2. **Follows guidelines** in `.trellis/structure/`
+3. **Updates progress** in `.trellis/agent-traces/`
+4. **Uses slash commands** for common tasks
+
+This creates a structured, documented workflow where:
+- AI agents maintain context across sessions
+- Work is tracked and auditable
+- Code quality standards are enforced
+- Multiple agents can collaborate
+
+## Acknowledgments
+
+Trellis is built upon ideas and inspirations from:
+
+- [Anthropic](https://www.anthropic.com/) - For the foundational research on [Effective Harnesses for Long-Running Agents](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents)
+- [OpenSkills](https://github.com/numman-ali/openskills) - For pioneering the skills system that extends Claude's capabilities
+- [Exa](https://exa.ai/) - For the powerful web search and code context capabilities that significantly enhance AI agent performance
+
+## License
+
+FSL-1.1-MIT (Functional Source License, MIT future license)
+
+Copyright © Mindfold LLC

package/bin/trellis.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import("../dist/cli/index.js");

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION: string;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,OAAO,EAAE,MAA4B,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,42 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import chalk from "chalk";
+import { Command } from "commander";
+import { init } from "../commands/init.js";
+// Read version from package.json
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const packageJsonPath = path.resolve(__dirname, "../../package.json");
+const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+export const VERSION = packageJson.version;
+const program = new Command();
+program
+    .name("trellis")
+    .description("AI-assisted development workflow framework for Cursor, Claude Code and more")
+    .version(VERSION, "-v, --version", "output the version number");
+program
+    .command("init")
+    .description("Initialize trellis in the current project")
+    .option("--cursor", "Include Cursor commands")
+    .option("--claude", "Include Claude Code commands")
+    .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")
+    .action(async (options) => {
+    try {
+        await init(options);
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+program
+    .command("update")
+    .description("Update trellis configuration and commands")
+    .action(() => {
+    console.log(chalk.yellow("Coming soon: update command"));
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAM3C,iCAAiC;AACjC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;AACtE,MAAM,WAAW,GAAgB,IAAI,CAAC,KAAK,CACzC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAC1C,CAAC;AACF,MAAM,CAAC,MAAM,OAAO,GAAW,WAAW,CAAC,OAAO,CAAC;AAEnD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CACV,6EAA6E,CAC9E;KACA,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,2BAA2B,CAAC,CAAC;AAElE,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,2CAA2C,CAAC;KACxD,MAAM,CAAC,UAAU,EAAE,yBAAyB,CAAC;KAC7C,MAAM,CAAC,UAAU,EAAE,8BAA8B,CAAC;KAClD,MAAM,CAAC,WAAW,EAAE,+BAA+B,CAAC;KACpD,MAAM,CACL,mBAAmB,EACnB,mDAAmD,CACpD;KACA,MAAM,CAAC,aAAa,EAAE,yCAAyC,CAAC;KAChE,MAAM,CAAC,qBAAqB,EAAE,oCAAoC,CAAC;KACnE,MAAM,CAAC,KAAK,EAAE,OAAgC,EAAE,EAAE;IACjD,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EACnB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC/C,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,2CAA2C,CAAC;KACxD,MAAM,CAAC,GAAG,EAAE;IACX,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,6BAA6B,CAAC,CAAC,CAAC;AAC3D,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,11 @@
+interface InitOptions {
+    cursor?: boolean;
+    claude?: boolean;
+    yes?: boolean;
+    user?: string;
+    force?: boolean;
+    skipExisting?: boolean;
+}
+export declare function init(options: InitOptions): Promise<void>;
+export {};
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AA8BA,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAMD,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgQ9D"}

package/dist/commands/init.js

@@ -0,0 +1,236 @@
+import { execSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import readline from "node:readline";
+import chalk from "chalk";
+import figlet from "figlet";
+import inquirer from "inquirer";
+import { configureClaude, configureClaudeAgents, configureClaudeHooks, } from "../configurators/claude.js";
+import { configureCursor } from "../configurators/cursor.js";
+import { createWorkflowStructure } from "../configurators/workflow.js";
+import { PATHS } from "../constants/paths.js";
+import { agentsMdContent, initAgentContent, } from "../templates/markdown/index.js";
+import { setWriteMode, writeFile, } from "../utils/file-writer.js";
+import { detectProjectType, getProjectTypeDescription, } from "../utils/project-detector.js";
+export async function init(options) {
+    const cwd = process.cwd();
+    // Generate ASCII art banner dynamically using FIGlet "Rebel" font
+    const banner = figlet.textSync("Trellis", { font: "Rebel" });
+    console.log(chalk.cyan(`\n${banner.trimEnd()}`));
+    console.log(chalk.gray("\n  AI-assisted development workflow framework\n"));
+    // Set write mode based on options
+    let writeMode = "ask";
+    if (options.force) {
+        writeMode = "force";
+        console.log(chalk.gray("Mode: Force overwrite existing files\n"));
+    }
+    else if (options.skipExisting) {
+        writeMode = "skip";
+        console.log(chalk.gray("Mode: Skip existing files\n"));
+    }
+    setWriteMode(writeMode);
+    // Detect developer name from git config or options
+    let developerName = options.user;
+    if (!developerName) {
+        // Only detect from git if current directory is a git repo
+        const isGitRepo = fs.existsSync(path.join(cwd, ".git"));
+        if (isGitRepo) {
+            try {
+                developerName = execSync("git config user.name", {
+                    cwd,
+                    encoding: "utf-8",
+                }).trim();
+            }
+            catch {
+                // Git not available or no user.name configured
+            }
+        }
+    }
+    if (developerName) {
+        console.log(chalk.blue("👤 Developer:"), chalk.gray(developerName));
+    }
+    else if (!options.yes) {
+        // Ask for developer name if not detected and not in yes mode
+        console.log(chalk.gray("\nTrellis supports team collaboration - each developer has their own\n" +
+            `progress directory (${PATHS.PROGRESS}/{name}/) to track AI sessions.\n` +
+            "Tip: Usually this is your git username (git config user.name).\n"));
+        developerName = await askInput("Your name: ");
+        while (!developerName) {
+            console.log(chalk.yellow("Name is required"));
+            developerName = await askInput("Your name: ");
+        }
+        console.log(chalk.blue("👤 Developer:"), chalk.gray(developerName));
+    }
+    // Detect project type
+    const detectedType = detectProjectType(cwd);
+    console.log(chalk.blue("🔍 Project type:"), chalk.gray(getProjectTypeDescription(detectedType)));
+    let tools;
+    let projectType = detectedType;
+    if (options.yes) {
+        // Default: both Cursor and Claude
+        tools = ["cursor", "claude"];
+        // Treat unknown as fullstack
+        if (detectedType === "unknown") {
+            projectType = "fullstack";
+        }
+    }
+    else if (options.cursor || options.claude) {
+        // Use flags
+        tools = [];
+        if (options.cursor) {
+            tools.push("cursor");
+        }
+        if (options.claude) {
+            tools.push("claude");
+        }
+        // Treat unknown as fullstack
+        if (detectedType === "unknown") {
+            projectType = "fullstack";
+        }
+    }
+    else {
+        // Interactive mode
+        const questions = [
+            {
+                type: "checkbox",
+                name: "tools",
+                message: "Select AI tools to configure:",
+                choices: [
+                    { name: "Cursor", value: "cursor", checked: true },
+                    { name: "Claude Code", value: "claude", checked: true },
+                ],
+            },
+        ];
+        const answers = await inquirer.prompt(questions);
+        tools = answers.tools;
+        // Treat unknown as fullstack
+        if (detectedType === "unknown") {
+            projectType = "fullstack";
+        }
+    }
+    // Auto-enable agents when Claude is selected
+    const enableAgents = tools.includes("claude");
+    if (tools.length === 0) {
+        console.log(chalk.yellow("No tools selected. At least one tool is required."));
+        return;
+    }
+    console.log(chalk.gray(`\nConfiguring: ${tools.join(", ")}`));
+    console.log(chalk.gray(`Project type: ${getProjectTypeDescription(projectType)}\n`));
+    // Create workflow structure with project type
+    console.log(chalk.blue("📁 Creating workflow structure..."));
+    await createWorkflowStructure(cwd, { projectType });
+    // Configure selected tools
+    if (tools.includes("cursor")) {
+        console.log(chalk.blue("📝 Configuring Cursor commands..."));
+        await configureCursor(cwd);
+    }
+    if (tools.includes("claude")) {
+        console.log(chalk.blue("📝 Configuring Claude Code commands..."));
+        await configureClaude(cwd);
+        // Configure Multi-Agent Pipeline if enabled
+        if (enableAgents) {
+            console.log(chalk.blue("🤖 Configuring Multi-Agent Pipeline..."));
+            console.log(chalk.gray("   - Creating agent configurations..."));
+            await configureClaudeAgents(cwd);
+            console.log(chalk.gray("   - Creating hook configurations..."));
+            await configureClaudeHooks(cwd);
+        }
+    }
+    // Create root files (skip if exists)
+    await createRootFiles(cwd);
+    // Initialize developer identity (developerName already detected at the start)
+    let developerInitialized = false;
+    let bootstrapCreated = false;
+    if (developerName) {
+        try {
+            const scriptPath = path.join(cwd, PATHS.SCRIPTS, "init-developer.sh");
+            execSync(`bash "${scriptPath}" "${developerName}"`, {
+                cwd,
+                stdio: "inherit",
+            });
+            developerInitialized = true;
+            // Create bootstrap feature to guide user through filling guidelines
+            const bootstrapScriptPath = path.join(cwd, PATHS.SCRIPTS, "create-bootstrap.sh");
+            execSync(`bash "${bootstrapScriptPath}" "${projectType}"`, {
+                cwd,
+                stdio: "pipe", // Silent - we handle output in init
+            });
+            bootstrapCreated = true;
+        }
+        catch (error) {
+            console.log(chalk.yellow(`⚠️  Failed to initialize developer: ${error instanceof Error ? error.message : error}`));
+        }
+    }
+    console.log(chalk.green("\n✅ Trellis initialized successfully!\n"));
+    // Print next steps
+    console.log(chalk.cyan("Next steps:"));
+    let stepNum = 1;
+    if (!developerInitialized) {
+        console.log(chalk.gray(`${stepNum}. Run `) +
+            chalk.white(`./${PATHS.SCRIPTS}/init-developer.sh <your-name>`) +
+            chalk.gray(" to set up your developer identity"));
+        stepNum++;
+        console.log(chalk.gray(`${stepNum}. Fill in `) +
+            chalk.white(`${PATHS.STRUCTURE}/`) +
+            chalk.gray(" with your project-specific guidelines"));
+        stepNum++;
+    }
+    else if (bootstrapCreated) {
+        console.log(chalk.gray(`${stepNum}. Use `) +
+            chalk.white("/start") +
+            chalk.gray(" command in your AI tool to begin a session"));
+        stepNum++;
+        console.log(chalk.gray(`${stepNum}. Ask AI to help you `) +
+            chalk.white("fill in project guidelines") +
+            chalk.gray(` in ${PATHS.STRUCTURE}/\n`));
+    }
+    else {
+        console.log(chalk.gray(`${stepNum}. Use `) +
+            chalk.white("/start") +
+            chalk.gray(" command in your AI tool to begin a session\n"));
+    }
+    // Print structure info
+    console.log(chalk.cyan("Generated structure files:"));
+    console.log(chalk.gray(`  ${PATHS.STRUCTURE}/guides/   - Thinking guides (filled)`));
+    if (projectType === "frontend" ||
+        projectType === "fullstack" ||
+        projectType === "unknown") {
+        console.log(chalk.gray(`  ${PATHS.STRUCTURE}/frontend/ - Frontend guidelines (to fill)`));
+    }
+    if (projectType === "backend" ||
+        projectType === "fullstack" ||
+        projectType === "unknown") {
+        console.log(chalk.gray(`  ${PATHS.STRUCTURE}/backend/  - Backend guidelines (to fill)`));
+    }
+    console.log("");
+}
+/**
+ * Simple readline-based input (no flickering like inquirer)
+ */
+function askInput(prompt) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+async function createRootFiles(cwd) {
+    const initAgentPath = path.join(cwd, "init-agent.md");
+    const agentsPath = path.join(cwd, "AGENTS.md");
+    // Write init-agent.md from template
+    const initAgentWritten = await writeFile(initAgentPath, initAgentContent);
+    if (initAgentWritten) {
+        console.log(chalk.blue("📄 Created init-agent.md"));
+    }
+    // Write AGENTS.md from template
+    const agentsWritten = await writeFile(agentsPath, agentsMdContent);
+    if (agentsWritten) {
+        console.log(chalk.blue("📄 Created AGENTS.md"));
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/configurators/claude.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Configure Claude Code with slash commands
+ *
+ * Claude Code gets the full set of commands including Claude-specific
+ * features like skill integration.
+ */
+export declare function configureClaude(cwd: string): Promise<void>;
+/**
+ * Configure Claude Code agents for Multi-Agent Pipeline
+ *
+ * Agents are specialized subagents that work together:
+ * - implement: Code implementation expert
+ * - check: Code and cross-layer check expert
+ * - debug: Issue fixing expert
+ * - research: Search expert
+ * - dispatch: Pipeline dispatcher
+ */
+export declare function configureClaudeAgents(cwd: string): Promise<void>;
+/**
+ * Configure Claude Code hooks for context injection
+ *
+ * Hooks automatically inject context into subagent prompts
+ * based on the current feature configuration.
+ */
+export declare function configureClaudeHooks(cwd: string): Promise<void>;
+/**
+ * Configure Claude Code with full Multi-Agent Pipeline support
+ *
+ * This includes:
+ * - Slash commands
+ * - Agent configurations
+ * - Hook configurations
+ */
+export declare function configureClaudeFull(cwd: string): Promise<void>;
+//# sourceMappingURL=claude.d.ts.map

package/dist/configurators/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/configurators/claude.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAehE;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CActE;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBrE;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpE"}