@shahmarasy/prodo 0.1.2 → 0.1.4

package/dist/init.js

@@ -15,6 +15,7 @@ const paths_1 = require("./paths");
 const preset_loader_1 = require("./preset-loader");
 const registry_1 = require("./registry");
 const settings_1 = require("./settings");
+const template_resolver_1 = require("./template-resolver");
 const workflow_commands_1 = require("./workflow-commands");
 const templates_1 = require("./templates");
 function templateFileName(artifactType) {
@@ -272,12 +273,16 @@ async function runInit(cwd, options) {
     await writeFileIfMissing(node_path_1.default.join(root, "hooks.yml"), templates_1.HOOKS_TEMPLATE);
     await writeFileIfMissing(node_path_1.default.join(root, "prompts", "normalize.md"), `${templates_1.NORMALIZE_PROMPT_TEMPLATE}\n`);
     const scriptType = options?.script ?? (process.platform === "win32" ? "ps" : "sh");
-    await promises_1.default.writeFile(node_path_1.default.join(root, "init-options.json"), `${JSON.stringify({ ai: options?.ai ?? null, lang: options?.lang ?? "en", preset: options?.preset ?? null, script: scriptType }, null, 2)}\n`, "utf8");
+    await promises_1.default.writeFile(node_path_1.default.join(root, "init-options.json"), `${JSON.stringify({ ai: options?.ai ?? null, lang: options?.lang ?? "en", author: options?.author ?? null, preset: options?.preset ?? null, script: scriptType }, null, 2)}\n`, "utf8");
     await copyDirIfMissing(node_path_1.default.join(projectScaffoldTemplates, "artifacts"), node_path_1.default.join(root, "templates"), copiedAssets);
     for (const artifact of artifactDefs) {
+        const markdownTemplatePath = node_path_1.default.join(root, "templates", `${artifact.name}.md`);
+        const templateHeadings = (await (0, utils_1.fileExists)(markdownTemplatePath))
+            ? (0, template_resolver_1.extractRequiredHeadingsFromTemplate)(await promises_1.default.readFile(markdownTemplatePath, "utf8"))
+            : [];
         const schema = {
             ...(0, templates_1.schemaTemplate)(artifact.name),
-            x_required_headings: artifact.required_headings
+            x_required_headings: templateHeadings.length > 0 ? templateHeadings : artifact.required_headings
         };
         await writeFileIfMissing(node_path_1.default.join(root, "schemas", `${artifact.name}.yaml`), js_yaml_1.default.dump(schema));
         await writeFileIfMissing(node_path_1.default.join(root, "prompts", `${artifact.name}.md`), `${(0, templates_1.promptTemplate)(artifact.name, options?.lang ?? "en")}\n`);
@@ -322,7 +327,8 @@ async function runInit(cwd, options) {
     await (0, registry_1.syncRegistry)(cwd);
     const settingsPath = await (0, settings_1.writeSettings)(cwd, {
         lang: (options?.lang ?? "en").trim() || "en",
-        ai: options?.ai
+        ai: options?.ai,
+        author: (options?.author ?? "").trim() || undefined
     });
     return { installedAgentFiles, settingsPath };
 }

package/dist/normalize.js

@@ -12,6 +12,53 @@ const paths_1 = require("./paths");
 const providers_1 = require("./providers");
 const settings_1 = require("./settings");
 const utils_1 = require("./utils");
+function normalizedKey(value) {
+    return value
+        .normalize("NFD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .replace(/ı/g, "i")
+        .replace(/İ/g, "I")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, " ")
+        .trim();
+}
+function extractBriefProductName(rawBrief) {
+    const lines = rawBrief.split(/\r?\n/);
+    for (let index = 0; index < lines.length; index += 1) {
+        const headingMatch = lines[index].match(/^\s*#{1,6}\s+(.+?)\s*$/);
+        if (!headingMatch)
+            continue;
+        const headingKey = normalizedKey(headingMatch[1]);
+        const isProductHeading = headingKey === "product name" ||
+            headingKey === "project name" ||
+            headingKey === "urun adi" ||
+            headingKey === "urun ismi";
+        if (!isProductHeading)
+            continue;
+        for (let cursor = index + 1; cursor < lines.length; cursor += 1) {
+            const rawLine = lines[cursor].trim();
+            if (!rawLine)
+                continue;
+            if (/^\s*#{1,6}\s+/.test(rawLine))
+                break;
+            const cleaned = rawLine.replace(/^\s*[-*]\s*/, "").trim();
+            if (cleaned.length > 0)
+                return cleaned;
+        }
+    }
+    return undefined;
+}
+function preserveOriginalProductName(parsed, rawBrief) {
+    const briefProductName = extractBriefProductName(rawBrief);
+    if (!briefProductName)
+        return parsed;
+    const generated = typeof parsed.product_name === "string" ? parsed.product_name : "";
+    if (!generated.trim())
+        return { ...parsed, product_name: briefProductName };
+    if (normalizedKey(generated) !== normalizedKey(briefProductName))
+        return parsed;
+    return { ...parsed, product_name: briefProductName };
+}
 function extractJsonObject(raw) {
     const trimmed = raw.trim();
     const fenced = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/i);
@@ -48,16 +95,17 @@ async function runNormalize(options) {
         requiredContracts: []
     });
     const parsed = extractJsonObject(generated.body);
+    const preserved = preserveOriginalProductName(parsed, rawBrief);
     const withContracts = {
-        ...parsed,
-        contracts: parsed.contracts ??
+        ...preserved,
+        contracts: preserved.contracts ??
             (0, normalized_brief_1.buildContractsFromArrays)({
-                goals: Array.isArray(parsed.goals) ? parsed.goals.filter((x) => typeof x === "string") : [],
-                core_features: Array.isArray(parsed.core_features)
-                    ? parsed.core_features.filter((x) => typeof x === "string")
+                goals: Array.isArray(preserved.goals) ? preserved.goals.filter((x) => typeof x === "string") : [],
+                core_features: Array.isArray(preserved.core_features)
+                    ? preserved.core_features.filter((x) => typeof x === "string")
                     : [],
-                constraints: Array.isArray(parsed.constraints)
-                    ? parsed.constraints.filter((x) => typeof x === "string")
+                constraints: Array.isArray(preserved.constraints)
+                    ? preserved.constraints.filter((x) => typeof x === "string")
                     : []
             })
     };

package/dist/providers/openai-provider.js

@@ -22,7 +22,8 @@ class OpenAIProvider {
         const mode = schemaHint.artifactType;
         const system = mode === "normalize"
             ? `You normalize messy human product briefs into strict JSON.
-Return valid JSON only, no markdown. Include confidence scores (0..1) for critical fields.`
+Return valid JSON only, no markdown. Include confidence scores (0..1) for critical fields.
+Preserve source language and Unicode characters exactly; never transliterate Turkish letters to ASCII.`
             : mode === "semantic_consistency"
                 ? `You detect semantic inconsistencies between paired artifacts.
 Return valid JSON only: { "issues": [{level, code, check, contract_id, file, message, suggestion}] }.`

package/dist/settings.d.ts

@@ -1,6 +1,7 @@
 export type ProdoSettings = {
     lang: string;
     ai?: string;
+    author?: string;
 };
 export declare function readSettings(cwd: string): Promise<ProdoSettings>;
 export declare function writeSettings(cwd: string, settings: ProdoSettings): Promise<string>;

package/dist/settings.js

@@ -20,7 +20,8 @@ async function readSettings(cwd) {
         const parsed = JSON.parse(raw);
         return {
             lang: typeof parsed.lang === "string" && parsed.lang.trim() ? parsed.lang.trim() : "en",
-            ai: typeof parsed.ai === "string" && parsed.ai.trim() ? parsed.ai.trim() : undefined
+            ai: typeof parsed.ai === "string" && parsed.ai.trim() ? parsed.ai.trim() : undefined,
+            author: typeof parsed.author === "string" && parsed.author.trim() ? parsed.author.trim() : undefined
         };
     }
     catch {

package/dist/templates.d.ts

@@ -28,6 +28,6 @@ export declare const NORMALIZED_BRIEF_TEMPLATE: {
         }[];
     };
 };
-export declare const NORMALIZE_PROMPT_TEMPLATE = "Normalize start-brief content into JSON.\n\nReturn JSON object with keys:\n- schema_version (string)\n- product_name (string)\n- problem (string)\n- audience (string[])\n- goals (string[])\n- core_features (string[])\n- constraints (string[])\n- assumptions (string[])\n- contracts.goals[] ({id,text})\n- contracts.core_features[] ({id,text})\n- contracts.constraints[] ({id,text})\n- confidence.product_name (0..1)\n- confidence.problem (0..1)\n- confidence.audience (0..1)\n- confidence.goals (0..1)\n- confidence.core_features (0..1)\n\nRules:\n- do NOT invent missing critical content\n- keep wording concise and concrete\n- if critical field is missing, return empty and low confidence (<0.7)\n- assign deterministic IDs: goals => G1..Gn, features => F1..Fn, constraints => C1..Cn\n- input files are read-only; never modify, summarize, or rewrite `brief.md` in-place\n- write normalized output as a new JSON object only";
+export declare const NORMALIZE_PROMPT_TEMPLATE = "Normalize start-brief content into JSON.\n\nReturn JSON object with keys:\n- schema_version (string)\n- product_name (string)\n- problem (string)\n- audience (string[])\n- goals (string[])\n- core_features (string[])\n- constraints (string[])\n- assumptions (string[])\n- contracts.goals[] ({id,text})\n- contracts.core_features[] ({id,text})\n- contracts.constraints[] ({id,text})\n- confidence.product_name (0..1)\n- confidence.problem (0..1)\n- confidence.audience (0..1)\n- confidence.goals (0..1)\n- confidence.core_features (0..1)\n\nRules:\n- do NOT invent missing critical content\n- keep wording concise and concrete\n- preserve original language and Unicode characters exactly from brief\n- never transliterate Turkish letters (\u00E7, \u011F, \u0131, \u0130, \u00F6, \u015F, \u00FC) into ASCII\n- if critical field is missing, return empty and low confidence (<0.7)\n- assign deterministic IDs: goals => G1..Gn, features => F1..Fn, constraints => C1..Cn\n- input files are read-only; never modify, summarize, or rewrite `brief.md` in-place\n- write normalized output as a new JSON object only";
 export declare function commandTemplate(command: WorkflowCommand): string;
 export declare const HOOKS_TEMPLATE = "# Hook item fields:\n# - command: string (required)\n# - optional: boolean (default false)\n# - enabled: boolean (default true)\n# - condition: shell command; run hook only if condition exits 0\n# - timeout_ms: per-attempt timeout in milliseconds (default 30000)\n# - retry: extra retry count after first attempt (default 0)\n# - retry_delay_ms: delay between retries (default 500)\n#\n# Example:\n# hooks:\n#   before_prd:\n#     - command: \"node -e \\\"console.log('lint ok')\\\"\"\n#       optional: false\n#       enabled: true\n#       condition: \"node -e \\\"process.exit(0)\\\"\"\n#       timeout_ms: 15000\n#       retry: 1\n#       retry_delay_ms: 300\n\nhooks:\n  before_normalize: []\n  after_normalize: []\n  before_prd: []\n  after_prd: []\n  before_workflow: []\n  after_workflow: []\n  before_wireframe: []\n  after_wireframe: []\n  before_stories: []\n  after_stories: []\n  before_techspec: []\n  after_techspec: []\n  before_validate: []\n  after_validate: []\n";

package/dist/templates.js

@@ -338,11 +338,19 @@ Return JSON object with keys:
 Rules:
 - do NOT invent missing critical content
 - keep wording concise and concrete
+- preserve original language and Unicode characters exactly from brief
+- never transliterate Turkish letters (ç, ğ, ı, İ, ö, ş, ü) into ASCII
 - if critical field is missing, return empty and low confidence (<0.7)
 - assign deterministic IDs: goals => G1..Gn, features => F1..Fn, constraints => C1..Cn
 - input files are read-only; never modify, summarize, or rewrite \`brief.md\` in-place
 - write normalized output as a new JSON object only`;
 function commandTemplate(command) {
+    const normalizeJsonGuard = command.cliSubcommand === "normalize"
+        ? `
+- Normalize output format check:
+  - \`.prodo/briefs/normalized-brief.json\` must be strict JSON object (no markdown fences).
+  - If invalid, rewrite file as pure JSON object only.`
+        : "";
     return `---
 description: ${command.description}
 handoffs:
@@ -365,6 +373,8 @@ Execution policy:
 - Never run \`prodo-${command.cliSubcommand}\`, \`prodo ${command.cliSubcommand}\`, or \`prodo ...\` in shell.
 - Do not inspect hooks or internals unless command execution fails.
 - Input files are read-only; never modify or rewrite \`brief.md\`.
+- Never print full artifact content in chat.
+- Write/update files first, then reply with short status + written file path(s).
 
 ## Execution
 
@@ -382,6 +392,7 @@ Execution policy:
 - Confirm command success state (exit code or validation status).
 - Confirm \`brief.md\` hash/content did not change.
 - Do NOT create manual fallback files under \`.prodo/artifact\` or any ad-hoc folder.
+${normalizeJsonGuard}
 
 4. Diagnose only on failure:
 - Inspect \`.prodo/hooks.yml\` only after execution failure.

package/dist/utils.d.ts

@@ -2,5 +2,6 @@ export declare function ensureDir(dirPath: string): Promise<void>;
 export declare function fileExists(filePath: string): Promise<boolean>;
 export declare function readJsonFile<T>(filePath: string): Promise<T>;
 export declare function timestampSlug(date?: Date): string;
+export declare function artifactFileStamp(date?: Date): string;
 export declare function listFilesSortedByMtime(dirPath: string): Promise<string[]>;
 export declare function isPathInside(parentDir: string, candidatePath: string): boolean;

package/dist/utils.js

@@ -7,6 +7,7 @@ exports.ensureDir = ensureDir;
 exports.fileExists = fileExists;
 exports.readJsonFile = readJsonFile;
 exports.timestampSlug = timestampSlug;
+exports.artifactFileStamp = artifactFileStamp;
 exports.listFilesSortedByMtime = listFilesSortedByMtime;
 exports.isPathInside = isPathInside;
 const promises_1 = __importDefault(require("node:fs/promises"));
@@ -30,6 +31,18 @@ async function readJsonFile(filePath) {
 function timestampSlug(date = new Date()) {
     return date.toISOString().replace(/[:.]/g, "-");
 }
+function pad2(value) {
+    return String(value).padStart(2, "0");
+}
+function artifactFileStamp(date = new Date()) {
+    const year = date.getFullYear();
+    const month = pad2(date.getMonth() + 1);
+    const day = pad2(date.getDate());
+    const hour = pad2(date.getHours());
+    const minute = pad2(date.getMinutes());
+    const second = pad2(date.getSeconds());
+    return `${year}${month}${day}-${hour}${minute}${second}`;
+}
 async function listFilesSortedByMtime(dirPath) {
     const exists = await fileExists(dirPath);
     if (!exists)

package/dist/validator.js

@@ -45,10 +45,6 @@ async function validateSchema(cwd, artifactType, doc, requiredHeadingsOverride)
         }
     }
     const sections = (0, markdown_1.sectionTextMap)(doc.body);
-    const trMode = String(doc.frontmatter.language ?? "").toLowerCase().startsWith("tr");
-    if (trMode) {
-        return { issues, requiredHeadings: [] };
-    }
     for (const heading of requiredHeadings) {
         if (!doc.body.includes(heading)) {
             issues.push({

package/dist/workflow-commands.js

@@ -9,7 +9,8 @@ const BASE_WORKFLOW_COMMANDS = [
     { name: "prodo-wireframe", cliSubcommand: "wireframe", description: "Generate wireframe artifact." },
     { name: "prodo-stories", cliSubcommand: "stories", description: "Generate stories artifact." },
     { name: "prodo-techspec", cliSubcommand: "techspec", description: "Generate technical specification artifact." },
-    { name: "prodo-validate", cliSubcommand: "validate", description: "Run schema and cross-artifact consistency validation." }
+    { name: "prodo-validate", cliSubcommand: "validate", description: "Run schema and cross-artifact consistency validation." },
+    { name: "prodo-fix", cliSubcommand: "fix", description: "Auto-fix artifacts based on validation report and brief." }
 ];
 exports.WORKFLOW_COMMANDS = BASE_WORKFLOW_COMMANDS;
 function buildWorkflowCommands(artifactTypes) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shahmarasy/prodo",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "CLI-first, prompt-powered product artifact kit",
   "main": "dist/cli.js",
   "types": "dist/cli.d.ts",

package/presets/fintech/preset.json

@@ -1 +1,48 @@
-{"name":"fintech","priority":1,"min_prodo_version":"0.1.0","version":"1.0.0"}
+{
+  "name": "fintech",
+  "display_name": "Financial Technology (FinTech)",
+  "description": "Comprehensive preset for fintech and financial services products with regulatory compliance, security, and transaction-focused features",
+  "category": "domain-specific",
+  "priority": 1,
+  "min_prodo_version": "0.1.0",
+  "version": "1.0.0",
+  "metadata": {
+    "domain": "Financial Technology",
+    "industry_focus": ["Banking", "Payment Processing", "Investment Management", "Lending", "Crypto/Blockchain"],
+    "compliance_required": ["KYC/AML", "PCI DSS", "SOC 2", "GDPR", "Regulatory Standards"],
+    "security_level": "critical",
+    "data_sensitivity": "highly-sensitive"
+  },
+  "preset_features": {
+    "domain_expertise": [
+      "Regulatory compliance (KYC, AML, SCA)",
+      "Security & encryption standards",
+      "Payment gateway integration",
+      "Transaction management & reconciliation",
+      "Risk management & fraud detection",
+      "Audit trails & compliance reporting"
+    ],
+    "templates_included": ["prd"],
+    "context_enrichment": {
+      "user_personas": ["Compliance Officer", "Risk Manager", "Treasury Manager", "Customer Service", "Auditor"],
+      "success_metrics": ["Compliance rate", "Transaction volume", "Fraud detection rate", "Settlement time", "System uptime"],
+      "constraints": ["Regulatory deadlines", "Security mandates", "Data residency", "Transaction limits", "Audit requirements"]
+    }
+  },
+  "agent_requirements": {
+    "required_expertise": [
+      "Financial services domain knowledge",
+      "Regulatory compliance understanding",
+      "Security-first mindset",
+      "Risk assessment capability"
+    ],
+    "recommended_agents": ["Product Manager (Finance)", "Compliance Specialist", "Security Architect"],
+    "critical_validation": ["Compliance checklist", "Security review", "Risk assessment"]
+  },
+  "prompt_configuration": {
+    "tone": "Professional, compliance-focused, security-conscious",
+    "terminology_style": "industry-standard (fintech, KYC, AML, SCA, PCI DSS)",
+    "risk_tolerance": "zero-tolerance for security/compliance violations",
+    "documentation_level": "comprehensive (audit trail required)"
+  }
+}

package/presets/fintech/prompts/prd.md

@@ -1,3 +1,100 @@
-Preset: fintech
+# Fintech Preset - PRD Generation Context
 
-Use domain-specific terminology and constraints for fintech products.
+## Preset Overview
+**Domain**: Financial Technology (FinTech)
+**Focus**: Regulatory compliance, security, transaction integrity, fraud prevention
+**Target Industries**: Banking, Payment Processing, Investment Management, Lending, Blockchain
+
+## Critical Requirements for FinTech Products
+
+### 1. Regulatory Compliance
+- **KYC/AML**: Know Your Customer, Anti-Money Laundering regulations
+- **PCI DSS**: Payment Card Industry Data Security Standard (Level 1-4)
+- **SOC 2**: System and Organization Controls compliance
+- **GDPR/Regional**: Data privacy and regional financial regulations
+- **Audit Trail**: Complete transaction and action audit logs required
+
+### 2. Security Requirements
+- **Encryption**: End-to-end encryption for sensitive data (at-rest & in-transit)
+- **Authentication**: Multi-factor authentication (MFA) mandatory
+- **Authorization**: Role-based access control (RBAC) with least privilege
+- **Fraud Detection**: Real-time anomaly detection and transaction monitoring
+- **Penetration Testing**: Regular security audits and penetration tests
+
+### 3. Transaction Management
+- **Settlement**: Fast settlement with reconciliation (T+0, T+1, etc.)
+- **Atomicity**: All-or-nothing transaction guarantees
+- **Idempotency**: Prevent duplicate transactions
+- **Error Handling**: Graceful failures with clear audit trails
+- **Dispute Resolution**: Clear process for chargebacks and disputes
+
+### 4. Risk Management
+- **Fraud Detection**: ML-based anomaly detection and rule engines
+- **Risk Assessment**: Transaction risk scoring and limits
+- **Compliance Monitoring**: Continuous regulatory compliance monitoring
+- **Incident Response**: Clear escalation and response procedures
+- **Business Continuity**: Disaster recovery and failover strategies
+
+### 5. User Personas (FinTech Specific)
+- **Compliance Officer**: Regulatory requirements, audit trails, risk reporting
+- **Risk Manager**: Fraud patterns, transaction limits, risk scoring
+- **Treasury Manager**: Settlement timing, liquidity management, cash flow
+- **Customer Service**: Transaction history, dispute handling, user support
+- **Auditor**: Complete audit trails, compliance reports, system integrity
+
+### 6. Success Metrics (FinTech Specific)
+- **Compliance Rate**: 100% regulatory adherence (zero violations target)
+- **Transaction Volume**: Daily/monthly transaction throughput
+- **Fraud Detection Rate**: % of fraudulent transactions caught pre-settlement
+- **Settlement Speed**: Average time to settlement completion
+- **System Uptime**: 99.99%+ availability (critical infrastructure)
+- **Customer Trust**: Chargeback rate, dispute resolution time
+
+### 7. Key Constraints
+- **Regulatory Deadlines**: Compliance cutoffs, reporting deadlines
+- **Data Residency**: Geographic restrictions on data storage
+- **Transaction Limits**: Daily/monthly limits per user/transaction type
+- **Integration Requirements**: Payment gateways, banking APIs, clearing houses
+- **Audit Requirements**: Immutable logs, compliance reports, regulatory filings
+
+## PRD Generation Guidelines
+
+### Domain-Specific Terminology
+Use fintech-standard terminology:
+- KYC (Know Your Customer) vs. identity verification
+- AML (Anti-Money Laundering) vs. fraud prevention
+- SCA (Strong Customer Authentication) vs. verification
+- PCI DSS (Payment Card Industry Standard) vs. security
+- Settlement vs. transaction completion
+- Reconciliation vs. balance verification
+
+### Feature Prioritization
+1. **Compliance first**: All features must meet regulatory requirements
+2. **Security second**: Security cannot be compromised for features
+3. **User experience**: Within compliance and security boundaries
+4. **Performance**: Transaction speed critical for user satisfaction
+
+### Risk Assessment
+Flag high-risk features:
+- ⚠️ Features involving cross-border transactions
+- ⚠️ Features with regulatory uncertainty
+- ⚠️ Features with no clear audit trail mechanism
+- ⚠️ Features involving sensitive financial data
+
+### Documentation Standards
+- **Compliance Mapping**: Each feature → applicable regulations
+- **Security Justification**: Why security approach chosen
+- **Audit Trail**: How feature activities are logged
+- **Error Scenarios**: Failure modes and recovery
+- **Rollback Strategy**: How to undo transactions if needed
+
+## Validation Checklist
+Before finalizing PRD, verify:
+- ✅ All features have compliance mapping
+- ✅ Security requirements explicitly stated
+- ✅ Audit trail mechanisms defined
+- ✅ Risk assessment completed
+- ✅ Regulatory deadlines documented
+- ✅ User personas fintech-specific
+- ✅ Success metrics measurable
+- ✅ Escalation procedures clear

package/presets/marketplace/preset.json

@@ -1 +1,51 @@
-{"name":"marketplace","priority":1,"min_prodo_version":"0.1.0","version":"1.0.0"}
+{
+  "name": "marketplace",
+  "display_name": "Multi-Sided Marketplace",
+  "description": "Comprehensive preset for marketplace platforms with multi-stakeholder support, trust mechanisms, commission systems, and community features",
+  "category": "domain-specific",
+  "priority": 1,
+  "min_prodo_version": "0.1.0",
+  "version": "1.0.0",
+  "metadata": {
+    "domain": "E-Commerce & Marketplace",
+    "industry_focus": ["B2C Marketplace", "C2C Marketplace", "Gig Economy", "Subscription Services", "SaaS Marketplace"],
+    "marketplace_model": ["commission-based", "subscription-based", "freemium", "hybrid"],
+    "key_complexity": "multi-stakeholder coordination",
+    "trust_requirement": "critical"
+  },
+  "preset_features": {
+    "domain_expertise": [
+      "Multi-stakeholder coordination (buyers, sellers, platform)",
+      "Trust & safety mechanisms (verification, reviews, ratings)",
+      "Commission & payment systems",
+      "Dispute resolution & conflict management",
+      "Community moderation & content policies",
+      "Recommendation algorithms & discovery",
+      "Supply & demand balancing",
+      "Seller onboarding & quality assurance"
+    ],
+    "templates_included": ["prd"],
+    "context_enrichment": {
+      "user_personas": ["Buyer", "Seller", "Platform Operator", "Support Agent", "Community Moderator"],
+      "success_metrics": ["Gross merchandise volume (GMV)", "Seller growth rate", "Customer retention", "Review authenticity", "Dispute rate"],
+      "constraints": ["Trust & safety standards", "Commission structure", "Seller quality", "Fraud prevention", "Community guidelines"]
+    }
+  },
+  "agent_requirements": {
+    "required_expertise": [
+      "Multi-sided marketplace dynamics",
+      "Trust and safety framework design",
+      "Seller quality management",
+      "Community management",
+      "Conflict resolution strategies"
+    ],
+    "recommended_agents": ["Platform PM", "Trust & Safety Lead", "Seller Success Manager", "Community Manager"],
+    "critical_validation": ["Trust scoring mechanism", "Dispute resolution process", "Seller quality criteria"]
+  },
+  "prompt_configuration": {
+    "tone": "Community-focused, trust-centered, multi-perspective",
+    "stakeholder_focus": ["buyer-experience", "seller-success", "platform-sustainability"],
+    "conflict_resolution": "fair-for-all-parties",
+    "documentation_level": "detailed (policies and procedures required)"
+  }
+}

package/presets/marketplace/prompts/prd.md

@@ -1,3 +1,141 @@
-Preset: marketplace
+# Marketplace Preset - PRD Generation Context
 
-Use domain-specific terminology and constraints for marketplace products.
+## Preset Overview
+**Domain**: Multi-Sided Marketplace
+**Focus**: Trust & safety, multi-stakeholder coordination, sustainable growth, community health
+**Target Models**: B2C, C2C, Gig Economy, Subscription, SaaS Marketplaces
+
+## Critical Requirements for Marketplace Products
+
+### 1. Multi-Stakeholder Coordination
+- **Buyers**: Search, discovery, purchasing, reviews, ratings
+- **Sellers**: Listing creation, inventory management, order fulfillment
+- **Platform**: Commission structure, dispute resolution, policy enforcement
+- **Moderators**: Content review, policy compliance, community health
+- **Support**: Buyer/seller support, dispute handling, escalations
+
+### 2. Trust & Safety Mechanisms
+- **Identity Verification**: Seller verification, buyer profiles, trust scoring
+- **Review System**: Authentic reviews, review moderation, rating accuracy
+- **Dispute Resolution**: Clear process, fair arbitration, appeal mechanisms
+- **Fraud Prevention**: Transaction monitoring, chargeback protection, seller vetting
+- **Community Standards**: Content policies, community guidelines, enforcement
+
+### 3. Commission & Payment Systems
+- **Revenue Model**: Commission % for platform sustainability
+- **Payment Processing**: Buyer payments, seller payouts, tax handling
+- **Pricing Strategy**: Dynamic pricing, surge pricing, discounts
+- **Seller Incentives**: Top performer rewards, quality bonuses
+- **Payout Timing**: Immediate, delayed, or tiered payout options
+
+### 4. Seller Quality Assurance
+- **Onboarding**: Seller verification, document collection, quality baseline
+- **Performance Metrics**: Response rate, cancellation rate, rating average
+- **Quality Enforcement**: Warnings, suspensions, bans for policy violations
+- **Support**: Seller success resources, training, API documentation
+- **Tiering**: Seller levels (new, standard, gold, platinum) with benefits
+
+### 5. Discovery & Matching
+- **Search**: Full-text search, filters, sorting
+- **Recommendations**: ML-based recommendations, personalization
+- **Trending**: What's hot, seasonal items, category trending
+- **Supply/Demand**: Balancing supply scarcity with buyer demand
+- **Ranking Algorithm**: Fair ranking, preventing gaming, transparency
+
+### 6. Community Moderation
+- **Content Review**: Image verification, description moderation
+- **Review Management**: Review authenticity, spam detection, manipulation prevention
+- **User Behavior**: Community standards, suspension/ban procedures
+- **Appeal Process**: Fair appeals, transparency, communication
+- **Transparency**: Clear policies, community guidelines, moderation appeals
+
+### 7. User Personas (Marketplace Specific)
+
+#### Buyer Persona
+- Goals: Find best products, competitive prices, fast delivery
+- Pain Points: Counterfeit items, long delivery, poor service
+- Concerns: Trust in seller, payment security, return policies
+
+#### Seller Persona
+- Goals: Reach customers, maximize revenue, sustainable growth
+- Pain Points: Finding customers, competition, payment processing
+- Concerns: Commission rates, policy changes, fair treatment
+
+#### Platform Operator
+- Goals: Sustainable growth, healthy marketplace, stakeholder satisfaction
+- Pain Points: Balancing buyer/seller interests, fraud, legal compliance
+- Concerns: GMV growth, trust metrics, user satisfaction
+
+#### Support Agent
+- Goals: Resolve disputes fairly, maintain trust, reduce escalations
+- Pain Points: Complex disputes, policy ambiguity, seller/buyer conflicts
+- Concerns: Fair resolution, quick closure, customer satisfaction
+
+#### Community Moderator
+- Goals: Maintain community standards, prevent abuse, engage users
+- Pain Points: Volume of content, policy interpretation, false positives
+- Concerns: Bias, false negatives, user resentment
+
+### 8. Success Metrics (Marketplace Specific)
+- **Gross Merchandise Volume (GMV)**: Total transaction value
+- **Seller Growth**: New sellers, active sellers, seller satisfaction
+- **Customer Retention**: Repeat purchase rate, churn rate
+- **Review Authenticity**: % of authentic reviews (fraud detection rate)
+- **Dispute Rate**: Disputes as % of transactions (lower is better)
+- **Trust Score**: Buyer trust in platform, Net Promoter Score (NPS)
+- **Seller Health**: Average seller rating, suspension rate, appeal rate
+- **Community Health**: Content removal rate, user suspension rate, community satisfaction
+
+### 9. Key Constraints
+- **Commission Structure**: Sustainable for platform, fair to sellers
+- **Payout Timing**: Fast enough for seller satisfaction, safe for platform
+- **Dispute Deadlines**: Quick resolution, legal time requirements
+- **Content Policies**: Clear standards, consistent enforcement
+- **Data Privacy**: PII protection, transaction privacy, seller anonymity options
+- **Regulatory**: Tax collection, consumer protection, local regulations
+
+## PRD Generation Guidelines
+
+### Multi-Stakeholder Perspective
+Always consider impact on:
+- ✅ Buyers: Is this feature valuable and trustworthy?
+- ✅ Sellers: Is this feature fair and sustainable?
+- ✅ Platform: Does this drive growth and profitability?
+- ✅ Community: Does this maintain or improve community health?
+
+### Trust-First Approach
+- Every feature must enhance or maintain trust
+- Transparency over features
+- Fair treatment over growth hacks
+- Community health over short-term metrics
+
+### Commission & Pricing
+- Make commission % explicit in documentation
+- Justify pricing to both buyers and sellers
+- Show how platform uses commissions
+- Consider seller profitability models
+
+### Dispute Resolution
+- Clear escalation paths
+- Fair arbitration criteria
+- Appeal mechanisms
+- Transparent timeline
+
+### Seller Success
+- Onboarding clear and supportive
+- Performance metrics transparent
+- Success resources available
+- Fair quality enforcement
+
+## Validation Checklist
+Before finalizing PRD, verify:
+- ✅ All stakeholders considered (buyer, seller, platform, moderator, support)
+- ✅ Trust mechanisms clearly defined
+- ✅ Commission structure documented
+- ✅ Dispute resolution process outlined
+- ✅ Seller quality criteria explicit
+- ✅ Community guidelines clear
+- ✅ Payment flow documented (buyer → platform → seller)
+- ✅ Moderation policies defined
+- ✅ Fairness across stakeholders assessed
+- ✅ Scalability for growth considered