prd-saas-dev

AI Implementation Guide

This directory contains structured, actionable guides for AI agents (Claude, Codex, GPT, etc.) to follow when building SaaS or desktop applications using Spec-Driven Development.

All content is derived from battle-tested practices – not theory.

File Index

File Purpose When to Use
sdd-workflow.md Step-by-step SDD (Spec-Driven Development) execution flow Starting any feature, bug fix, or refactor
tdd-pattern.md Red-Green-Refactor TDD pattern with failure matrix Before writing any implementation code
persona-pain-scenario.md Requirements analysis framework: Persona, Pain, Scenario, Need, Solution Analyzing target users for any product
design-principles.md Design constraint checklist for decision-making Making any design or feature decision
dev-environment.md Three development modes for desktop/hybrid applications Setting up dev workflow for desktop apps
decision-tree.md Technology selection decision tree Choosing frameworks, databases, or architecture
pitfalls.md Common SaaS/desktop development pitfalls and solutions Avoiding known failure modes
agent-routing.md AI agent routing strategy for multi-model development Dispatching tasks to the right AI model
client-discovery-workflow.md Human-AI collaboration protocol for evaluating new prospects When a client lead or external research arrives
client-opportunity-mapping.md Five-step procedure mapping client pain to owned assets Stage 2 of client discovery, before any proposal
right-people-not-right-problems.md Filter clients by execution capacity, not by whether they have problems Stage 0 — before any proposal or external research
templates/native-bridge-template.md IPC bridge template with dev mock support Building desktop apps with web frontends
templates/release-checklist.md Pre-release verification checklist Before any version release

How to Use This Guide

  1. Starting a new feature: Read sdd-workflow.md first, then tdd-pattern.md
  2. Starting a new product: Read persona-pain-scenario.md, then design-principles.md, then decision-tree.md
  3. Setting up development: Read dev-environment.md and templates/
  4. Debugging or stuck: Check pitfalls.md for known failure patterns
  5. Using AI to write code: Read agent-routing.md for multi-model dispatch strategy

Conventions