@mind-fold/open-flow 0.2.16 → 0.2.19

package/README.md

@@ -1,183 +1,106 @@
 # open-flow
 
-AI-assisted development workflow initializer for Cursor, Claude Code and more.
+AI-assisted development workflow system 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
+Give your AI coding assistant "long-term memory" through structured progress tracking and project-specific guidelines.
 
-### Prerequisites
-
-- Node.js >= 18.0.0
+Based on Anthropic's [Effective Harnesses for Long-Running Agents](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents).
 
-### Install
+## Install
 
 ```bash
-npm install -g open-flow
+npm install -g @mind-fold/open-flow
 ```
 
-### Initialize in your project
+## Initialize
 
 ```bash
-cd my-project
-open-flow init
+cd your-project
+
+# Initialize workflow system
+of init
+# or: open-flow init
+
+# Set your developer identity (use your git name)
+of init -u your-git-name
+# or: open-flow init -u your-git-name
 ```
 
 You'll be prompted to select AI tools to configure:
 - Cursor
 - Claude Code
 
-### What gets created
+## Learn the Workflow
 
-```
-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
+After initialization, open your AI IDE (Cursor or Claude Code) and run:
 
-| Command | Purpose |
-|---------|---------|
-| `/init-agent` | Initialize AI session, read context and guidelines |
-| `/before-frontend-dev` | Read frontend guidelines before starting development |
-| `/before-backend-dev` | Read backend guidelines before starting development |
-| `/check-frontend` | Check frontend code against guidelines |
-| `/check-backend` | Check backend code against guidelines |
-| `/record-agent-flow` | Record work progress (after human commits) |
-| `/record-question` | Document a solved problem for future reference |
-| `/onboard-developer` | Guide new developer through setup |
-| `/update-frontend-structure` | Update frontend guidelines if new patterns found |
-| `/update-backend-structure` | Update backend guidelines if new patterns found |
-| `/create-command` | Create a new slash command in both `.cursor/` and `.claude/` directories |
-
-## Workflow
-
-### 1. Initialize Developer Identity
-
-```bash
-./workflow/scripts/init-developer.sh <your-name>
+```
+/onboard-developer
 ```
 
-### 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`
-
-**Requirements**:
-- Write all documentation in **English**
-- Add section markers: `@@@section:kebab-case-id` and `@@@/section:kebab-case-id`
-- Update `index.md` files with section IDs 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 with section IDs)
-2. Finds relevant section ID for the task
-3. Extracts only the needed section: `sed -n '/@@@section:ID/,/@@@\/section:ID/p' doc.md`
+The AI will explain in detail:
+- **Core Philosophy**: Why this workflow exists, what problems it solves
+- **System Structure**: What each directory does
+- **Command Deep Dive**: Each command's purpose, mechanism, and importance
+- **Real-World Examples**: 5 complete workflow scenarios with step-by-step explanations
 
-Section markers (`@@@section:id`) ensure references don't break when content is added or removed.
+## Quick Reference
 
-This saves tokens and improves focus.
+### Core Workflow Commands
 
-### Multi-Developer Progress Tracking
+| Command | When to Use |
+|---------|-------------|
+| `/init-agent` | Start of every session |
+| `/before-frontend-dev` | Before writing frontend code |
+| `/before-backend-dev` | Before writing backend code |
+| `/check-frontend` | After writing frontend code |
+| `/check-backend` | After writing backend code |
+| `/check-cross-layer` | After changes spanning multiple layers |
+| `/finish-work` | Before human commits |
+| `/record-agent-flow` | After human commits |
+| `/break-loop` | End debugging/investigation |
 
-```
-workflow/agent-progress/
-├── index.md              # Main index
-└── {developer}/          # Per-developer directory
-    ├── index.md          # Personal index
-    └── progress-N.md     # Progress files (max 2000 lines each)
-```
+### Customization Commands
 
-Each developer has independent progress files that don't conflict during collaboration.
+| Command | Purpose |
+|---------|---------|
+| `/generate-frontend-structure` | Auto-scan project and generate frontend guidelines |
+| `/generate-backend-structure` | Auto-scan project and generate backend guidelines |
+| `/extract-to-rules` | Extract knowledge from docs into guidelines |
 
-### Human-in-the-Loop
+### Utility Commands
 
-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
+| Command | Purpose |
+|---------|---------|
+| `/onboard-developer` | Learn the complete workflow system |
+| `/create-command` | Create new slash command |
+| `/record-question` | Document solved problems |
 
-## Commands
+## CLI 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
-```
+of init              # Initialize in current project
+of init -u <name>    # Initialize with developer identity
+of --version         # Show version
+of --help            # Show help
 
-## Comparison with OpenSpec
+# 'open-flow' works the same as 'of'
+open-flow init
+open-flow init -u <name>
+```
 
-| 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 |
+## Key Principles
 
-Both can be used together - OpenSpec for specs, open-flow for workflow.
+1. **AI Never Commits** - AI prepares code, human tests and commits
+2. **Guidelines Before Code** - Read project conventions before writing
+3. **Check After Code** - Verify against guidelines before commit
+4. **Record Everything** - Persist session context for future sessions
 
 ## Contributing
 
 ```bash
-# Install dependencies
 npm install
-
-# Build
 npm run build
-
-# Development
 npm run dev
 ```
 

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

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

package/dist/cli/index.js

@@ -4,6 +4,7 @@ import { fileURLToPath } from "node:url";
 import chalk from "chalk";
 import { Command } from "commander";
 import { init } from "../commands/init.js";
+import { dashboard } from "../commands/dashboard.js";
 // Read version from package.json
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const packageJsonPath = path.resolve(__dirname, "../../package.json");
@@ -38,5 +39,19 @@ program
     .action(async () => {
     console.log(chalk.yellow("Coming soon: update command"));
 });
+program
+    .command("dashboard")
+    .alias("db")
+    .description("Open the TUI dashboard to view feature status")
+    .option("-p, --path <path>", "Path to the workflow directory")
+    .action(async (options) => {
+    try {
+        await dashboard(options);
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -1 +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;AAE3C,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,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;AAE3C,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,EAAE,eAAe,EAAE,2BAA2B,CAAC,CAAC;AAEjE,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,CACN,mBAAmB,EACnB,mDAAmD,CACnD;KACA,MAAM,CAAC,aAAa,EAAE,yCAAyC,CAAC;KAChE,MAAM,CAAC,qBAAqB,EAAE,oCAAoC,CAAC;KACnE,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/dashboard.d.ts

@@ -0,0 +1,6 @@
+interface DashboardOptions {
+    path?: string;
+}
+export declare function dashboard(options: DashboardOptions): Promise<void>;
+export {};
+//# sourceMappingURL=dashboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/commands/dashboard.ts"],"names":[],"mappings":"AAIA,UAAU,gBAAgB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxE"}

package/dist/commands/dashboard.js

@@ -0,0 +1,9 @@
+import React from "react";
+import { render } from "ink";
+import { AgentDashboard } from "../tui/components/AgentDashboard.js";
+export async function dashboard(options) {
+    const workflowPath = options.path || process.cwd();
+    const { waitUntilExit } = render(React.createElement(AgentDashboard, { workflowPath }));
+    await waitUntilExit();
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/commands/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/commands/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAMrE,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAyB;IACvD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEnD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAC9B,KAAK,CAAC,aAAa,CAAC,cAAc,EAAE,EAAE,YAAY,EAAE,CAAC,CACtD,CAAC;IAEF,MAAM,aAAa,EAAE,CAAC;AACxB,CAAC"}

package/dist/templates/commands/onboard-developer.txt

@@ -4,7 +4,7 @@ YOUR ROLE: Be a mentor and teacher. Don't just list steps - EXPLAIN the underlyi
 
 ## CRITICAL INSTRUCTION - YOU MUST COMPLETE ALL SECTIONS
 
-This onboarding has TWO equally important parts:
+This onboarding has THREE equally important parts:
 
 **PART 1: Core Concepts** (Sections: CORE PHILOSOPHY, SYSTEM STRUCTURE, COMMAND DEEP DIVE)
 - Explain WHY this workflow exists
@@ -17,9 +17,18 @@ This onboarding has TWO equally important parts:
   - WHAT HAPPENS: What the command actually does
   - IF SKIPPED: What goes wrong without it
 
-DO NOT skip Part 2. The examples are NOT optional - they are the most important part for understanding how the workflow works in practice. A developer cannot truly understand the system without seeing real workflow examples.
+**PART 3: Customize Your Development Guidelines** (Section: CUSTOMIZE YOUR DEVELOPMENT GUIDELINES)
+- Check if project guidelines are still default templates
+- If default, guide the developer to customize them
+- Show feature.json structure for systematic customization
+- Explain the customization workflow
 
-After completing BOTH parts, ask the developer about their first task.
+DO NOT skip any part. All three parts are essential:
+- Part 1 teaches the concepts
+- Part 2 shows how concepts work in practice
+- Part 3 ensures the project has proper guidelines for AI to follow
+
+After completing ALL THREE parts, ask the developer about their first task.
 
 ---
 
@@ -533,8 +542,211 @@ Debugging and investigation can spiral - AI keeps trying things without concludi
 
 ---
 
-After explaining, ask the developer:
-1. What kind of work will they be doing? (frontend/backend/full-stack)
-2. Do they have a specific task to start with?
+# PART 3: Customize Your Development Guidelines
+
+After explaining Part 1 and Part 2, check if the project's development guidelines need customization.
+
+## Step 1: Check Current Guidelines Status
+
+Check if `workflow/structure/` contains default templates or customized guidelines:
+
+```bash
+# Check if files are still templates (look for placeholder text)
+grep -l "TODO" workflow/structure/backend/*.md 2>/dev/null | head -5
+grep -l "your project" workflow/structure/frontend/*.md 2>/dev/null | head -5
+
+# Also check the project's actual tech stack
+cat package.json 2>/dev/null | head -30
+ls -la src/ 2>/dev/null || ls -la apps/ 2>/dev/null
+```
+
+## Step 2: Explain Guidelines Status (Adjust Tone Based on Situation)
+
+**Situation A: First time using open-flow in this project**
+
+If this appears to be a new open-flow setup (guidelines are default templates), explain warmly:
+
+"I see that the development guidelines in `workflow/structure/` are still the default templates that come with open-flow. This is completely normal if you've just set up the workflow system!
+
+The default templates use generic examples (React, TypeScript, Drizzle ORM, etc.) that may not match your actual tech stack. To make `/before-*-dev` commands truly useful, you'll want to customize these guidelines with YOUR project's patterns.
+
+This is a great opportunity - let's set up a task to customize your guidelines. I'll show you how to use **feature.json** for complex tasks like this."
+
+**Situation B: Existing open-flow setup, new team member**
+
+If guidelines appear customized (project-specific examples found), explain:
+
+"Great news! Your team has already customized the development guidelines. You can start using `/before-*-dev` commands right away to learn your project's conventions.
+
+I recommend reading through `workflow/structure/` to familiarize yourself with the team's coding standards."
+
+## Step 3: Create Feature for Guidelines Customization (If Needed)
+
+If guidelines need customization, DO THIS IN THE CURRENT SESSION:
+
+**First, explain the concept of feature.json**:
+
+"For complex tasks with multiple subtasks, we use **feature.json** to track progress. This is important because:
+- Complex tasks often span multiple AI sessions
+- Each session has limited context
+- feature.json persists the task breakdown across sessions
+- Future sessions can read feature.json to continue where you left off
+
+Let me create one for you now, and this will also teach you how to create feature.json for your own complex tasks in the future."
+
+**Then create the feature**:
+
+```bash
+./workflow/scripts/feature.sh create customize-guidelines
+```
+
+**Now fill in the feature.json based on the project's actual tech stack**:
+
+Analyze the project's tech stack and create appropriate subtasks. Example for a typical project:
+
+```json
+{
+  "name": "customize-guidelines",
+  "description": "Customize development guidelines to match this project's actual tech stack and patterns",
+  "created": "[current-date]",
+  "status": "in-progress",
+  "subtasks": [
+    {
+      "id": "analyze-tech-stack",
+      "title": "Analyze Project Tech Stack",
+      "description": "Identify frameworks, libraries, and patterns used in this project",
+      "status": "completed",
+      "notes": "Analyzed in onboard session: [list findings]"
+    },
+    {
+      "id": "backend-database",
+      "title": "Backend: Database Guidelines",
+      "description": "Analyze database patterns and rewrite workflow/structure/backend/database-guidelines.md",
+      "status": "pending"
+    },
+    {
+      "id": "backend-directory",
+      "title": "Backend: Directory Structure",
+      "description": "Document backend directory organization in workflow/structure/backend/directory-structure.md",
+      "status": "pending"
+    },
+    {
+      "id": "backend-error-handling",
+      "title": "Backend: Error Handling",
+      "description": "Document error handling patterns in workflow/structure/backend/error-handling.md",
+      "status": "pending"
+    },
+    {
+      "id": "frontend-components",
+      "title": "Frontend: Component Guidelines",
+      "description": "Analyze component patterns and rewrite workflow/structure/frontend/component-guidelines.md",
+      "status": "pending"
+    },
+    {
+      "id": "frontend-state",
+      "title": "Frontend: State Management",
+      "description": "Document state management approach in workflow/structure/frontend/state-management.md",
+      "status": "pending"
+    },
+    {
+      "id": "frontend-directory",
+      "title": "Frontend: Directory Structure",
+      "description": "Document frontend directory organization in workflow/structure/frontend/directory-structure.md",
+      "status": "pending"
+    }
+  ]
+}
+```
+
+**Adapt subtasks based on actual tech stack**:
+- If no database -> remove database subtask
+- If no React -> change component guidelines to vanilla JS patterns
+- If Rust backend -> change to Rust-specific guidelines
+- Add project-specific subtasks as needed
+
+## Step 4: Teach User How to Use Feature.json for Future Tasks
+
+Explain to the developer:
+
+"Now you've seen how feature.json works. In the future, when you have complex tasks, you can create your own feature.json by telling AI:
+
+**How to ask AI to create a feature.json**:
+
+> 'I need to [describe complex task]. This seems like a multi-session task. Can you help me:
+> 1. Create a feature with `./workflow/scripts/feature.sh create [feature-name]`
+> 2. Break it down into subtasks in feature.json
+> 3. Mark the first subtask as in-progress'
+
+**When to use feature.json**:
+- Task has 3+ distinct steps
+- Task might span multiple sessions
+- Task has dependencies between steps
+- You want to track progress systematically
+
+**Feature.json lifecycle**:
+1. Create feature -> feature.json created with subtasks
+2. Work on subtasks -> update status in feature.json
+3. Human commits -> git commit the changes
+4. Record session -> /record-agent-flow captures progress
+5. New session -> AI reads feature.json, continues from where you left off
+6. Complete all subtasks -> archive feature"
+
+## Step 5: Complete This Session
+
+Guide the developer to complete the onboard session properly:
+
+"Let's wrap up this onboard session:
+
+1. **Review the feature.json** I created - does it capture the right subtasks for your project?
+
+2. **Commit the feature.json**:
+   ```bash
+   git add workflow/features/customize-guidelines/feature.json
+   git commit -m 'feat(workflow): add customize-guidelines feature'
+   ```
+
+3. **Record this session**:
+   Use `/record-agent-flow` to record what we did in this onboard session.
+
+4. **Start customization in a new session**:
+   - Open a new conversation window
+   - Run `/init-agent` - AI will see the customize-guidelines feature
+   - AI will read feature.json and ask which subtask to work on
+   - Work through subtasks one by one"
+
+## Step 6: Show Example of Continuing in Next Session
+
+"In your next session, after `/init-agent`, you can say:
+
+> 'I want to continue the customize-guidelines feature. Let's work on the backend-database subtask. Please:
+> 1. Analyze my project's database code
+> 2. Identify the ORM, query patterns, transaction handling
+> 3. Rewrite workflow/structure/backend/database-guidelines.md with examples from MY codebase'
+
+The AI will read the feature.json, understand the context, and help you complete that subtask."
+
+## Customization Commands Reference
+
+These commands can help with guidelines customization:
+
+| Command | Purpose |
+|---------|---------|
+| `/generate-frontend-structure` | Auto-scan project and generate frontend guidelines |
+| `/generate-backend-structure` | Auto-scan project and generate backend guidelines |
+| `/extract-to-rules` | Extract knowledge from a document into guidelines |
+
+---
+
+After completing all three parts, summarize and ask:
+
+"You're now onboarded to the workflow system! Here's what we covered:
+- Part 1: Core concepts (why this workflow exists)
+- Part 2: Real-world examples (how to apply the workflow)
+- Part 3: Guidelines customization (created feature.json if needed)
+
+**Next steps**:
+1. Commit the feature.json (if created)
+2. Use `/record-agent-flow` to record this session
+3. Start a new session to begin customizing guidelines (or your actual development work)
 
-Then guide them through their first task using the appropriate workflow.
+What would you like to do first?"

package/dist/tui/components/AgentCard.d.ts

@@ -0,0 +1,9 @@
+import type { Agent } from "../hooks/useAgents.js";
+interface AgentCardProps {
+    agent: Agent;
+    isSelected: boolean;
+    compact?: boolean;
+}
+export declare function AgentCard({ agent, isSelected, compact }: AgentCardProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=AgentCard.d.ts.map

package/dist/tui/components/AgentCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentCard.d.ts","sourceRoot":"","sources":["../../../src/tui/components/AgentCard.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,UAAU,cAAc;IACtB,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAsBD,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,cAAc,2CA8GvE"}

package/dist/tui/components/AgentCard.js

@@ -0,0 +1,71 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+const statusColors = {
+    running: "green",
+    in_progress: "green",
+    blocked: "yellow",
+    review: "magenta",
+    completed: "cyan",
+    failed: "red",
+    stopped: "gray",
+};
+const statusIcons = {
+    running: "●",
+    in_progress: "●",
+    blocked: "◐",
+    review: "◉",
+    completed: "✓",
+    failed: "✗",
+    stopped: "○",
+};
+export function AgentCard({ agent, isSelected, compact }) {
+    const statusColor = statusColors[agent.status] || "white";
+    const statusIcon = statusIcons[agent.status] || "?";
+    // Format elapsed time
+    const elapsed = getElapsedTime(agent.started_at);
+    // Compact mode for kanban columns
+    if (compact) {
+        return (_jsxs(Box, { flexDirection: "column", borderStyle: isSelected ? "bold" : "single", borderColor: isSelected ? "cyan" : "gray", paddingX: 1, marginBottom: 1, children: [_jsxs(Box, { children: [_jsxs(Text, { color: statusColor, children: [statusIcon, " "] }), _jsx(Text, { bold: isSelected, wrap: "truncate", children: truncate(agent.name, 15) }), !agent.is_alive &&
+                            (agent.status === "running" || agent.status === "in_progress") && (_jsx(Text, { color: "red", children: " !" }))] }), _jsxs(Text, { color: "gray", dimColor: true, children: ["P", agent.current_phase, " | ", elapsed] }), agent.error && _jsxs(Text, { color: "red", children: ["\u26A0 ", truncate(agent.error, 12)] })] }));
+    }
+    // Full mode
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: isSelected ? "double" : "single", borderColor: isSelected ? "cyan" : "gray", paddingX: 1, marginBottom: 1, children: [_jsxs(Box, { children: [_jsxs(Text, { color: statusColor, children: [statusIcon, " "] }), _jsx(Text, { bold: isSelected, wrap: "truncate", children: agent.name })] }), agent.branch && (_jsx(Text, { color: "gray", dimColor: true, children: agent.branch })), _jsxs(Box, { children: [_jsxs(Text, { color: "blue", children: ["Phase ", agent.current_phase] }), _jsx(Text, { color: "gray", children: " | " }), _jsx(Text, { color: statusColor, children: agent.status }), !agent.is_alive &&
+                        (agent.status === "running" || agent.status === "in_progress") && (_jsx(Text, { color: "red", children: " (dead)" }))] }), _jsxs(Box, { children: [_jsx(Text, { color: "gray", dimColor: true, children: elapsed }), _jsxs(Text, { color: "gray", children: [" | PID: ", agent.pid] })] }), agent.last_log_lines && agent.last_log_lines.length > 0 && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", dimColor: true, wrap: "truncate", children: truncate(cleanLogLine(agent.last_log_lines[agent.last_log_lines.length - 1]), 60) }) })), agent.error && (_jsx(Text, { color: "red", wrap: "truncate", children: truncate(agent.error, 50) })), agent.pr_url && (_jsxs(Text, { color: "green", children: ["PR: ", truncate(agent.pr_url, 50)] }))] }));
+}
+function getElapsedTime(startedAt) {
+    try {
+        const start = new Date(startedAt);
+        const now = new Date();
+        const diffMs = now.getTime() - start.getTime();
+        const seconds = Math.floor(diffMs / 1000);
+        const minutes = Math.floor(seconds / 60);
+        const hours = Math.floor(minutes / 60);
+        if (hours > 0) {
+            return `${hours}h ${minutes % 60}m`;
+        }
+        else if (minutes > 0) {
+            return `${minutes}m ${seconds % 60}s`;
+        }
+        else {
+            return `${seconds}s`;
+        }
+    }
+    catch {
+        return "unknown";
+    }
+}
+function truncate(str, maxLen) {
+    if (!str)
+        return "";
+    if (str.length <= maxLen)
+        return str;
+    return str.slice(0, maxLen - 3) + "...";
+}
+function cleanLogLine(line) {
+    // Remove ANSI color codes and JSON formatting
+    return line
+        .replace(/\x1b\[[0-9;]*m/g, "")
+        .replace(/^\s*\{.*\}\s*$/, "[JSON output]")
+        .trim();
+}
+//# sourceMappingURL=AgentCard.js.map

package/dist/tui/components/AgentCard.js.map

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