@dedesfr/prompter 0.2.0 → 0.3.0

package/prompt/story-single.md

@@ -0,0 +1,70 @@
+### ✅ **Prompt: Generate a Single Jira Story from QA Prompt**
+
+You are a **Jira expert, senior product manager, and QA analyst**.
+
+Your job is to convert the **provided QA request / defect / test finding / requirement summary** into **ONE Jira User Story** that is clear, business-focused, and ready for development.
+
+---
+
+### 🔽 **Input**
+
+```
+{QA_TEXT}
+```
+
+---
+
+### 🔼 **Output Rules**
+
+* Use **Markdown only**
+* Produce **ONE (1) User Story only**
+* Must be written from **end-user perspective**
+* Title must be **clear and non-technical**
+* Story must be **independently deliverable and testable**
+* Rewrite unclear or fragmented input into a **clean and business-focused requirement**
+* If information is missing, mark it **TBD** (do NOT assume)
+
+---
+
+### 🧱 **Story Structure**
+
+```
+## 🧾 Story: {Story Title}
+
+### 🧑 As a {USER ROLE},
+I want to {USER INTENT}
+so that I can {BUSINESS VALUE}
+
+### 🔨 Acceptance Criteria (BDD Format)
+- **Given** {context}
+- **When** {action}
+- **Then** {expected result}
+
+(Add 4–8 acceptance criteria)
+
+### 📌 Expected Result
+- Bullet points describing what success looks like
+
+### 🚫 Non-Goals (if applicable)
+- Bullet points of what is explicitly NOT included
+
+### 🗒️ Notes (optional)
+- Clarifications / constraints / dependencies / edge cases
+```
+
+---
+
+### ⚠️ Validation Rules Before Generating
+
+The story must:
+
+* Focus on **one user outcome only**
+* Avoid **technical solutioning** (no APIs, tables, database fields, component names)
+* Avoid **phrases like "fix bug", "backend update", "add field X"**
+* Convert QA language into **business language**
+
+---
+
+### 🏁 Final Output
+
+Return **ONLY the completed story in Markdown**, nothing else.

package/src/cli/index.ts

@@ -2,13 +2,14 @@ import { Command } from 'commander';
 import { InitCommand } from '../commands/init.js';
 import { UpdateCommand } from '../commands/update.js';
 import { ListCommand } from '../commands/list.js';
+import { PrdGeneratorCommand } from '../commands/prd-generator.js';
 
 const program = new Command();
 
 program
     .name('prompter')
     .description('Enhance prompts directly in your AI coding workflow')
-    .version('0.1.0');
+    .version('0.3.0');
 
 program
     .command('init')
@@ -37,4 +38,12 @@ program
         await listCommand.execute(options);
     });
 
+program
+    .command('prd-generator')
+    .description('Generate PRD workflow files for configured AI tools')
+    .action(async (options) => {
+        const prdGeneratorCommand = new PrdGeneratorCommand();
+        await prdGeneratorCommand.execute(options);
+    });
+
 program.parse();

package/src/commands/prd-generator.ts

@@ -0,0 +1,118 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+import { PrompterConfig, PROMPTER_DIR, PROMPTER_MARKERS } from '../core/config.js';
+import { registry } from '../core/configurators/slash/index.js';
+
+interface PrdGeneratorOptions {
+    tools?: string[];
+    noInteractive?: boolean;
+}
+
+export class PrdGeneratorCommand {
+    async execute(options: PrdGeneratorOptions = {}): Promise<void> {
+        const projectPath = process.cwd();
+
+        // Check if initialized
+        if (!await PrompterConfig.prompterDirExists(projectPath)) {
+            console.log(chalk.red('\n❌ Prompter is not initialized in this project.\n'));
+            console.log(chalk.gray('   Run `prompter init` first.\n'));
+            process.exitCode = 1;
+            return;
+        }
+
+        console.log(chalk.blue('\n📝 Generating PRD workflow files...\n'));
+
+        // Detect currently configured tools
+        const configuredTools = await this.detectConfiguredTools(projectPath);
+        
+        if (configuredTools.length === 0) {
+            console.log(chalk.yellow('⚠️  No tools configured yet.\n'));
+            console.log(chalk.gray('   Run `prompter init` to configure AI tools first.\n'));
+            process.exitCode = 1;
+            return;
+        }
+
+        // Generate prd-generator workflow files for all configured tools
+        let successCount = 0;
+        let failCount = 0;
+
+        for (const toolId of configuredTools) {
+            const configurator = registry.get(toolId);
+            if (configurator) {
+                try {
+                    // Generate only the prd-generator workflow file
+                    const body = configurator['getBody']('prd-generator');
+                    const relativePath = configurator['getRelativePath']('prd-generator');
+                    const filePath = path.join(projectPath, relativePath);
+                    
+                    // Ensure directory exists
+                    await fs.mkdir(path.dirname(filePath), { recursive: true });
+                    
+                    // Check if file exists
+                    const fileExists = await this.fileExists(filePath);
+                    
+                    if (fileExists) {
+                        console.log(chalk.yellow('⚠️') + ` ${chalk.cyan(relativePath)} already exists, skipping`);
+                        continue;
+                    }
+                    
+                    // Get frontmatter if needed
+                    const frontmatter = configurator['getFrontmatter']('prd-generator');
+                    const sections: string[] = [];
+                    if (frontmatter) {
+                        sections.push(frontmatter.trim());
+                    }
+                    sections.push(`${PROMPTER_MARKERS.start}\n${body}\n${PROMPTER_MARKERS.end}`);
+                    const content = sections.join('\n') + '\n';
+                    
+                    await fs.writeFile(filePath, content, 'utf-8');
+                    console.log(chalk.green('✓') + ` Created ${chalk.cyan(relativePath)}`);
+                    successCount++;
+                } catch (error) {
+                    console.log(chalk.red('✗') + ` Failed to create files for ${toolId}: ${error}`);
+                    failCount++;
+                }
+            }
+        }
+
+        // Success message
+        console.log(chalk.green(`\n✅ PRD generator workflow files created successfully!\n`));
+        console.log(chalk.blue('Next steps:'));
+        console.log(chalk.gray('  1. Use /prd-generator in your AI tool to create PRDs'));
+        console.log(chalk.gray('  2. PRDs will be saved to prompter/<slug>/prd.md\n'));
+    }
+
+    private async fileExists(filePath: string): Promise<boolean> {
+        try {
+            await fs.access(filePath);
+            return true;
+        } catch {
+            return false;
+        }
+    }
+
+    private async detectConfiguredTools(projectPath: string): Promise<string[]> {
+        const configuredTools: string[] = [];
+        const allConfigurators = registry.getAll();
+
+        for (const configurator of allConfigurators) {
+            const targets = configurator.getTargets();
+            let hasFiles = false;
+
+            for (const target of targets) {
+                const filePath = path.join(projectPath, target.path);
+                if (await this.fileExists(filePath)) {
+                    hasFiles = true;
+                    break;
+                }
+            }
+
+            if (hasFiles) {
+                configuredTools.push(configurator.toolId);
+            }
+        }
+
+        return configuredTools;
+    }
+}

package/src/core/configurators/slash/antigravity.ts

@@ -2,11 +2,19 @@ import { SlashCommandConfigurator } from './base.js';
 import { SlashCommandId } from '../../templates/index.js';
 
 const FILE_PATHS: Record<SlashCommandId, string> = {
-    enhance: '.agent/workflows/prompter-enhance.md'
+    enhance: '.agent/workflows/prompter-enhance.md',
+    'prd-generator': '.agent/workflows/prd-generator.md',
+    'epic-single': '.agent/workflows/epic-single.md',
+    'story-single': '.agent/workflows/story-single.md',
+    'qa-test-scenario': '.agent/workflows/qa-test-scenario.md'
 };
 
 const DESCRIPTIONS: Record<SlashCommandId, string> = {
-    enhance: 'Enhance a rough prompt into a professional specification'
+    enhance: 'Enhance a rough prompt into a professional specification',
+    'prd-generator': 'Generate a comprehensive Product Requirements Document (PRD)',
+    'epic-single': 'Generate a single well-defined Jira Epic',
+    'story-single': 'Generate a single Jira User Story from requirements',
+    'qa-test-scenario': 'Generate focused QA test scenarios from PRD'
 };
 
 export class AntigravityConfigurator extends SlashCommandConfigurator {

package/src/core/configurators/slash/base.ts

@@ -9,7 +9,7 @@ export interface SlashCommandTarget {
     kind: 'slash';
 }
 
-const ALL_COMMANDS: SlashCommandId[] = ['enhance'];
+const ALL_COMMANDS: SlashCommandId[] = ['enhance', 'prd-generator', 'epic-single', 'story-single', 'qa-test-scenario'];
 
 export abstract class SlashCommandConfigurator {
     abstract readonly toolId: string;

package/src/core/configurators/slash/claude.ts

@@ -2,11 +2,19 @@ import { SlashCommandConfigurator } from './base.js';
 import { SlashCommandId } from '../../templates/index.js';
 
 const FILE_PATHS: Record<SlashCommandId, string> = {
-    enhance: '.claude/commands/prompter/enhance.md'
+    enhance: '.claude/commands/prompter/enhance.md',
+    'prd-generator': '.claude/commands/prompter/prd-generator.md',
+    'epic-single': '.claude/commands/prompter/epic-single.md',
+    'story-single': '.claude/commands/prompter/story-single.md',
+    'qa-test-scenario': '.claude/commands/prompter/qa-test-scenario.md'
 };
 
 const DESCRIPTIONS: Record<SlashCommandId, string> = {
-    enhance: 'Enhance a rough prompt into a professional specification'
+    enhance: 'Enhance a rough prompt into a professional specification',
+    'prd-generator': 'Generate a comprehensive Product Requirements Document (PRD)',
+    'epic-single': 'Generate a single well-defined Jira Epic',
+    'story-single': 'Generate a single Jira User Story from requirements',
+    'qa-test-scenario': 'Generate focused QA test scenarios from PRD'
 };
 
 export class ClaudeConfigurator extends SlashCommandConfigurator {

package/src/core/configurators/slash/codex.ts

@@ -2,11 +2,19 @@ import { SlashCommandConfigurator } from './base.js';
 import { SlashCommandId } from '../../templates/index.js';
 
 const FILE_PATHS: Record<SlashCommandId, string> = {
-    enhance: '.codex/prompts/prompter-enhance.md'
+    enhance: '.codex/prompts/prompter-enhance.md',
+    'prd-generator': '.codex/prompts/prd-generator.md',
+    'epic-single': '.codex/prompts/epic-single.md',
+    'story-single': '.codex/prompts/story-single.md',
+    'qa-test-scenario': '.codex/prompts/qa-test-scenario.md'
 };
 
 const DESCRIPTIONS: Record<SlashCommandId, string> = {
-    enhance: 'Enhance a rough prompt into a professional specification'
+    enhance: 'Enhance a rough prompt into a professional specification',
+    'prd-generator': 'Generate a comprehensive Product Requirements Document (PRD)',
+    'epic-single': 'Generate a single well-defined Jira Epic',
+    'story-single': 'Generate a single Jira User Story from requirements',
+    'qa-test-scenario': 'Generate focused QA test scenarios from PRD'
 };
 
 export class CodexConfigurator extends SlashCommandConfigurator {

package/src/core/configurators/slash/github-copilot.ts

@@ -2,11 +2,19 @@ import { SlashCommandConfigurator } from './base.js';
 import { SlashCommandId } from '../../templates/index.js';
 
 const FILE_PATHS: Record<SlashCommandId, string> = {
-    enhance: '.github/prompts/prompter-enhance.md'
+    enhance: '.github/prompts/prompter-enhance.md',
+    'prd-generator': '.github/prompts/prd-generator.md',
+    'epic-single': '.github/prompts/epic-single.md',
+    'story-single': '.github/prompts/story-single.md',
+    'qa-test-scenario': '.github/prompts/qa-test-scenario.md'
 };
 
 const DESCRIPTIONS: Record<SlashCommandId, string> = {
-    enhance: 'Enhance a rough prompt into a professional specification'
+    enhance: 'Enhance a rough prompt into a professional specification',
+    'prd-generator': 'Generate a comprehensive Product Requirements Document (PRD)',
+    'epic-single': 'Generate a single well-defined Jira Epic',
+    'story-single': 'Generate a single Jira User Story from requirements',
+    'qa-test-scenario': 'Generate focused QA test scenarios from PRD'
 };
 
 export class GithubCopilotConfigurator extends SlashCommandConfigurator {

package/src/core/configurators/slash/kilocode.ts

@@ -2,11 +2,19 @@ import { SlashCommandConfigurator } from './base.js';
 import { SlashCommandId } from '../../templates/index.js';
 
 const FILE_PATHS: Record<SlashCommandId, string> = {
-    enhance: '.kilocode/workflows/prompter-enhance.md'
+    enhance: '.kilocode/workflows/prompter-enhance.md',
+    'prd-generator': '.kilocode/workflows/prd-generator.md',
+    'epic-single': '.kilocode/workflows/epic-single.md',
+    'story-single': '.kilocode/workflows/story-single.md',
+    'qa-test-scenario': '.kilocode/workflows/qa-test-scenario.md'
 };
 
 const DESCRIPTIONS: Record<SlashCommandId, string> = {
-    enhance: 'Enhance a rough prompt into a professional specification'
+    enhance: 'Enhance a rough prompt into a professional specification',
+    'prd-generator': 'Generate a comprehensive Product Requirements Document (PRD)',
+    'epic-single': 'Generate a single well-defined Jira Epic',
+    'story-single': 'Generate a single Jira User Story from requirements',
+    'qa-test-scenario': 'Generate focused QA test scenarios from PRD'
 };
 
 export class KiloCodeConfigurator extends SlashCommandConfigurator {

package/src/core/configurators/slash/opencode.ts

@@ -2,11 +2,19 @@ import { SlashCommandConfigurator } from './base.js';
 import { SlashCommandId } from '../../templates/index.js';
 
 const FILE_PATHS: Record<SlashCommandId, string> = {
-    enhance: '.opencode/prompts/prompter-enhance.md'
+    enhance: '.opencode/prompts/prompter-enhance.md',
+    'prd-generator': '.opencode/prompts/prd-generator.md',
+    'epic-single': '.opencode/prompts/epic-single.md',
+    'story-single': '.opencode/prompts/story-single.md',
+    'qa-test-scenario': '.opencode/prompts/qa-test-scenario.md'
 };
 
 const DESCRIPTIONS: Record<SlashCommandId, string> = {
-    enhance: 'Enhance a rough prompt into a professional specification'
+    enhance: 'Enhance a rough prompt into a professional specification',
+    'prd-generator': 'Generate a comprehensive Product Requirements Document (PRD)',
+    'epic-single': 'Generate a single well-defined Jira Epic',
+    'story-single': 'Generate a single Jira User Story from requirements',
+    'qa-test-scenario': 'Generate focused QA test scenarios from PRD'
 };
 
 export class OpenCodeConfigurator extends SlashCommandConfigurator {