@relipa/ai-flow-kit 0.1.1 → 0.1.2-beta.0

package/scripts/prompt.js

@@ -1,538 +1,538 @@
-const fs = require('fs-extra');
-const path = require('path');
-const chalk = require('chalk');
-const { spawnSync } = require('child_process');
-const { confirm } = require('@inquirer/prompts');
-
-const PROJECT_DIR  = process.cwd();
-const CURRENT_FILE = path.join(PROJECT_DIR, '.aiflow', 'context', 'current.json');
-const RULES_DIR    = path.join(PROJECT_DIR, '.rules');
-
-// Prompt templates per task type
-// Each template includes mandatory superpowers skill invocation steps.
-const PROMPT_TEMPLATES = {
-    'bug-fix': {
-        header: 'Fix Bug',
-        instruction: 'Investigate and fix the bug described below.',
-        skillWorkflow: `
-## STRICT GATE WORKFLOW — Bug Fix
-
-Follow gates IN ORDER. Do NOT skip or merge gates.
-
-### GATE 1 — AI Analyze Requirement
-**INVOKE:** \`read-study-requirement\` skill
-AI must:
-1. Load ticket context + read source code related to the bug
-2. Trace data flow to form root cause hypothesis (\`superpowers:systematic-debugging\`)
-3. If unclear → ask ONE question at a time, wait for reply
-4. Output \`plan/[ticket-id]/requirement.md\` with:
-   - Bug analysis (current vs expected behavior)
-   - Root cause hypothesis with evidence from source code
-   - Proposed fix approach (options if multiple)
-   - Impact analysis — will the fix break anything else?
-   - Effort estimate (S/M/L/XL)
-   - Testing plan (reproduce bug + verify fix)
-5. Display "GATE 1: Requirement doc ready" → wait for **APPROVED**
-
-### GATE 2 — Implementation Plan (wait for APPROVED)
-**INVOKE:** \`generate-spec\` skill → \`superpowers:writing-plans\`
-- Create TDD task breakdown: test to reproduce bug → fix → verify
-- Display: "GATE 2: Plan ready, type APPROVED to start coding"
-- **DO NOT WRITE CODE until APPROVED received**
-
-### GATE 3 — Code (TDD)
-Only runs after Gate 2 APPROVED.
-1. **INVOKE:** \`superpowers:systematic-debugging\` — confirm root cause
-2. **INVOKE:** \`investigate-bug\` skill — trace Controller→Service→Repository
-3. **INVOKE:** \`superpowers:test-driven-development\` — write failing test to reproduce bug
-4. Implement minimal fix to make test pass
-
-### GATE 4 — AI Self-Review (wait for APPROVED)
-**INVOKE:** \`review-plan\` skill
-1. \`superpowers:verification-before-completion\` — all tests PASS (including old tests)
-2. \`impact-analysis\` skill — fix doesn't cause new bugs elsewhere
-3. Tick \`custom/rules/review-checklist.md\`
-4. Create \`plan/[ticket-id]/summary.md\`
-- Display: "GATE 4: type APPROVED or BUG: [description]"
-- Coding bug → fix → repeat Gate 4
-- Requirement bug → back to Gate 1
-
-### GATE 5 — Peer Review & Done
-Only runs after Gate 4 APPROVED.
-**INVOKE:** \`superpowers:requesting-code-review\` → guide PR creation
-`,
-    },
-    'feature': {
-        header: 'Implement Feature',
-        instruction: 'Implement the feature described below following team rules.',
-        skillWorkflow: `
-## STRICT GATE WORKFLOW — Feature
-
-Follow gates IN ORDER. Do NOT skip or merge gates.
-
-### GATE 1 — AI Analyze Requirement
-**INVOKE:** \`read-study-requirement\` skill
-AI must:
-1. Load ticket context + read source code to understand architecture
-2. Investigate related files, data flow, existing patterns
-3. Propose 2-3 solution approaches using Q&A if the problem is complex
-4. If unclear → ask ONE question at a time, wait for reply
-5. Output \`plan/[ticket-id]/requirement.md\` with:
-   - Requirements summary (AI's understanding in technical language)
-   - Source code analysis (related files, data flow, patterns)
-   - Proposed solution with options (recommended + alternatives)
-   - Impact analysis — what areas are affected?
-   - Effort estimate (S/M/L/XL) with task breakdown
-   - Testing plan (unit + integration + manual)
-6. Display "GATE 1: Requirement doc ready" → wait for **APPROVED**
-
-### GATE 2 — Implementation Plan (wait for APPROVED)
-**INVOKE:** \`generate-spec\` skill → \`superpowers:writing-plans\`
-- Create TDD task breakdown: test first → implement → verify
-- Define commit strategy (small, focused)
-- Display: "GATE 2: Plan ready, type APPROVED to start coding"
-- **DO NOT WRITE CODE until APPROVED received**
-
-### GATE 3 — Code (TDD)
-Only runs after Gate 2 APPROVED.
-1. Complex feature (3+ files): **INVOKE:** \`superpowers:subagent-driven-development\`
-2. **INVOKE:** \`superpowers:test-driven-development\` — write failing test first
-3. Implement to make tests pass — verify each small step
-
-### GATE 4 — AI Self-Review (wait for APPROVED)
-**INVOKE:** \`review-plan\` skill
-1. \`superpowers:verification-before-completion\` — all tests PASS
-2. \`impact-analysis\` skill — no regressions
-3. Tick \`custom/rules/review-checklist.md\`
-4. Create \`plan/[ticket-id]/summary.md\`
-- Display: "GATE 4: type APPROVED or BUG: [description]"
-- Coding bug → fix → repeat Gate 4
-- Requirement bug → back to Gate 1
-
-### GATE 5 — Peer Review & Done
-Only runs after Gate 4 APPROVED.
-**INVOKE:** \`superpowers:requesting-code-review\` → guide PR creation
-`,
-    },
-    'investigation': {
-        header: 'Investigate',
-        instruction: 'Investigate the topic described below. Document findings before proposing solutions.',
-        skillWorkflow: `
-## STRICT GATE WORKFLOW — Investigation
-
-Investigation stops at Gate 1 — produce requirement doc with findings only, no coding.
-
-### GATE 1 — AI Analyze & Investigate
-**INVOKE:** \`read-study-requirement\` skill
-AI must:
-1. Load ticket context + read source code thoroughly
-2. **INVOKE:** \`superpowers:systematic-debugging\` — trace through all layers
-3. **INVOKE:** \`investigate-bug\` skill — trace data flow through all layers
-4. If unclear → ask ONE question at a time
-5. Output \`plan/[ticket-id]/requirement.md\` with:
-   - Investigation scope and approach
-   - Source code analysis (all related files traced)
-   - Findings with evidence (log output, code references)
-   - Root cause (if applicable)
-   - Impact analysis — what areas are affected?
-   - Recommendations and next steps
-   - Effort estimate for proposed fix (if applicable)
-6. Display "GATE 1: Investigation complete" → wait for **APPROVED**
-
-**Do NOT implement any fix.** If fix needed → create new ticket → new workflow.
-`,
-    },
-    'refactor': {
-        header: 'Refactor',
-        instruction: 'Refactor the code described below. Behaviour must be preserved.',
-        skillWorkflow: `
-## STRICT GATE WORKFLOW — Refactor
-
-Follow gates IN ORDER. Do NOT skip or merge gates.
-
-### GATE 1 — AI Analyze Requirement
-**INVOKE:** \`read-study-requirement\` skill
-AI must:
-1. Load ticket context + read source code to understand current state
-2. **INVOKE:** \`impact-analysis\` skill — map ALL callers and dependants
-3. If unclear → ask ONE question at a time
-4. Output \`plan/[ticket-id]/requirement.md\` with:
-   - Current state analysis (what exists, what's wrong)
-   - Target state (what it should look like after refactor)
-   - Proposed approach (step-by-step refactor strategy)
-   - Impact analysis — all callers, dependencies, test coverage
-   - Risk assessment — what could break?
-   - Effort estimate (S/M/L/XL)
-5. Display "GATE 1: Requirement doc ready" → wait for **APPROVED**
-
-### GATE 2 — Implementation Plan (wait for APPROVED)
-**INVOKE:** \`generate-spec\` skill → \`superpowers:writing-plans\`
-- Plan: ensure tests cover CURRENT behavior → refactor in steps → verify at each step
-- Display: "GATE 2: Plan ready, type APPROVED to start refactoring"
-- **DO NOT TOUCH CODE until APPROVED received**
-
-### GATE 3 — Refactor (TDD)
-Only runs after Gate 2 APPROVED.
-1. **INVOKE:** \`superpowers:test-driven-development\` — ensure tests cover CURRENT behavior
-2. Refactor incrementally — keep tests green at each step
-3. Commit after manual verification
-
-### GATE 4 — AI Self-Review (wait for APPROVED)
-**INVOKE:** \`review-plan\` skill
-1. \`superpowers:verification-before-completion\` — all tests PASS
-2. \`impact-analysis\` skill — verify no regressions
-3. Tick \`custom/rules/review-checklist.md\`
-4. Create \`plan/[ticket-id]/summary.md\`
-- Display: "GATE 4: type APPROVED or BUG: [description]"
-
-### GATE 5 — Peer Review & Done
-**INVOKE:** \`superpowers:requesting-code-review\` → guide PR creation
-`,
-    },
-    'impact-analysis': {
-        header: 'Impact Analysis',
-        instruction: 'Analyse the scope and impact of the change described below.',
-        skillWorkflow: `
-## STRICT GATE WORKFLOW — Impact Analysis
-
-Impact analysis stops at Gate 1 — produce report only, no coding.
-
-### GATE 1 — AI Analyze & Report
-**INVOKE:** \`read-study-requirement\` skill
-AI must:
-1. Load ticket context + read source code thoroughly
-2. Map all dependencies, callers, services, jobs, tests
-3. If unclear → ask ONE question at a time
-4. Output \`plan/[ticket-id]/requirement.md\` with:
-   - Change description and scope
-   - Dependency map (all callers, services, jobs, tests)
-   - Impact level: 🟢 Low / 🟡 Medium / 🔴 High / 🔥 Critical
-   - Breaking changes list
-   - Affected test coverage
-   - Risk assessment with mitigations
-   - Recommendations
-   - Effort estimate for implementation (if applicable)
-5. Display "GATE 1: Impact report complete" → wait for **APPROVED**
-
-**Do NOT make any code changes.** Implementation needs a separate ticket.
-`,
-    },
-    'documentation': {
-        header: 'Write Documentation',
-        instruction: 'Write documentation for the topic described below.',
-        skillWorkflow: `
-## STRICT GATE WORKFLOW — Documentation
-
-### GATE 1 — AI Analyze Requirement
-**INVOKE:** \`read-study-requirement\` skill
-AI must:
-1. Load ticket context + read source code
-2. Understand what needs to be documented and for whom
-3. If unclear → ask ONE question at a time
-4. Output \`plan/[ticket-id]/requirement.md\` with:
-   - Documentation scope and target audience
-   - Content outline (sections to cover)
-   - Source code references
-   - Effort estimate
-5. Display "GATE 1: Documentation plan ready" → wait for **APPROVED**
-
-### GATE 2 — Write Documentation
-Only runs after Gate 1 APPROVED.
-Read actual code/tests first — docs must reflect real implementation.
-Write documentation based on approved outline.
-
-### GATE 3 — Review (wait for APPROVED)
-**INVOKE:** \`superpowers:verification-before-completion\`
-Verify docs match code. No outdated examples.
-Display: "GATE 3: Documentation complete. Type APPROVED."
-`,
-    },
-};
-
-// ──────────────────────────────────────────────────────────────
-// Entry point
-// ──────────────────────────────────────────────────────────────
-
-module.exports = async function generatePrompt(type, options = {}) {
-    if (options.list) {
-        console.log(chalk.cyan('\nAvailable prompt types:\n'));
-        for (const [key, tpl] of Object.entries(PROMPT_TEMPLATES)) {
-            console.log(`  ${chalk.white(key.padEnd(18))} ${chalk.gray(tpl.instruction.substring(0, 60))}...`);
-        }
-        console.log();
-        return;
-    }
-
-    // Load context
-    let ctx = null;
-    if (await fs.pathExists(CURRENT_FILE)) {
-        ctx = await fs.readJson(CURRENT_FILE).catch(() => null);
-    }
-
-    // Resolve task type: CLI arg > context > ask user to specify
-    const resolvedType = type || ctx?.taskType;
-    if (!resolvedType || !PROMPT_TEMPLATES[resolvedType]) {
-        console.log(chalk.red(`Unknown or missing prompt type: ${resolvedType || '(none)'}`));
-        console.log(chalk.gray('Run: aiflow prompt --list'));
-        return;
-    }
-
-    const template = PROMPT_TEMPLATES[resolvedType];
-    const rules    = await loadRules();
-
-    const env = options.env || 'claude';
-    const prompt = buildPrompt(template, ctx, rules, options, env);
-
-    if (options.output) {
-        await fs.writeFile(options.output, prompt, 'utf-8');
-        console.log(chalk.green(`✓ Prompt saved to: ${options.output}`));
-        return;
-    }
-
-    const clipResult = copyToClipboard(prompt);
-    if (clipResult.success) {
-        const ticket = ctx?.taskId ? chalk.gray(` [${ctx.taskId}]`) : '';
-        console.log(chalk.green(`✓ Prompt copied to clipboard!${ticket} Paste it into your AI chat to begin.`));
-    } else {
-        await handleClipboardFailure(prompt, clipResult);
-    }
-};
-
-// ──────────────────────────────────────────────────────────────
-// Helpers
-// ──────────────────────────────────────────────────────────────
-
-async function loadRules() {
-    if (!(await fs.pathExists(RULES_DIR))) return '';
-
-    const files = (await fs.readdir(RULES_DIR)).filter(f => f.endsWith('.md'));
-    if (!files.length) return '';
-
-    const parts = [];
-    for (const file of files) {
-        const content = await fs.readFile(path.join(RULES_DIR, file), 'utf-8');
-        parts.push(`### ${file}\n${content.trim()}`);
-    }
-    return parts.join('\n\n');
-}
-
-function buildPrompt(template, ctx, rules, options, env = 'claude') {
-    const lang   = options.lang   || 'english';
-    const detail = options.detail || 'standard';
-
-    const lines = [];
-
-    lines.push(`# ${template.header}`);
-    lines.push('');
-    lines.push(`**Task:** ${template.instruction}`);
-    lines.push('');
-
-    // ── Mandatory skill workflow ───────────────────────────────
-    if (template.skillWorkflow) {
-        lines.push(template.skillWorkflow.trim());
-        lines.push('');
-    }
-
-    // ── Telemetry instructions ─────────────────────────────────
-    const ticketArg = ctx?.taskId ? ` --ticket ${ctx.taskId}` : '';
-    const akCmd = isWSL() ? 'ak.cmd' : 'ak';
-    lines.push(`> **Telemetry (required):** When **starting** each gate run \`${akCmd} gate N start${ticketArg}\`. When **APPROVED** run \`${akCmd} gate N approved${ticketArg}\`. Replace N with the gate number (1–5).`);
-    lines.push('');
-
-    // ── Context section ────────────────────────────────────────
-    if (ctx) {
-        lines.push('## Context');
-        lines.push('');
-        lines.push(`- **Ticket:** ${ctx.taskId || 'N/A'}`);
-        lines.push(`- **Title:** ${ctx.title || 'N/A'}`);
-        lines.push(`- **Status:** ${ctx.status || 'N/A'}`);
-        lines.push(`- **Assignee:** ${ctx.assignee || 'N/A'}`);
-        lines.push('');
-
-        if (ctx.description) {
-            lines.push('### Description');
-            lines.push('');
-            lines.push(ctx.description.trim());
-            lines.push('');
-        }
-
-        if (ctx.acceptanceCriteria?.length) {
-            lines.push('### Acceptance Criteria');
-            lines.push('');
-            for (const c of ctx.acceptanceCriteria) {
-                lines.push(`- ${c}`);
-            }
-            lines.push('');
-        }
-
-        if (detail === 'comprehensive' && ctx.comments?.length) {
-            lines.push('### Comments');
-            lines.push('');
-            for (const c of ctx.comments) {
-                lines.push(c);
-                lines.push('');
-            }
-        }
-
-        if (ctx.context?.files?.length) {
-            lines.push('### Related Files Mentioned');
-            lines.push('');
-            for (const f of ctx.context.files) {
-                lines.push(`- \`${f}\``);
-            }
-            lines.push('');
-        }
-    } else {
-        lines.push('> No context loaded. Run `aiflow use <ticket>` to load ticket context.');
-        lines.push('');
-    }
-
-    // ── Rules section ──────────────────────────────────────────
-    if (rules) {
-        lines.push('## Team Rules');
-        lines.push('');
-        lines.push(rules);
-        lines.push('');
-    }
-
-    // ── Language instruction ───────────────────────────────────
-    if (lang === 'vietnamese') {
-        lines.push('> **Reply in English.**');
-        lines.push('');
-    }
-
-    // ── Tool-specific instructions ───────────────────────────────
-    if (env === 'cursor') {
-        lines.push('---');
-        lines.push('> **Cursor Tip:** You can use `@Codebase` to search for more context if needed.');
-    } else if (env === 'gemini') {
-        lines.push('---');
-        lines.push('> **Gemini Tip:** Use the "Upload Files" or "Attach File" feature to provide source code context.');
-    }
-
-    return lines.join('\n');
-}
-
-function isWSL() {
-    if (process.platform !== 'linux') return false;
-    try {
-        const version = require('fs').readFileSync('/proc/version', 'utf-8');
-        return /microsoft|wsl/i.test(version);
-    } catch (_) { return false; }
-}
-
-function detectLinuxPkgManager() {
-    const candidates = [
-        { cmd: 'apt-get', installFlag: 'install -y' },
-        { cmd: 'dnf',     installFlag: 'install -y' },
-        { cmd: 'pacman',  installFlag: '-S --noconfirm' },
-        { cmd: 'zypper',  installFlag: 'install -y' },
-    ];
-    for (const c of candidates) {
-        const r = spawnSync('which', [c.cmd], { stdio: 'ignore' });
-        if (r.status === 0) return c;
-    }
-    return null;
-}
-
-function linuxClipboardInfo() {
-    const isWayland = !!process.env.WAYLAND_DISPLAY;
-    const pkg = isWayland ? 'wl-clipboard' : 'xclip';
-    const mgr = detectLinuxPkgManager();
-    return {
-        pkg,
-        pkgManager: mgr ? mgr.cmd : null,
-        installArgs: mgr ? [...mgr.installFlag.split(' '), pkg] : null,
-        installDisplayCmd: mgr ? `sudo ${mgr.cmd} ${mgr.installFlag} ${pkg}` : null,
-    };
-}
-
-// Returns { success: true } or { success: false, pkg, pkgManager, installArgs, installDisplayCmd }
-function copyToClipboard(text) {
-    try {
-        if (process.platform === 'win32') {
-            spawnSync(
-                'powershell',
-                ['-NoProfile', '-NonInteractive', '-Command',
-                 '[Console]::InputEncoding = [System.Text.Encoding]::UTF8; Set-Clipboard -Value ([Console]::In.ReadToEnd())'],
-                { input: text, encoding: 'utf8', stdio: ['pipe', 'ignore', 'ignore'] }
-            );
-            return { success: true };
-        } else if (process.platform === 'darwin') {
-            spawnSync('pbcopy', [], { input: text, encoding: 'utf8', stdio: ['pipe', 'ignore', 'ignore'] });
-            return { success: true };
-        } else if (isWSL()) {
-            spawnSync(
-                'powershell.exe',
-                ['-NoProfile', '-NonInteractive', '-Command',
-                 '[Console]::InputEncoding = [System.Text.Encoding]::UTF8; Set-Clipboard -Value ([Console]::In.ReadToEnd())'],
-                { input: text, encoding: 'utf8', stdio: ['pipe', 'ignore', 'ignore'] }
-            );
-            return { success: true };
-        } else {
-            // Try wl-copy (Wayland), then xclip, then xsel
-            if (process.env.WAYLAND_DISPLAY) {
-                const r = spawnSync('wl-copy', [], { input: text, encoding: 'utf8', stdio: ['pipe', 'ignore', 'ignore'] });
-                if (!r.error && r.status === 0) return { success: true };
-            }
-            const r = spawnSync('xclip', ['-selection', 'clipboard'], { input: text, encoding: 'utf8', stdio: ['pipe', 'ignore', 'ignore'] });
-            if (!r.error && r.status === 0) return { success: true };
-            const r2 = spawnSync('xsel', ['--clipboard', '--input'], { input: text, encoding: 'utf8', stdio: ['pipe', 'ignore', 'ignore'] });
-            if (!r2.error && r2.status === 0) return { success: true };
-            return { success: false, ...linuxClipboardInfo() };
-        }
-    } catch (_) {
-        return { success: false };
-    }
-}
-
-function showPromptFallback(text) {
-    console.log(chalk.cyan('\n' + '─'.repeat(60)));
-    console.log(text);
-    console.log(chalk.cyan('─'.repeat(60) + '\n'));
-    console.log(chalk.yellow('Clipboard unavailable — paste the prompt above into your AI chat.'));
-}
-
-async function handleClipboardFailure(text, info) {
-    if (!info.pkg) {
-        // Unknown platform failure
-        showPromptFallback(text);
-        return;
-    }
-
-    console.log(chalk.yellow(`\n⚠  Clipboard tool not found (need: ${chalk.white(info.pkg)})`));
-
-    if (!info.installDisplayCmd) {
-        console.log(chalk.gray('   Could not detect a package manager. Install manually:'));
-        console.log(chalk.gray('   Wayland: sudo apt install wl-clipboard'));
-        console.log(chalk.gray('   X11:     sudo apt install xclip\n'));
-        showPromptFallback(text);
-        return;
-    }
-
-    console.log(chalk.gray(`   Install command: ${chalk.white(info.installDisplayCmd)}\n`));
-
-    try {
-        const doInstall = await confirm({
-            message: `Install ${info.pkg} now? (requires sudo)`,
-            default: true,
-        });
-
-        if (doInstall) {
-            console.log(chalk.cyan(`\nRunning: sudo ${info.pkgManager} ${info.installArgs.join(' ')}`));
-            const r = spawnSync('sudo', [info.pkgManager, ...info.installArgs], { stdio: 'inherit' });
-            if (r.status === 0) {
-                const retry = copyToClipboard(text);
-                if (retry.success) {
-                    console.log(chalk.green('\n✓ Installed! Prompt copied to clipboard. Paste it into your AI chat.'));
-                    return;
-                }
-            }
-            console.log(chalk.red('\nInstallation failed. Showing prompt below:'));
-        }
-    } catch (_) {
-        // Non-interactive terminal (piped) — skip the question
-    }
-
-    showPromptFallback(text);
-}
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+const { spawnSync } = require('child_process');
+const { confirm } = require('@inquirer/prompts');
+
+const PROJECT_DIR  = process.cwd();
+const CURRENT_FILE = path.join(PROJECT_DIR, '.aiflow', 'context', 'current.json');
+const RULES_DIR    = path.join(PROJECT_DIR, '.rules');
+
+// Prompt templates per task type
+// Each template includes mandatory superpowers skill invocation steps.
+const PROMPT_TEMPLATES = {
+    'bug-fix': {
+        header: 'Fix Bug',
+        instruction: 'Investigate and fix the bug described below.',
+        skillWorkflow: `
+## STRICT GATE WORKFLOW — Bug Fix
+
+Follow gates IN ORDER. Do NOT skip or merge gates.
+
+### GATE 1 — AI Analyze Requirement
+**INVOKE:** \`read-study-requirement\` skill
+AI must:
+1. Load ticket context + read source code related to the bug
+2. Trace data flow to form root cause hypothesis (\`superpowers:systematic-debugging\`)
+3. If unclear → ask ONE question at a time, wait for reply
+4. Output \`plan/[ticket-id]/requirement.md\` with:
+   - Bug analysis (current vs expected behavior)
+   - Root cause hypothesis with evidence from source code
+   - Proposed fix approach (options if multiple)
+   - Impact analysis — will the fix break anything else?
+   - Effort estimate (S/M/L/XL)
+   - Testing plan (reproduce bug + verify fix)
+5. Display "GATE 1: Requirement doc ready" → wait for **APPROVED**
+
+### GATE 2 — Implementation Plan (wait for APPROVED)
+**INVOKE:** \`generate-spec\` skill → \`superpowers:writing-plans\`
+- Create TDD task breakdown: test to reproduce bug → fix → verify
+- Display: "GATE 2: Plan ready, type APPROVED to start coding"
+- **DO NOT WRITE CODE until APPROVED received**
+
+### GATE 3 — Code (TDD)
+Only runs after Gate 2 APPROVED.
+1. **INVOKE:** \`superpowers:systematic-debugging\` — confirm root cause
+2. **INVOKE:** \`investigate-bug\` skill — trace Controller→Service→Repository
+3. **INVOKE:** \`superpowers:test-driven-development\` — write failing test to reproduce bug
+4. Implement minimal fix to make test pass
+
+### GATE 4 — AI Self-Review (wait for APPROVED)
+**INVOKE:** \`review-plan\` skill
+1. \`superpowers:verification-before-completion\` — all tests PASS (including old tests)
+2. \`impact-analysis\` skill — fix doesn't cause new bugs elsewhere
+3. Tick \`custom/rules/review-checklist.md\`
+4. Create \`plan/[ticket-id]/summary.md\`
+- Display: "GATE 4: type APPROVED or BUG: [description]"
+- Coding bug → fix → repeat Gate 4
+- Requirement bug → back to Gate 1
+
+### GATE 5 — Peer Review & Done
+Only runs after Gate 4 APPROVED.
+**INVOKE:** \`superpowers:requesting-code-review\` → guide PR creation
+`,
+    },
+    'feature': {
+        header: 'Implement Feature',
+        instruction: 'Implement the feature described below following team rules.',
+        skillWorkflow: `
+## STRICT GATE WORKFLOW — Feature
+
+Follow gates IN ORDER. Do NOT skip or merge gates.
+
+### GATE 1 — AI Analyze Requirement
+**INVOKE:** \`read-study-requirement\` skill
+AI must:
+1. Load ticket context + read source code to understand architecture
+2. Investigate related files, data flow, existing patterns
+3. Propose 2-3 solution approaches using Q&A if the problem is complex
+4. If unclear → ask ONE question at a time, wait for reply
+5. Output \`plan/[ticket-id]/requirement.md\` with:
+   - Requirements summary (AI's understanding in technical language)
+   - Source code analysis (related files, data flow, patterns)
+   - Proposed solution with options (recommended + alternatives)
+   - Impact analysis — what areas are affected?
+   - Effort estimate (S/M/L/XL) with task breakdown
+   - Testing plan (unit + integration + manual)
+6. Display "GATE 1: Requirement doc ready" → wait for **APPROVED**
+
+### GATE 2 — Implementation Plan (wait for APPROVED)
+**INVOKE:** \`generate-spec\` skill → \`superpowers:writing-plans\`
+- Create TDD task breakdown: test first → implement → verify
+- Define commit strategy (small, focused)
+- Display: "GATE 2: Plan ready, type APPROVED to start coding"
+- **DO NOT WRITE CODE until APPROVED received**
+
+### GATE 3 — Code (TDD)
+Only runs after Gate 2 APPROVED.
+1. Complex feature (3+ files): **INVOKE:** \`superpowers:subagent-driven-development\`
+2. **INVOKE:** \`superpowers:test-driven-development\` — write failing test first
+3. Implement to make tests pass — verify each small step
+
+### GATE 4 — AI Self-Review (wait for APPROVED)
+**INVOKE:** \`review-plan\` skill
+1. \`superpowers:verification-before-completion\` — all tests PASS
+2. \`impact-analysis\` skill — no regressions
+3. Tick \`custom/rules/review-checklist.md\`
+4. Create \`plan/[ticket-id]/summary.md\`
+- Display: "GATE 4: type APPROVED or BUG: [description]"
+- Coding bug → fix → repeat Gate 4
+- Requirement bug → back to Gate 1
+
+### GATE 5 — Peer Review & Done
+Only runs after Gate 4 APPROVED.
+**INVOKE:** \`superpowers:requesting-code-review\` → guide PR creation
+`,
+    },
+    'investigation': {
+        header: 'Investigate',
+        instruction: 'Investigate the topic described below. Document findings before proposing solutions.',
+        skillWorkflow: `
+## STRICT GATE WORKFLOW — Investigation
+
+Investigation stops at Gate 1 — produce requirement doc with findings only, no coding.
+
+### GATE 1 — AI Analyze & Investigate
+**INVOKE:** \`read-study-requirement\` skill
+AI must:
+1. Load ticket context + read source code thoroughly
+2. **INVOKE:** \`superpowers:systematic-debugging\` — trace through all layers
+3. **INVOKE:** \`investigate-bug\` skill — trace data flow through all layers
+4. If unclear → ask ONE question at a time
+5. Output \`plan/[ticket-id]/requirement.md\` with:
+   - Investigation scope and approach
+   - Source code analysis (all related files traced)
+   - Findings with evidence (log output, code references)
+   - Root cause (if applicable)
+   - Impact analysis — what areas are affected?
+   - Recommendations and next steps
+   - Effort estimate for proposed fix (if applicable)
+6. Display "GATE 1: Investigation complete" → wait for **APPROVED**
+
+**Do NOT implement any fix.** If fix needed → create new ticket → new workflow.
+`,
+    },
+    'refactor': {
+        header: 'Refactor',
+        instruction: 'Refactor the code described below. Behaviour must be preserved.',
+        skillWorkflow: `
+## STRICT GATE WORKFLOW — Refactor
+
+Follow gates IN ORDER. Do NOT skip or merge gates.
+
+### GATE 1 — AI Analyze Requirement
+**INVOKE:** \`read-study-requirement\` skill
+AI must:
+1. Load ticket context + read source code to understand current state
+2. **INVOKE:** \`impact-analysis\` skill — map ALL callers and dependants
+3. If unclear → ask ONE question at a time
+4. Output \`plan/[ticket-id]/requirement.md\` with:
+   - Current state analysis (what exists, what's wrong)
+   - Target state (what it should look like after refactor)
+   - Proposed approach (step-by-step refactor strategy)
+   - Impact analysis — all callers, dependencies, test coverage
+   - Risk assessment — what could break?
+   - Effort estimate (S/M/L/XL)
+5. Display "GATE 1: Requirement doc ready" → wait for **APPROVED**
+
+### GATE 2 — Implementation Plan (wait for APPROVED)
+**INVOKE:** \`generate-spec\` skill → \`superpowers:writing-plans\`
+- Plan: ensure tests cover CURRENT behavior → refactor in steps → verify at each step
+- Display: "GATE 2: Plan ready, type APPROVED to start refactoring"
+- **DO NOT TOUCH CODE until APPROVED received**
+
+### GATE 3 — Refactor (TDD)
+Only runs after Gate 2 APPROVED.
+1. **INVOKE:** \`superpowers:test-driven-development\` — ensure tests cover CURRENT behavior
+2. Refactor incrementally — keep tests green at each step
+3. Commit after manual verification
+
+### GATE 4 — AI Self-Review (wait for APPROVED)
+**INVOKE:** \`review-plan\` skill
+1. \`superpowers:verification-before-completion\` — all tests PASS
+2. \`impact-analysis\` skill — verify no regressions
+3. Tick \`custom/rules/review-checklist.md\`
+4. Create \`plan/[ticket-id]/summary.md\`
+- Display: "GATE 4: type APPROVED or BUG: [description]"
+
+### GATE 5 — Peer Review & Done
+**INVOKE:** \`superpowers:requesting-code-review\` → guide PR creation
+`,
+    },
+    'impact-analysis': {
+        header: 'Impact Analysis',
+        instruction: 'Analyse the scope and impact of the change described below.',
+        skillWorkflow: `
+## STRICT GATE WORKFLOW — Impact Analysis
+
+Impact analysis stops at Gate 1 — produce report only, no coding.
+
+### GATE 1 — AI Analyze & Report
+**INVOKE:** \`read-study-requirement\` skill
+AI must:
+1. Load ticket context + read source code thoroughly
+2. Map all dependencies, callers, services, jobs, tests
+3. If unclear → ask ONE question at a time
+4. Output \`plan/[ticket-id]/requirement.md\` with:
+   - Change description and scope
+   - Dependency map (all callers, services, jobs, tests)
+   - Impact level: 🟢 Low / 🟡 Medium / 🔴 High / 🔥 Critical
+   - Breaking changes list
+   - Affected test coverage
+   - Risk assessment with mitigations
+   - Recommendations
+   - Effort estimate for implementation (if applicable)
+5. Display "GATE 1: Impact report complete" → wait for **APPROVED**
+
+**Do NOT make any code changes.** Implementation needs a separate ticket.
+`,
+    },
+    'documentation': {
+        header: 'Write Documentation',
+        instruction: 'Write documentation for the topic described below.',
+        skillWorkflow: `
+## STRICT GATE WORKFLOW — Documentation
+
+### GATE 1 — AI Analyze Requirement
+**INVOKE:** \`read-study-requirement\` skill
+AI must:
+1. Load ticket context + read source code
+2. Understand what needs to be documented and for whom
+3. If unclear → ask ONE question at a time
+4. Output \`plan/[ticket-id]/requirement.md\` with:
+   - Documentation scope and target audience
+   - Content outline (sections to cover)
+   - Source code references
+   - Effort estimate
+5. Display "GATE 1: Documentation plan ready" → wait for **APPROVED**
+
+### GATE 2 — Write Documentation
+Only runs after Gate 1 APPROVED.
+Read actual code/tests first — docs must reflect real implementation.
+Write documentation based on approved outline.
+
+### GATE 3 — Review (wait for APPROVED)
+**INVOKE:** \`superpowers:verification-before-completion\`
+Verify docs match code. No outdated examples.
+Display: "GATE 3: Documentation complete. Type APPROVED."
+`,
+    },
+};
+
+// ──────────────────────────────────────────────────────────────
+// Entry point
+// ──────────────────────────────────────────────────────────────
+
+module.exports = async function generatePrompt(type, options = {}) {
+    if (options.list) {
+        console.log(chalk.cyan('\nAvailable prompt types:\n'));
+        for (const [key, tpl] of Object.entries(PROMPT_TEMPLATES)) {
+            console.log(`  ${chalk.white(key.padEnd(18))} ${chalk.gray(tpl.instruction.substring(0, 60))}...`);
+        }
+        console.log();
+        return;
+    }
+
+    // Load context
+    let ctx = null;
+    if (await fs.pathExists(CURRENT_FILE)) {
+        ctx = await fs.readJson(CURRENT_FILE).catch(() => null);
+    }
+
+    // Resolve task type: CLI arg > context > ask user to specify
+    const resolvedType = type || ctx?.taskType;
+    if (!resolvedType || !PROMPT_TEMPLATES[resolvedType]) {
+        console.log(chalk.red(`Unknown or missing prompt type: ${resolvedType || '(none)'}`));
+        console.log(chalk.gray('Run: aiflow prompt --list'));
+        return;
+    }
+
+    const template = PROMPT_TEMPLATES[resolvedType];
+    const rules    = await loadRules();
+
+    const env = options.env || 'claude';
+    const prompt = buildPrompt(template, ctx, rules, options, env);
+
+    if (options.output) {
+        await fs.writeFile(options.output, prompt, 'utf-8');
+        console.log(chalk.green(`✓ Prompt saved to: ${options.output}`));
+        return;
+    }
+
+    const clipResult = copyToClipboard(prompt);
+    if (clipResult.success) {
+        const ticket = ctx?.taskId ? chalk.gray(` [${ctx.taskId}]`) : '';
+        console.log(chalk.green(`✓ Prompt copied to clipboard!${ticket} Paste it into your AI chat to begin.`));
+    } else {
+        await handleClipboardFailure(prompt, clipResult);
+    }
+};
+
+// ──────────────────────────────────────────────────────────────
+// Helpers
+// ──────────────────────────────────────────────────────────────
+
+async function loadRules() {
+    if (!(await fs.pathExists(RULES_DIR))) return '';
+
+    const files = (await fs.readdir(RULES_DIR)).filter(f => f.endsWith('.md'));
+    if (!files.length) return '';
+
+    const parts = [];
+    for (const file of files) {
+        const content = await fs.readFile(path.join(RULES_DIR, file), 'utf-8');
+        parts.push(`### ${file}\n${content.trim()}`);
+    }
+    return parts.join('\n\n');
+}
+
+function buildPrompt(template, ctx, rules, options, env = 'claude') {
+    const lang   = options.lang   || 'english';
+    const detail = options.detail || 'standard';
+
+    const lines = [];
+
+    lines.push(`# ${template.header}`);
+    lines.push('');
+    lines.push(`**Task:** ${template.instruction}`);
+    lines.push('');
+
+    // ── Mandatory skill workflow ───────────────────────────────
+    if (template.skillWorkflow) {
+        lines.push(template.skillWorkflow.trim());
+        lines.push('');
+    }
+
+    // ── Telemetry instructions ─────────────────────────────────
+    const ticketArg = ctx?.taskId ? ` --ticket ${ctx.taskId}` : '';
+    const akCmd = isWSL() ? 'ak.cmd' : 'ak';
+    lines.push(`> **Telemetry (required):** When **starting** each gate run \`${akCmd} gate N start${ticketArg}\`. When **APPROVED** run \`${akCmd} gate N approved${ticketArg}\`. Replace N with the gate number (1–5).`);
+    lines.push('');
+
+    // ── Context section ────────────────────────────────────────
+    if (ctx) {
+        lines.push('## Context');
+        lines.push('');
+        lines.push(`- **Ticket:** ${ctx.taskId || 'N/A'}`);
+        lines.push(`- **Title:** ${ctx.title || 'N/A'}`);
+        lines.push(`- **Status:** ${ctx.status || 'N/A'}`);
+        lines.push(`- **Assignee:** ${ctx.assignee || 'N/A'}`);
+        lines.push('');
+
+        if (ctx.description) {
+            lines.push('### Description');
+            lines.push('');
+            lines.push(ctx.description.trim());
+            lines.push('');
+        }
+
+        if (ctx.acceptanceCriteria?.length) {
+            lines.push('### Acceptance Criteria');
+            lines.push('');
+            for (const c of ctx.acceptanceCriteria) {
+                lines.push(`- ${c}`);
+            }
+            lines.push('');
+        }
+
+        if (detail === 'comprehensive' && ctx.comments?.length) {
+            lines.push('### Comments');
+            lines.push('');
+            for (const c of ctx.comments) {
+                lines.push(c);
+                lines.push('');
+            }
+        }
+
+        if (ctx.context?.files?.length) {
+            lines.push('### Related Files Mentioned');
+            lines.push('');
+            for (const f of ctx.context.files) {
+                lines.push(`- \`${f}\``);
+            }
+            lines.push('');
+        }
+    } else {
+        lines.push('> No context loaded. Run `aiflow use <ticket>` to load ticket context.');
+        lines.push('');
+    }
+
+    // ── Rules section ──────────────────────────────────────────
+    if (rules) {
+        lines.push('## Team Rules');
+        lines.push('');
+        lines.push(rules);
+        lines.push('');
+    }
+
+    // ── Language instruction ───────────────────────────────────
+    if (lang === 'vietnamese') {
+        lines.push('> **Reply in English.**');
+        lines.push('');
+    }
+
+    // ── Tool-specific instructions ───────────────────────────────
+    if (env === 'cursor') {
+        lines.push('---');
+        lines.push('> **Cursor Tip:** You can use `@Codebase` to search for more context if needed.');
+    } else if (env === 'gemini') {
+        lines.push('---');
+        lines.push('> **Gemini Tip:** Use the "Upload Files" or "Attach File" feature to provide source code context.');
+    }
+
+    return lines.join('\n');
+}
+
+function isWSL() {
+    if (process.platform !== 'linux') return false;
+    try {
+        const version = require('fs').readFileSync('/proc/version', 'utf-8');
+        return /microsoft|wsl/i.test(version);
+    } catch (_) { return false; }
+}
+
+function detectLinuxPkgManager() {
+    const candidates = [
+        { cmd: 'apt-get', installFlag: 'install -y' },
+        { cmd: 'dnf',     installFlag: 'install -y' },
+        { cmd: 'pacman',  installFlag: '-S --noconfirm' },
+        { cmd: 'zypper',  installFlag: 'install -y' },
+    ];
+    for (const c of candidates) {
+        const r = spawnSync('which', [c.cmd], { stdio: 'ignore' });
+        if (r.status === 0) return c;
+    }
+    return null;
+}
+
+function linuxClipboardInfo() {
+    const isWayland = !!process.env.WAYLAND_DISPLAY;
+    const pkg = isWayland ? 'wl-clipboard' : 'xclip';
+    const mgr = detectLinuxPkgManager();
+    return {
+        pkg,
+        pkgManager: mgr ? mgr.cmd : null,
+        installArgs: mgr ? [...mgr.installFlag.split(' '), pkg] : null,
+        installDisplayCmd: mgr ? `sudo ${mgr.cmd} ${mgr.installFlag} ${pkg}` : null,
+    };
+}
+
+// Returns { success: true } or { success: false, pkg, pkgManager, installArgs, installDisplayCmd }
+function copyToClipboard(text) {
+    try {
+        if (process.platform === 'win32') {
+            spawnSync(
+                'powershell',
+                ['-NoProfile', '-NonInteractive', '-Command',
+                 '[Console]::InputEncoding = [System.Text.Encoding]::UTF8; Set-Clipboard -Value ([Console]::In.ReadToEnd())'],
+                { input: text, encoding: 'utf8', stdio: ['pipe', 'ignore', 'ignore'] }
+            );
+            return { success: true };
+        } else if (process.platform === 'darwin') {
+            spawnSync('pbcopy', [], { input: text, encoding: 'utf8', stdio: ['pipe', 'ignore', 'ignore'] });
+            return { success: true };
+        } else if (isWSL()) {
+            spawnSync(
+                'powershell.exe',
+                ['-NoProfile', '-NonInteractive', '-Command',
+                 '[Console]::InputEncoding = [System.Text.Encoding]::UTF8; Set-Clipboard -Value ([Console]::In.ReadToEnd())'],
+                { input: text, encoding: 'utf8', stdio: ['pipe', 'ignore', 'ignore'] }
+            );
+            return { success: true };
+        } else {
+            // Try wl-copy (Wayland), then xclip, then xsel
+            if (process.env.WAYLAND_DISPLAY) {
+                const r = spawnSync('wl-copy', [], { input: text, encoding: 'utf8', stdio: ['pipe', 'ignore', 'ignore'] });
+                if (!r.error && r.status === 0) return { success: true };
+            }
+            const r = spawnSync('xclip', ['-selection', 'clipboard'], { input: text, encoding: 'utf8', stdio: ['pipe', 'ignore', 'ignore'] });
+            if (!r.error && r.status === 0) return { success: true };
+            const r2 = spawnSync('xsel', ['--clipboard', '--input'], { input: text, encoding: 'utf8', stdio: ['pipe', 'ignore', 'ignore'] });
+            if (!r2.error && r2.status === 0) return { success: true };
+            return { success: false, ...linuxClipboardInfo() };
+        }
+    } catch (_) {
+        return { success: false };
+    }
+}
+
+function showPromptFallback(text) {
+    console.log(chalk.cyan('\n' + '─'.repeat(60)));
+    console.log(text);
+    console.log(chalk.cyan('─'.repeat(60) + '\n'));
+    console.log(chalk.yellow('Clipboard unavailable — paste the prompt above into your AI chat.'));
+}
+
+async function handleClipboardFailure(text, info) {
+    if (!info.pkg) {
+        // Unknown platform failure
+        showPromptFallback(text);
+        return;
+    }
+
+    console.log(chalk.yellow(`\n⚠  Clipboard tool not found (need: ${chalk.white(info.pkg)})`));
+
+    if (!info.installDisplayCmd) {
+        console.log(chalk.gray('   Could not detect a package manager. Install manually:'));
+        console.log(chalk.gray('   Wayland: sudo apt install wl-clipboard'));
+        console.log(chalk.gray('   X11:     sudo apt install xclip\n'));
+        showPromptFallback(text);
+        return;
+    }
+
+    console.log(chalk.gray(`   Install command: ${chalk.white(info.installDisplayCmd)}\n`));
+
+    try {
+        const doInstall = await confirm({
+            message: `Install ${info.pkg} now? (requires sudo)`,
+            default: true,
+        });
+
+        if (doInstall) {
+            console.log(chalk.cyan(`\nRunning: sudo ${info.pkgManager} ${info.installArgs.join(' ')}`));
+            const r = spawnSync('sudo', [info.pkgManager, ...info.installArgs], { stdio: 'inherit' });
+            if (r.status === 0) {
+                const retry = copyToClipboard(text);
+                if (retry.success) {
+                    console.log(chalk.green('\n✓ Installed! Prompt copied to clipboard. Paste it into your AI chat.'));
+                    return;
+                }
+            }
+            console.log(chalk.red('\nInstallation failed. Showing prompt below:'));
+        }
+    } catch (_) {
+        // Non-interactive terminal (piped) — skip the question
+    }
+
+    showPromptFallback(text);
+}