@mind-fold/open-flow 0.1.0

package/README.md

@@ -0,0 +1,176 @@
+# open-flow
+
+AI-assisted development workflow initializer for Cursor, Claude Code and more.
+
+Based on Anthropic's [Effective Harnesses for Long-Running Agents](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents).
+
+## Why open-flow?
+
+AI coding assistants are powerful but lack continuity across sessions. open-flow adds a lightweight workflow system that gives AI "long-term memory" through structured documentation.
+
+Key outcomes:
+- **Multi-developer support**: Each developer (human or AI) has independent progress tracking
+- **Guidelines index system**: `index.md + doc.md` two-layer structure for efficient knowledge access
+- **Short commands**: Pre-defined prompts for common operations
+- **Human-in-the-loop**: AI writes code, human reviews and commits
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js >= 18.0.0
+
+### Install
+
+```bash
+npm install -g open-flow
+```
+
+### Initialize in your project
+
+```bash
+cd my-project
+open-flow init
+```
+
+You'll be prompted to select AI tools to configure:
+- Cursor
+- Claude Code
+
+### What gets created
+
+```
+your-project/
+├── .cursor/commands/          # Cursor short commands
+│   ├── init-agent.md
+│   ├── check-frontend.md
+│   ├── check-backend.md
+│   ├── record-agent-flow.md
+│   └── onboard-developer.md
+├── .claude/commands/          # Claude Code short commands
+├── workflow/
+│   ├── scripts/
+│   │   ├── init-developer.sh
+│   │   └── get-developer.sh
+│   ├── agent-progress/
+│   │   └── index.md
+│   ├── structure/
+│   │   ├── frontend/
+│   │   │   ├── index.md
+│   │   │   └── doc.md
+│   │   └── backend/
+│   │       ├── index.md
+│   │       └── doc.md
+│   ├── feature.json
+│   └── flow.md
+├── init-agent.md
+└── AGENTS.md
+```
+
+## Short Commands
+
+| Command | Purpose |
+|---------|---------|
+| `/init-agent` | Initialize AI session, read context and guidelines |
+| `/check-frontend` | Check frontend code against guidelines |
+| `/check-backend` | Check backend code against guidelines |
+| `/record-agent-flow` | Record work progress (after human commits) |
+| `/onboard-developer` | Guide new developer through setup |
+
+## Workflow
+
+### 1. Initialize Developer Identity
+
+```bash
+./workflow/scripts/init-developer.sh <your-name>
+```
+
+### 2. Start AI Session
+
+Use `/init-agent` command in your AI tool.
+
+### 3. Development
+
+1. AI reads guidelines from `workflow/structure/`
+2. AI writes code following the guidelines
+3. Human reviews and tests
+4. Human commits the code
+5. Use `/record-agent-flow` to record progress
+
+### 4. Customize Guidelines
+
+Fill in your project-specific guidelines in:
+- `workflow/structure/frontend/doc.md`
+- `workflow/structure/backend/doc.md`
+
+Update the `index.md` files with correct line numbers for quick navigation.
+
+## Key Concepts
+
+### index.md + doc.md Structure
+
+Instead of reading entire guideline documents (which can be 1000+ lines), AI:
+1. Reads the lightweight `index.md` (navigation table)
+2. Finds relevant section and line numbers
+3. Reads only the needed sections from `doc.md`
+
+This saves tokens and improves focus.
+
+### Multi-Developer Progress Tracking
+
+```
+workflow/agent-progress/
+├── index.md              # Main index
+└── {developer}/          # Per-developer directory
+    ├── index.md          # Personal index
+    └── progress-N.md     # Progress files (max 2000 lines each)
+```
+
+Each developer has independent progress files that don't conflict during collaboration.
+
+### Human-in-the-Loop
+
+AI should NOT execute `git commit`. The workflow is:
+1. AI writes code
+2. Human tests locally
+3. Human reviews code
+4. Human commits
+5. AI records progress with commit hash
+
+## Commands
+
+```bash
+open-flow init        # Initialize in current project
+open-flow update      # Update configuration (coming soon)
+open-flow --version   # Show version
+open-flow --help      # Show help
+```
+
+## Comparison with OpenSpec
+
+| Aspect | OpenSpec | open-flow |
+|--------|----------|-----------|
+| Focus | Spec-driven development | Memory-driven workflow |
+| Main feature | Change proposals & specs | Progress tracking & guidelines |
+| Collaboration | Single change flow | Multi-developer directories |
+| Guidelines | N/A | index.md + doc.md system |
+
+Both can be used together - OpenSpec for specs, open-flow for workflow.
+
+## Contributing
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Development
+npm run dev
+```
+
+## License
+
+MIT
+

package/bin/open-flow.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 = "0.1.0";
+//# 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":"AAIA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,32 @@
+import chalk from "chalk";
+import { Command } from "commander";
+import { init } from "../commands/init.js";
+export const VERSION = "0.1.0";
+const program = new Command();
+program
+    .name("open-flow")
+    .description("AI-assisted development workflow initializer for Cursor, Claude Code and more")
+    .version(VERSION);
+program
+    .command("init")
+    .description("Initialize open-flow in the current project")
+    .option("--cursor", "Include Cursor commands")
+    .option("--claude", "Include Claude Code commands")
+    .option("-y, --yes", "Skip prompts and use defaults")
+    .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 open-flow configuration and commands")
+    .action(async () => {
+    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,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACL,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CACX,+EAA+E,CAC/E;KACA,OAAO,CAAC,OAAO,CAAC,CAAC;AAEnB,OAAO;KACL,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,6CAA6C,CAAC;KAC1D,MAAM,CAAC,UAAU,EAAE,yBAAyB,CAAC;KAC7C,MAAM,CAAC,UAAU,EAAE,8BAA8B,CAAC;KAClD,MAAM,CAAC,WAAW,EAAE,+BAA+B,CAAC;KACpD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACzB,IAAI,CAAC;QACJ,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CACZ,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EACnB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC9C,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;AACF,CAAC,CAAC,CAAC;AAEJ,OAAO;KACL,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,6CAA6C,CAAC;KAC1D,MAAM,CAAC,KAAK,IAAI,EAAE;IAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,6BAA6B,CAAC,CAAC,CAAC;AAC1D,CAAC,CAAC,CAAC;AAEJ,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,8 @@
+interface InitOptions {
+    cursor?: boolean;
+    claude?: boolean;
+    yes?: 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":"AAQA,UAAU,WAAW;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AAOD,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoG9D"}

package/dist/commands/init.js

@@ -0,0 +1,202 @@
+import fs from "node:fs";
+import path from "node:path";
+import chalk from "chalk";
+import inquirer from "inquirer";
+import { configureClaude } from "../configurators/claude.js";
+import { configureCursor } from "../configurators/cursor.js";
+import { createWorkflowStructure } from "../configurators/workflow.js";
+export async function init(options) {
+    const cwd = process.cwd();
+    console.log(chalk.cyan("\n🚀 open-flow - AI-assisted development workflow initializer\n"));
+    // Check if already initialized
+    const workflowDir = path.join(cwd, "workflow");
+    if (fs.existsSync(workflowDir)) {
+        const { overwrite } = await inquirer.prompt([
+            {
+                type: "confirm",
+                name: "overwrite",
+                message: chalk.yellow("workflow/ directory already exists. Overwrite?"),
+                default: false,
+            },
+        ]);
+        if (!overwrite) {
+            console.log(chalk.gray("Initialization cancelled."));
+            return;
+        }
+    }
+    let tools;
+    if (options.yes) {
+        // Default: both Cursor and Claude
+        tools = ["cursor", "claude"];
+    }
+    else if (options.cursor || options.claude) {
+        // Use flags
+        tools = [];
+        if (options.cursor)
+            tools.push("cursor");
+        if (options.claude)
+            tools.push("claude");
+    }
+    else {
+        // Interactive mode
+        const answers = await inquirer.prompt([
+            {
+                type: "checkbox",
+                name: "tools",
+                message: "Select AI tools to configure:",
+                choices: [
+                    { name: "Cursor", value: "cursor", checked: true },
+                    { name: "Claude Code", value: "claude", checked: true },
+                ],
+            },
+        ]);
+        tools = answers.tools;
+    }
+    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(", ")}\n`));
+    // Create workflow structure
+    console.log(chalk.blue("📁 Creating workflow structure..."));
+    await createWorkflowStructure(cwd);
+    // 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);
+    }
+    // Create root files
+    await createRootFiles(cwd);
+    console.log(chalk.green("\n✅ open-flow initialized successfully!\n"));
+    // Print next steps
+    console.log(chalk.cyan("Next steps:"));
+    console.log(chalk.gray("  1. Run ") +
+        chalk.white("./workflow/scripts/init-developer.sh <your-name>") +
+        chalk.gray(" to set up your developer identity"));
+    console.log(chalk.gray("  2. Fill in ") +
+        chalk.white("workflow/structure/") +
+        chalk.gray(" with your project-specific guidelines"));
+    console.log(chalk.gray("  3. Use ") +
+        chalk.white("/init-agent") +
+        chalk.gray(" command in your AI tool to start a session\n"));
+}
+async function createRootFiles(cwd) {
+    // Create init-agent.md
+    const initAgentContent = `# AI Agent Initialization Guide
+
+> **Purpose**: Quick onboarding document for new AI Agent sessions. Read this first to understand the project and workflow.
+
+---
+
+## Quick Start (Do This First)
+
+### Step 0: Initialize Developer Identity (First Time Only)
+
+> ⚠️ **Multi-developer support**: Each developer/Agent needs to initialize their identity first
+
+\`\`\`bash
+# Check if already initialized
+./workflow/scripts/get-developer.sh
+
+# If not initialized, run:
+./workflow/scripts/init-developer.sh <your-name>
+# Example: ./workflow/scripts/init-developer.sh cursor-agent
+\`\`\`
+
+This creates:
+- \`workflow/.developer\` - Your identity file (gitignored)
+- \`workflow/agent-progress/<your-name>/\` - Your personal progress directory
+
+### Step 1: Understand Current Context
+
+\`\`\`bash
+# 0. Check your identity
+./workflow/scripts/get-developer.sh
+
+# 1. Check recent work progress (your own progress)
+DEVELOPER=$(./workflow/scripts/get-developer.sh)
+cat workflow/agent-progress/$DEVELOPER/index.md 2>/dev/null || cat workflow/agent-progress/index.md
+
+# 2. Check feature status
+cat workflow/feature.json
+
+# 3. Check git history
+git status
+git log --oneline -20
+\`\`\`
+
+### Step 2: Read Project Guidelines
+
+Based on your task, read the corresponding guidelines:
+
+\`\`\`bash
+# Frontend guidelines
+cat workflow/structure/frontend/index.md
+
+# Backend guidelines
+cat workflow/structure/backend/index.md
+\`\`\`
+
+### Step 3: Read Workflow Guide
+
+\`\`\`bash
+cat workflow/flow.md
+\`\`\`
+
+---
+
+## Development Workflow
+
+1. **Read Before Write** - Understand context before starting
+2. **Follow Standards** - Read \`workflow/structure/\` guidelines before coding
+3. **Incremental Development** - Complete one feature at a time
+4. **Record Promptly** - Update tracking files after completion
+5. **Document Limits** - Max 2000 lines per agent-progress document
+
+---
+
+## Key Rules
+
+### DO
+- Read guidelines before coding
+- Update agent-progress after each session
+- Run lint and type-check before finishing
+
+### DON'T
+- Skip reading guidelines (CRITICAL VIOLATION)
+- Let agent-progress exceed 2000 lines
+- Commit code with lint/type-check errors
+- Execute \`git commit\` - AI should not commit, human reviews and commits
+
+---
+
+**Ready to start? Follow the Quick Start section above!**
+`;
+    fs.writeFileSync(path.join(cwd, "init-agent.md"), initAgentContent);
+    // Create AGENTS.md
+    const agentsContent = `<!-- OPEN-FLOW:START -->
+# Open-Flow Instructions
+
+These instructions are for AI assistants working in this project.
+
+Always open \`@/init-agent.md\` when starting a new session to:
+- Initialize your developer identity
+- Understand current project context
+- Read relevant guidelines
+
+Use \`@/workflow/\` to learn:
+- Development workflow (\`flow.md\`)
+- Project structure guidelines (\`structure/\`)
+- Progress tracking (\`agent-progress/\`)
+
+Keep this managed block so 'open-flow update' can refresh the instructions.
+
+<!-- OPEN-FLOW:END -->
+`;
+    fs.writeFileSync(path.join(cwd, "AGENTS.md"), agentsContent);
+}
+//# 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,2 @@
+export declare function configureClaude(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":"AAIA,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAchE"}

package/dist/configurators/claude.js

@@ -0,0 +1,16 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { getCommandTemplates } from './templates.js';
+export async function configureClaude(cwd) {
+    const commandsDir = path.join(cwd, '.claude', 'commands');
+    // Create directory
+    fs.mkdirSync(commandsDir, { recursive: true });
+    // Get command templates
+    const templates = getCommandTemplates();
+    // Write each command file
+    for (const [name, content] of Object.entries(templates)) {
+        const filePath = path.join(commandsDir, `${name}.md`);
+        fs.writeFileSync(filePath, content);
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/configurators/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/configurators/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW;IAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAE1D,mBAAmB;IACnB,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,wBAAwB;IACxB,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IAExC,0BAA0B;IAC1B,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;QACtD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/configurators/cursor.d.ts

@@ -0,0 +1,2 @@
+export declare function configureCursor(cwd: string): Promise<void>;
+//# sourceMappingURL=cursor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/configurators/cursor.ts"],"names":[],"mappings":"AAIA,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAchE"}

package/dist/configurators/cursor.js

@@ -0,0 +1,16 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { getCommandTemplates } from './templates.js';
+export async function configureCursor(cwd) {
+    const commandsDir = path.join(cwd, '.cursor', 'commands');
+    // Create directory
+    fs.mkdirSync(commandsDir, { recursive: true });
+    // Get command templates
+    const templates = getCommandTemplates();
+    // Write each command file
+    for (const [name, content] of Object.entries(templates)) {
+        const filePath = path.join(commandsDir, `${name}.md`);
+        fs.writeFileSync(filePath, content);
+    }
+}
+//# sourceMappingURL=cursor.js.map

package/dist/configurators/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/configurators/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW;IAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAE1D,mBAAmB;IACnB,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,wBAAwB;IACxB,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IAExC,0BAA0B;IAC1B,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;QACtD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/configurators/templates.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Short command templates for AI assistants
+ * These are the core commands that enable AI-assisted development workflow
+ */
+export interface CommandTemplates {
+    [key: string]: string;
+}
+export declare function getCommandTemplates(): CommandTemplates;
+//# sourceMappingURL=templates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/configurators/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAQtD"}

package/dist/configurators/templates.js

@@ -0,0 +1,97 @@
+/**
+ * Short command templates for AI assistants
+ * These are the core commands that enable AI-assisted development workflow
+ */
+export function getCommandTemplates() {
+    return {
+        'init-agent': getInitAgentTemplate(),
+        'check-frontend': getCheckFrontendTemplate(),
+        'check-backend': getCheckBackendTemplate(),
+        'record-agent-flow': getRecordAgentFlowTemplate(),
+        'onboard-developer': getOnboardDeveloperTemplate(),
+    };
+}
+function getInitAgentTemplate() {
+    return `Read the project root's init-agent.md file and follow the instructions to initialize the AI session.
+
+Execute these steps:
+1. Check developer identity: \`./workflow/scripts/get-developer.sh\`
+2. If not initialized, guide the user to run: \`./workflow/scripts/init-developer.sh <name>\`
+3. Read your progress: \`workflow/agent-progress/{developer}/index.md\`
+4. Read feature status: \`workflow/feature.json\`
+5. Read relevant structure guidelines based on the task
+6. Report ready status and ask for the task
+`;
+}
+function getCheckFrontendTemplate() {
+    return `Check if the code you just wrote follows the frontend development guidelines.
+
+Execute these steps:
+1. Run \`git status\` to see modified files
+2. Read \`workflow/structure/frontend/index.md\` to find relevant guidelines
+3. Read the specific sections in \`workflow/structure/frontend/doc.md\` based on your changes
+4. Review your code against the guidelines
+5. Report any violations and fix them if found
+`;
+}
+function getCheckBackendTemplate() {
+    return `Check if the code you just wrote follows the backend development guidelines.
+
+Execute these steps:
+1. Run \`git status\` to see modified files
+2. Read \`workflow/structure/backend/index.md\` to find relevant guidelines
+3. Read the specific sections in \`workflow/structure/backend/doc.md\` based on your changes
+4. Review your code against the guidelines
+5. Report any violations and fix them if found
+`;
+}
+function getRecordAgentFlowTemplate() {
+    return `⚠️ **Prerequisite**: This command should only be used AFTER the human has tested and committed the code.
+
+**AI must NOT execute git commit** - only read history (\`git log\`, \`git status\`, \`git diff\`).
+
+---
+
+Record the committed code changes to workflow/agent-progress:
+
+1. Get developer identity: \`./workflow/scripts/get-developer.sh\`
+2. Get latest commits: \`git log --oneline -5\`
+3. Update progress file: \`workflow/agent-progress/{developer}/progress-N.md\`
+4. Update personal index: \`workflow/agent-progress/{developer}/index.md\`
+
+Record content should include:
+- Summary: One-line description
+- Main Changes: Files and descriptions
+- Git Commits: Hash and message (REQUIRED)
+- Testing: Lint/type-check status
+- Next Steps: What to do next
+`;
+}
+function getOnboardDeveloperTemplate() {
+    return `A new developer needs onboarding.
+
+Execute these steps in order:
+
+1. **Explain the workflow system** - Describe how open-flow works:
+   - \`workflow/\` directory structure
+   - Short commands available (/init-agent, /check-frontend, /check-backend, /record-agent-flow)
+   - Guidelines in \`workflow/structure/\`
+   - Progress tracking in \`workflow/agent-progress/\`
+
+2. **Initialize their identity**:
+   \`\`\`bash
+   ./workflow/scripts/init-developer.sh <developer-name>
+   \`\`\`
+
+3. **Guide them through first task**:
+   - Read \`workflow/feature.json\` to find a task
+   - Read relevant guidelines in \`workflow/structure/\`
+   - Start coding
+
+Key points to emphasize:
+- AI should NOT execute \`git commit\` - human is responsible for testing and committing
+- Each developer has their own progress directory
+- Read guidelines before coding (mandatory)
+`;
+}
+//# sourceMappingURL=templates.js.map

package/dist/configurators/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/configurators/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,YAAY,EAAE,oBAAoB,EAAE;QACpC,gBAAgB,EAAE,wBAAwB,EAAE;QAC5C,eAAe,EAAE,uBAAuB,EAAE;QAC1C,mBAAmB,EAAE,0BAA0B,EAAE;QACjD,mBAAmB,EAAE,2BAA2B,EAAE;KACnD,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB;IAC3B,OAAO;;;;;;;;;CASR,CAAC;AACF,CAAC;AAED,SAAS,wBAAwB;IAC/B,OAAO;;;;;;;;CAQR,CAAC;AACF,CAAC;AAED,SAAS,uBAAuB;IAC9B,OAAO;;;;;;;;CAQR,CAAC;AACF,CAAC;AAED,SAAS,0BAA0B;IACjC,OAAO;;;;;;;;;;;;;;;;;;;CAmBR,CAAC;AACF,CAAC;AAED,SAAS,2BAA2B;IAClC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;CAwBR,CAAC;AACF,CAAC"}

package/dist/configurators/workflow.d.ts

@@ -0,0 +1,2 @@
+export declare function createWorkflowStructure(cwd: string): Promise<void>;
+//# sourceMappingURL=workflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/configurators/workflow.ts"],"names":[],"mappings":"AAGA,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCxE"}