ai-workflow-init 6.2.3 → 6.3.2

package/README.md

@@ -4,7 +4,7 @@ A standardized AI workflow system for modern AI coding assistants. Initialize st
 
 ## Features
 
-- **Multi-Platform Support**: Works with Cursor, GitHub Copilot, Claude Code, and OpenCode
+- **Multi-Platform Support**: Works with Cursor, GitHub Copilot, Claude Code, OpenCode, and Factory Droid
 - **Structured Workflows**: Plan → Implement → Test → Review methodology
 - **14 Pre-built Commands**: Create plans, execute tasks, run tests, code reviews, and more
 - **7 Reusable Skills**: Design fundamentals, accessibility, theme generation, quality checks
@@ -36,6 +36,7 @@ Choose from:
 - **GitHub Copilot** → `.github/prompts/` and `.github/copilot-instructions.md`
 - **Claude Code** → `.claude/commands/`, `.claude/skills/`, `.claude/themes/`
 - **OpenCode** → `.opencode/command/`, `.opencode/skill/`, `.opencode/agent/`
+- **Factory Droid** → `.factory/commands/`, `.factory/skills/`, `.factory/droids/`
 
 ### Install Specific Tool
 
@@ -49,6 +50,9 @@ npx ai-workflow-init --tool cursor
 # Install only OpenCode
 npx ai-workflow-init --tool opencode
 
+# Install only Factory Droid
+npx ai-workflow-init --tool factory
+
 # Install only GitHub Copilot
 npx ai-workflow-init --tool copilot
 ```
@@ -372,6 +376,7 @@ AGENTS.md               # Universal AI instructions
 | **GitHub Copilot** | `.github/prompts/*.prompt.md` | - | `.github/copilot-instructions.md` |
 | **Claude Code** | `.claude/commands/*.md` | `.claude/skills/*/SKILL.md` | `.claude/CLAUDE.md`, `.claude/themes/` |
 | **OpenCode** | `.opencode/command/*.md` | `.opencode/skill/*/SKILL.md` | `.opencode/agent/`, `opencode.json` |
+| **Factory Droid** | `.factory/commands/*.md` | `.factory/skills/*/SKILL.md` | `.factory/droids/*.md` |
 
 ---
 
@@ -393,13 +398,13 @@ Skills provide specialized knowledge that AI agents can load on-demand:
 
 ## Platform Compatibility
 
-| Feature | Cursor | Copilot | Claude | OpenCode |
-|---------|--------|---------|--------|----------|
-| Commands | ✅ | ✅ | ✅ | ✅ |
-| Skills | ✅ | ❌ | ✅ | ✅ |
-| Custom Agents | ❌ | ❌ | ❌ | ✅ |
-| AGENTS.md | ✅ | ✅ | ✅ | ✅ |
-| Path-specific rules | ✅ | ✅ | ❌ | ❌ |
+| Feature | Cursor | Copilot | Claude | OpenCode | Factory Droid |
+|---------|--------|---------|--------|----------|---------------|
+| Commands | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Skills | ✅ | ❌ | ✅ | ✅ | ✅ |
+| Custom Agents | ❌ | ❌ | ❌ | ✅ | ✅ (Droids) |
+| AGENTS.md | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Path-specific rules | ✅ | ✅ | ❌ | ❌ | ❌ |
 
 ---
 
@@ -436,7 +441,7 @@ Skills provide specialized knowledge that AI agents can load on-demand:
 
 ## Contributing
 
-This project maintains workflows for 4 AI coding tools. When adding commands:
+This project maintains workflows for 5 AI coding tools. When adding commands:
 
 1. Add to `.claude/commands/` (source of truth)
 2. Run `/sync-workflow` to propagate to other tools

package/cli.js

@@ -220,6 +220,12 @@ const AI_TOOLS = [
     description: "Terminal-based AI coding agent",
     folders: [".opencode/command", ".opencode/skill", ".opencode/agent"],
   },
+  {
+    id: "factory",
+    name: "Factory Droid",
+    description: "Factory AI coding assistant",
+    folders: [".factory/commands", ".factory/skills", ".factory/droids"],
+  },
 ];
 
 // Interactive multi-select using arrow keys
@@ -384,17 +390,13 @@ function installClaudeCode() {
   }
   run(`npx degit ${REPO}/.claude/commands .claude/commands --force`);
 
-  // Download CLAUDE.md (context memory) - only if not exists
+  // Download CLAUDE.md (context memory) - always overwrite to get latest
   step("🚚 Downloading Claude Code context memory (.claude/CLAUDE.md)...");
   const claudeMdPath = ".claude/CLAUDE.md";
-  if (existsSync(claudeMdPath)) {
-    skip(`Skipping (already exists): ${claudeMdPath}`);
-  } else {
-    try {
-      run(`curl -fsSL ${RAW_BASE}/.claude/CLAUDE.md -o ${claudeMdPath}`);
-    } catch (_) {
-      run(`wget -qO ${claudeMdPath} ${RAW_BASE}/.claude/CLAUDE.md`);
-    }
+  try {
+    run(`curl -fsSL ${RAW_BASE}/.claude/CLAUDE.md -o ${claudeMdPath}`);
+  } catch (_) {
+    run(`wget -qO ${claudeMdPath} ${RAW_BASE}/.claude/CLAUDE.md`);
   }
 
   // Create settings.json with hooks (project-level, shareable with team)
@@ -417,15 +419,6 @@ function installClaudeCode() {
           }
         ],
         PostToolUse: [
-          {
-            matcher: "Write",
-            hooks: [
-              {
-                type: "prompt",
-                prompt: "If the file path contains 'docs/ai/planning/feature-' and ends with '.md', validate this planning document has all required sections: 1. Goal & Acceptance Criteria, 2. Risks & Assumptions, 3. Definition of Done, 4. Implementation Plan (with Summary and Phases), 5. Follow-ups. Return JSON: {\"valid\": true/false, \"missing\": [list of missing sections], \"message\": \"brief validation result\"}. If file path doesn't match, return {\"valid\": true, \"message\": \"skipped - not a planning doc\"}"
-              }
-            ]
-          },
           {
             matcher: "Edit",
             hooks: [
@@ -436,35 +429,6 @@ function installClaudeCode() {
             ]
           }
         ],
-        PreToolUse: [
-          {
-            matcher: "Edit",
-            hooks: [
-              {
-                type: "prompt",
-                prompt: "If the file path contains 'docs/ai/planning/feature-' and ends with '.md': Check if the agent is starting a new phase. If yes, verify all tasks in the previous phase are marked [x]. Return JSON: {\"canProceed\": true/false, \"message\": \"reason\"}. If file path doesn't match, return {\"canProceed\": true, \"message\": \"skipped - not a planning doc\"}"
-              }
-            ]
-          },
-          {
-            matcher: "Bash",
-            hooks: [
-              {
-                type: "prompt",
-                prompt: "GIT SAFETY CHECK: If command contains 'git ' (git commands like git add, git commit, git push, git pull, git checkout, git branch, git merge, git rebase, git reset, git stash, etc.): Check the ORIGINAL USER PROMPT - did the user EXPLICITLY request git operations? Keywords indicating user wants git: 'commit', 'push', 'git', 'version control', 'save changes', 'create branch'. If user did NOT explicitly request git operations, BLOCK with message 'Git operations require explicit user request. Ask user first.' Return JSON: {\"allow\": true/false, \"reason\": \"explanation\"}. If command does not contain git, return {\"allow\": true, \"reason\": \"not a git command\"}"
-              }
-            ]
-          },
-          {
-            matcher: "Write|Edit",
-            hooks: [
-              {
-                type: "prompt",
-                prompt: "SECURITY CHECK: If file path matches any sensitive pattern: '.env', '.env.*', 'credentials', 'secrets', 'api_key', 'apikey', 'password', 'private_key', 'token', '.pem', '.key', 'auth.json', 'config/prod': WARN user with message '⚠️ SENSITIVE FILE: [filename] - Are you sure you want to modify this file?'. Return JSON: {\"isSensitive\": true/false, \"warning\": \"message if sensitive\", \"allow\": true}. Always allow but warn for sensitive files."
-              }
-            ]
-          }
-        ],
         Stop: [
           {
             matcher: "",
@@ -565,6 +529,45 @@ function installOpenCode() {
   }
 }
 
+// Install Factory Droid
+function installFactoryDroid() {
+  step("🚚 Downloading Factory Droid commands (.factory/commands)...");
+  if (!existsSync(".factory/commands")) {
+    mkdirSync(".factory/commands", { recursive: true });
+  }
+
+  // Check if source exists, if not create from Claude commands
+  try {
+    run(`npx degit ${REPO}/.factory/commands .factory/commands --force`);
+  } catch (e) {
+    console.log(`${colors.yellow}⚠️  Factory Droid commands not found in repo, will be synced from Claude Code${colors.reset}`);
+  }
+
+  step("🚚 Downloading Factory Droid skills (.factory/skills)...");
+  if (!existsSync(".factory/skills")) {
+    mkdirSync(".factory/skills", { recursive: true });
+  }
+
+  // Check if source exists, if not create from Claude skills
+  try {
+    run(`npx degit ${REPO}/.factory/skills .factory/skills --force`);
+  } catch (e) {
+    console.log(`${colors.yellow}⚠️  Factory Droid skills not found in repo, will be synced from Claude Code${colors.reset}`);
+  }
+
+  step("🚚 Downloading Factory Droid droids (.factory/droids)...");
+  if (!existsSync(".factory/droids")) {
+    mkdirSync(".factory/droids", { recursive: true });
+  }
+
+  // Check if source exists
+  try {
+    run(`npx degit ${REPO}/.factory/droids .factory/droids --force`);
+  } catch (e) {
+    console.log(`${colors.yellow}⚠️  Factory Droid droids not found in repo, using built-in droids${colors.reset}`);
+  }
+}
+
 async function main() {
   console.log(`
 ${colors.cyan}╔═══════════════════════════════════════════════════════════╗
@@ -633,6 +636,10 @@ ${colors.cyan}╔═════════════════════
     installOpenCode();
   }
 
+  if (toolIds.includes("factory")) {
+    installFactoryDroid();
+  }
+
   // Download AGENTS.md (luôn ghi đè)
   step("🚚 Downloading AGENTS.md...");
   try {

package/docs/sync-workflow/common.md

@@ -0,0 +1,131 @@
+# Common Analysis for Workflow Sync
+
+This file contains shared logic for analyzing source files and detecting existing targets.
+
+---
+
+## Step 1: Fetch Latest Documentation (Optional)
+
+**CRITICAL: Fetch latest docs before syncing to ensure format compliance.**
+
+Only fetch documentation for the selected platforms. Use WebSearch or WebFetch.
+
+**Error handling:**
+- Web search fails: Use cached knowledge + warn user docs may be outdated
+- URL fetch fails: Try alternative URLs or search queries
+- Format changed significantly: Alert user, show differences
+
+---
+
+## Step 2: Analyze Source (Claude Code)
+
+### 2a: Analyze Commands
+
+**Tools:**
+- Glob(pattern=".claude/commands/*.md")
+- Read(file_path=...) for each command
+
+**For each Claude command, extract:**
+- Frontmatter: name, description
+- Goal section
+- Step-by-step instructions
+- Tool references (AskUserQuestion, Read, Write, Edit, Task, etc.)
+- Skill references (`.claude/skills/...`)
+- Notes and guidelines
+
+### 2b: Analyze Skills
+
+**Tools:**
+- Glob(pattern=".claude/skills/**/SKILL.md")
+- Read(file_path=...) for each skill
+
+**For each Claude skill, extract:**
+- Skill name and category (from path)
+- SKILL.md content
+- Triggers and usage conditions
+- Instructions and guidelines
+
+### 2c: Analyze Base Instructions
+
+**Tools:**
+- Read(file_path=".claude/CLAUDE.md")
+- Read(file_path="AGENTS.md")
+
+**Build inventory:**
+```
+| Type    | Name              | Description                          | Location              |
+|---------|-------------------|--------------------------------------|-----------------------|
+| Command | create-plan       | Generates feature planning doc       | .claude/commands/     |
+| Command | execute-plan      | Implements tasks from planning doc   | .claude/commands/     |
+| Skill   | figma-extraction  | Extract design from Figma            | .claude/skills/design/|
+| Skill   | quality-code-check| Linting and type checking            | .claude/skills/arch/  |
+| Rules   | CLAUDE.md         | Base instructions                    | .claude/              |
+| Rules   | AGENTS.md         | Agent instructions                   | root                  |
+```
+
+---
+
+## Step 3: Detect Existing Target Files
+
+**Tools (run for selected platforms only):**
+
+### Cursor:
+- Glob(pattern=".cursor/commands/*.md")
+- Glob(pattern=".cursor/rules/*.md")
+
+### GitHub Copilot:
+- Glob(pattern=".github/prompts/*.prompt.md")
+- Read(file_path=".github/copilot-instructions.md")
+
+### OpenCode:
+- Glob(pattern=".opencode/command/*.md")
+- Glob(pattern=".opencode/skill/*/SKILL.md")
+- Glob(pattern=".opencode/agent/*.md")
+
+### Factory Droid:
+- Glob(pattern=".factory/commands/*.md")
+- Glob(pattern=".factory/skills/*/SKILL.md")
+- Glob(pattern=".factory/droids/*.md")
+
+---
+
+## Step 4: Classify Files
+
+**Compare and classify:**
+- **MISSING**: Source exists but not in target
+- **OUTDATED**: Target exists but content differs significantly
+- **CURRENT**: Target matches source (skip)
+
+**Output classification example:**
+```
+[Platform Name]:
+  - create-plan: OUTDATED (source modified)
+  - execute-plan: CURRENT (skip)
+  - sync-workflow: MISSING (new)
+```
+
+---
+
+## Tool Reference Conversion (Universal)
+
+| Claude Code | Generic Instruction |
+|-------------|---------------------|
+| `AskUserQuestion(...)` | Ask user for input |
+| `Task(subagent_type='Explore')` | Search codebase |
+| `Task(subagent_type='General')` | General analysis |
+| `Read(file_path=...)` | Read file |
+| `Write(file_path=...)` | Write file |
+| `Edit(file_path=...)` | Edit file |
+| `Glob(pattern=...)` | Find files matching pattern |
+| `Grep(pattern=...)` | Search content for pattern |
+| `Bash(command=...)` | Run terminal command |
+| `WebFetch(url=...)` | Fetch URL content |
+
+---
+
+## Error Handling
+
+- Directory doesn't exist: Create it first with `mkdir -p`
+- File write fails: Retry once, then notify user
+- Conversion uncertain: Add TODO comment in output file
+- Skill name validation fails: Adjust name to meet requirements

package/docs/sync-workflow/cursor.md

@@ -0,0 +1,135 @@
+# Cursor Sync Guide
+
+Sync Claude Code workflows to Cursor format.
+
+---
+
+## Prerequisites
+
+- Source: `.claude/commands/*.md`, `.claude/skills/**/SKILL.md`
+- Target: `.cursor/commands/*.md`, `.cursor/rules/`
+
+---
+
+## Step 1: Fetch Cursor Documentation
+
+**Search queries (try in order until successful):**
+1. `"cursor.com" rules for ai custom commands documentation`
+2. `site:docs.cursor.com rules commands`
+3. `cursor ai editor custom rules commands format`
+
+**Key documentation URLs:**
+- `https://docs.cursor.com/context/rules-for-ai`
+- `https://docs.cursor.com/context/rules`
+- `https://docs.cursor.com/chat/custom-modes`
+
+**Extract and note:**
+- Command file location: `.cursor/commands/` or `.cursor/rules/`
+- File format: frontmatter structure, markdown body
+- Supported frontmatter fields (name, description, etc.)
+- Any special syntax or features (variables, context references)
+- AGENTS.md support and location
+
+---
+
+## Step 2: Conversion Rules
+
+### Commands (`.cursor/commands/*.md`)
+
+**Frontmatter:**
+- Keep `name` and `description`
+- Adjust other fields per Cursor docs
+
+**Tool references conversion:**
+| Claude Code | Cursor |
+|-------------|--------|
+| `AskUserQuestion(...)` | Ask user |
+| `Task(subagent_type='Explore')` | Workspace search |
+| `Read(file_path=...)` | Read file |
+| `Write(file_path=...)` | Write file |
+| `Edit(file_path=...)` | Edit file |
+| `Glob(pattern=...)` | Find files |
+| `Grep(pattern=...)` | Search content |
+| `Bash(command=...)` | Run command |
+
+**Skill references:**
+- Convert `.claude/skills/...` → `.cursor/rules/...` or inline
+
+**Keep:** Goal, Steps, Notes sections structure
+
+### Skills → Rules (`.cursor/rules/`)
+
+Convert Claude skills to Cursor rules format.
+
+---
+
+## Step 3: Templates
+
+### Command Template
+
+```markdown
+---
+name: {command-name}
+description: {description}
+---
+
+## Goal
+
+{goal from Claude command}
+
+## Workflow Alignment
+
+{workflow section}
+
+## Step 1: {step name}
+
+{converted step content - replace Claude-specific tool syntax}
+
+...
+
+## Notes
+
+{notes section}
+```
+
+### Rule Template (for skills)
+
+```markdown
+---
+name: {skill-name}
+description: {description}
+---
+
+{skill instructions converted to Cursor rule format}
+```
+
+---
+
+## Step 4: Write Files
+
+**Tools:**
+- `mkdir -p .cursor/commands`
+- `mkdir -p .cursor/rules`
+- Write(file_path=".cursor/commands/{name}.md")
+- Write(file_path=".cursor/rules/{name}.md")
+
+**Also sync base instructions:**
+- Copy `.claude/CLAUDE.md` → `.cursor/CLAUDE.md`
+
+---
+
+## Step 5: Output Classification
+
+```
+Cursor (.cursor/commands/):
+  - create-plan.md: [STATUS]
+  - execute-plan.md: [STATUS]
+  - sync-workflow.md: [STATUS]
+
+Cursor (.cursor/rules/):
+  - frontend-design-fundamentals.md: [STATUS]
+  - quality-code-check.md: [STATUS]
+
+Cursor Base Instructions:
+  - .cursor/CLAUDE.md: [STATUS]
+```