ai-workflow-init 6.2.3 → 6.3.1

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]
+```

package/docs/sync-workflow/factory-droid.md

@@ -0,0 +1,234 @@
+# Factory Droid Sync Guide
+
+Sync Claude Code workflows to Factory Droid format.
+
+---
+
+## Prerequisites
+
+- Source: `.claude/commands/*.md`, `.claude/skills/**/SKILL.md`, `.claude/CLAUDE.md`
+- Target: `.factory/commands/*.md`, `.factory/skills/*/SKILL.md`, `.factory/droids/*.md`
+
+---
+
+## Step 1: Fetch Factory Droid Documentation
+
+**Search queries (try in order until successful):**
+1. `site:docs.factory.ai cli configuration commands skills`
+2. `factory.ai droid custom commands skills documentation`
+3. `factory droid cli configuration custom-droids`
+
+**Key documentation URLs:**
+- `https://docs.factory.ai/cli/configuration/custom-slash-commands` - Custom commands
+- `https://docs.factory.ai/cli/configuration/skills` - Skills configuration
+- `https://docs.factory.ai/cli/configuration/custom-droids` - Custom droids (sub-agents)
+
+---
+
+## Step 2: Conversion Rules
+
+### Commands (`.factory/commands/*.md`)
+
+**Location**: `.factory/commands/{name}.md` (workspace) or `~/.factory/commands/` (personal)
+
+**File format:** Markdown (`.md`) or executable with shebang (`#!`)
+
+**Frontmatter:**
+- `description`: command description
+- `argument-hint`: optional hint for arguments (e.g., `<feature-name>`)
+
+**Arguments:**
+- `$ARGUMENTS` for all text after command name
+- Executable commands receive `$1`, `$2`, etc.
+
+**Tool references conversion:**
+| Claude Code | Factory Droid |
+|-------------|---------------|
+| `AskUserQuestion(...)` | (handled by TUI) |
+| `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 |
+| `Grep(pattern=...)` | Search content |
+| `Bash(command=...)` | Run command |
+
+### Skills (`.factory/skills/<name>/SKILL.md`)
+
+**Location**: `.factory/skills/{skill-name}/SKILL.md` (workspace) or `~/.factory/skills/` (personal)
+
+**File format:** `SKILL.md` or `skill.mdx`
+
+**Frontmatter (required):**
+- `name`: skill name (should match directory name)
+- `description`: clear description of when to use the skill
+
+**Content:** Markdown instructions for skill behavior
+
+### Droids (`.factory/droids/*.md`)
+
+**Location**: `.factory/droids/{droid-name}.md` (project) or `~/.factory/droids/` (personal)
+
+**File format:** Markdown with YAML frontmatter and non-empty body
+
+**Frontmatter:**
+- `name`: Required, droid identifier (matches filename)
+- `description`: Optional, shown in UI
+- `model`: `inherit` (use default) or specific model identifier
+- `reasoningEffort`: Optional (`low`, `medium`, `high`)
+- `tools`: Array of tool IDs or category string
+
+**Tool categories:**
+- `read-only` - Read, LS, Grep, Glob
+- `edit` - Write, Edit
+- `execute` - Bash, shell commands
+- `web` - WebSearch, WebFetch
+- `mcp` - MCP tools
+
+**Note:** `TodoWrite` tool is automatic for all droids.
+
+---
+
+## Step 3: Templates
+
+### Command Template
+
+```markdown
+---
+description: {description}
+argument-hint: {optional hint for arguments, e.g., "<feature-name>"}
+---
+
+## Goal
+
+{goal from Claude command}
+
+## Instructions
+
+{step-by-step instructions}
+
+### Step 1: {step name}
+
+{converted step content}
+- Search codebase for relevant files
+- Read and analyze existing code
+- Write/edit files as needed
+
+...
+
+## Notes
+
+{notes section}
+```
+
+### Skill Template
+
+```markdown
+---
+name: {skill-name}
+description: {description from Claude skill - explain when to trigger}
+---
+
+# {Skill Title}
+
+## Instructions
+
+1. {step 1}
+2. {step 2}
+3. {step 3}
+
+## Guidelines
+
+- {guideline 1}
+- {guideline 2}
+```
+
+### Droid Template
+
+```markdown
+---
+name: {droid-name}
+description: {description of what this droid does}
+model: inherit
+reasoningEffort: medium
+tools: ["Read", "LS", "Grep", "Glob"]
+---
+
+You are a specialized {role} droid.
+
+## Focus
+
+- {behavior 1}
+- {behavior 2}
+- {behavior 3}
+
+## Guidelines
+
+- {guideline 1}
+- {guideline 2}
+```
+
+---
+
+## Step 4: Write Files
+
+**Tools:**
+- `mkdir -p .factory/commands`
+- `mkdir -p .factory/skills/{name}`
+- `mkdir -p .factory/droids`
+- Write(file_path=".factory/commands/{name}.md")
+- Write(file_path=".factory/skills/{name}/SKILL.md")
+- Write(file_path=".factory/droids/{name}.md") - only if custom droid needed
+
+**Skill name mapping:**
+- `.claude/skills/design/figma-extraction/` → `.factory/skills/figma-extraction/`
+- `.claude/skills/architecture/quality-code-check/` → `.factory/skills/quality-code-check/`
+- `.claude/skills/ux/accessibility/` → `.factory/skills/ux-accessibility/`
+
+---
+
+## Step 5: Output Classification
+
+```
+Factory Droid Commands (.factory/commands/):
+  - create-plan.md: [STATUS]
+  - execute-plan.md: [STATUS]
+  - sync-workflow.md: [STATUS]
+
+Factory Droid Skills (.factory/skills/):
+  - figma-extraction/SKILL.md: [STATUS]
+  - quality-code-check/SKILL.md: [STATUS]
+  - frontend-design-fundamentals/SKILL.md: [STATUS]
+
+Factory Droid Droids (.factory/droids/):
+  - code-reviewer.md: [STATUS] (if custom review workflow)
+  - No custom droids needed otherwise
+```
+
+---
+
+## Factory Droid-Specific Notes
+
+1. **Skills are native**: Factory Droid reads skills from `.factory/skills/*/SKILL.md`
+
+2. **AGENTS.md is native**: Factory Droid reads `AGENTS.md` from root - no conversion needed
+
+3. **Command management:**
+   - Reload commands: Press `R` in `/commands`
+   - Import existing commands: Press `I` in `/commands`
+
+4. **Droid tool arrays:**
+   - Array format: `["Read", "LS", "Grep", "Glob"]`
+   - Category string: `"read-only"`, `"edit"`, `"execute"`, `"web"`, `"mcp"`
+   - Combine as needed for custom permissions
+
+5. **Example droids:**
+   - `code-reviewer`: `tools: ["Read", "LS", "Grep", "Glob"]` - read-only review
+   - `security-sweeper`: `tools: ["Read", "Grep", "WebSearch"]` - security analysis
+   - `docs-writer`: `tools: ["Read", "Write", "Edit", "Glob"]` - documentation
+
+6. **Reasoning effort:**
+   - `low`: Fast, simple tasks
+   - `medium`: Balanced (default)
+   - `high`: Complex analysis tasks

package/docs/sync-workflow/github-copilot.md

@@ -0,0 +1,137 @@
+# GitHub Copilot Sync Guide
+
+Sync Claude Code workflows to GitHub Copilot format.
+
+---
+
+## Prerequisites
+
+- Source: `.claude/commands/*.md`, `.claude/CLAUDE.md`
+- Target: `.github/prompts/*.prompt.md`, `.github/copilot-instructions.md`
+
+---
+
+## Step 1: Fetch GitHub Copilot Documentation
+
+**Search queries (try in order until successful):**
+1. `"github.com" copilot custom instructions repository documentation`
+2. `site:docs.github.com copilot custom instructions prompts`
+3. `github copilot prompt files .github/prompts format`
+
+**Key documentation URLs:**
+- `https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot`
+- `https://docs.github.com/en/copilot/how-tos/configure-custom-instructions`
+
+**Extract and note:**
+- Prompt file location: `.github/prompts/`
+- File format: `*.prompt.md` naming convention
+- Frontmatter structure (applyTo, excludeAgent, etc.)
+- Custom instructions file: `.github/copilot-instructions.md`
+- AGENTS.md support (location, format)
+
+---
+
+## Step 2: Conversion Rules
+
+### Commands → Prompts (`.github/prompts/*.prompt.md`)
+
+**Filename:** `{name}.prompt.md` format
+
+**Frontmatter:**
+- May need `applyTo` for path-specific prompts
+- Keep `name` and `description`
+
+**Tool references conversion:**
+| Claude Code | GitHub Copilot |
+|-------------|----------------|
+| `AskUserQuestion(...)` | Ask user for clarification |
+| `Task(subagent_type='Explore')` | Search codebase for... |
+| `Read(file_path=...)` | Read file |
+| `Write(file_path=...)` | Write file |
+| `Edit(file_path=...)` | Edit file |
+| `Glob(pattern=...)` | Find files |
+| `Grep(pattern=...)` | Search pattern |
+| `Bash(command=...)` | Run command |
+
+**Remove:** Claude-specific skill references (Copilot doesn't have skills system)
+
+**Keep:** Goal, Steps structure, acceptance criteria
+
+### Skills
+
+GitHub Copilot doesn't have a skills system. Options:
+1. Inline skill content into relevant prompts
+2. Add to `copilot-instructions.md` as guidelines
+3. Skip skills (not applicable)
+
+---
+
+## Step 3: Templates
+
+### Prompt Template
+
+```markdown
+---
+name: {command-name}
+description: {description}
+---
+
+## Goal
+
+{goal from Claude command}
+
+## Workflow Alignment
+
+{workflow section - simplified}
+
+## Step 1: {step name}
+
+{converted step content - generic instructions}
+
+...
+
+## Notes
+
+{notes section - remove Claude-specific references}
+```
+
+### copilot-instructions.md Template
+
+```markdown
+# Repository Instructions for GitHub Copilot
+
+## Coding Philosophy
+
+{core philosophy from .claude/CLAUDE.md}
+
+## Workflow Guidelines
+
+{workflow guidelines - converted to generic instructions}
+
+## Code Standards
+
+{code presentation, TODO policy, etc.}
+```
+
+---
+
+## Step 4: Write Files
+
+**Tools:**
+- `mkdir -p .github/prompts`
+- Write(file_path=".github/prompts/{name}.prompt.md")
+- Write(file_path=".github/copilot-instructions.md")
+
+---
+
+## Step 5: Output Classification
+
+```
+GitHub Copilot (.github/prompts/):
+  - create-plan.prompt.md: [STATUS]
+  - execute-plan.prompt.md: [STATUS]
+  - sync-workflow.prompt.md: [STATUS]
+
+GitHub Copilot Base Instructions:
+  - .github/copilot-instructions.md: [STATUS]
+```