srd-framework

SRD Framework — Synthetic Reality Development

A backwards-from-success product methodology for AI-native development teams. Define what "done" looks like, then reverse-engineer the path to get there.

Built by DojoCodingLabs. Works on any project.

---

What is SRD?

Most products fail not because the code is bad, but because the team is building the wrong things in the wrong order.

SRD flips traditional product development on its head. Instead of starting with features and hoping they lead to revenue, you:

1. Define success first — What does the product look like at $X MRR with real users and real transactions?
2. Simulate the users — Create exhaustive synthetic personas with 6-month lifecycles, financial profiles, and churn risk moments
3. Map the journeys — Trace screen-by-screen what each persona must successfully do
4. Audit the gaps — Cross-reference current state against required journeys to find what's broken
5. Prioritize ruthlessly — Produce machine-readable directives so AI agents and engineers always work on the highest-impact item

The result: a machine-readable operating system for your development team that answers "what should we build next?" with dollar amounts attached.

---

Quick Start

Install

In Claude Code, add the marketplace and install:

# Step 1: Add the SRD Framework marketplace
/plugin marketplace add DojoCodingLabs/srd-framework

# Step 2: Install the plugin
/plugin install srd-framework@srd-framework

For local development:

git clone https://github.com/DojoCodingLabs/srd-framework.git
cd srd-framework
/plugin marketplace add .
/plugin install srd-framework

Update

claude plugin marketplace update DojoCodingLabs/srd-framework
claude plugin update srd-framework@srd-framework

Three Modes

Mode	Command	Best For	Time
Guided Dialogue	/srd:assess	Ideas, PRDs, any project	20-30 min
Autonomous	/srd:generate	Codebases + PRDs	15-20 min
Fast Audit	/srd:quick	Existing codebases	8-12 min

Try It

# On an existing codebase — fast audit
cd your-project
/srd:quick

# Starting from an idea
/srd:assess "A marketplace for freelance developers"

# With a PRD document
/srd:generate docs/product-requirements.md

---

What Gets Generated

Every mode produces 6 files in an srd/ directory at your project root:

1. Success Reality (srd/success-reality.md)

The "6 months in" snapshot — KPIs, revenue breakdown, content volume, and conversion attribution at your target revenue.

| Metric              | Target    | Reasoning                        |
|---------------------|-----------|----------------------------------|
| MRR                 | $50,000   | North star                       |
| Paying users        | 1,000     | 500 Pro + 200 Premium + 300 Free |
| Free-to-paid        | 8%        | Industry avg for B2B SaaS        |
| Monthly churn       | 5%        | Offset by new conversions        |

2. Synthetic Personas (srd/personas.yml)

Exhaustive user archetypes in machine-readable YAML. Each persona includes identity, wallet profile, 6-month lifecycle, revenue/engagement/virality scores, and churn risk moments.

- id: "P01"
  name: "Sarah"
  archetype: "Solo Founder (US)"
  identity:
    age: 29
    location: "Austin, TX"
    background: "Former PM at a SaaS startup. Building her own product."
    goals: "Ship MVP, find first 10 customers, reach $5K MRR"
  wallet_profile:
    income: "$0/month (bootstrapping from savings)"
    plan_progression: "Free (Day 1) -> Pro (Week 2) -> Annual (Month 3)"
    upgrade_trigger: "Hits team collaboration limit on free plan"
    ltv: 588
    user_pct: 15
    revenue_pct: 20

3. Critical Journeys (srd/journeys.md)

Screen-by-screen user journey maps with completion scores. Each step references real routes from your codebase (or [TBD] for ideas).

### J2: Free -> Pro Conversion (Score: 65%)

| Step | User Action               | Route          | What Must Happen               |
|------|--------------------------|----------------|-------------------------------|
| 1    | Hits a Pro-only feature  | /dashboard     | Upgrade modal appears          |
| 2    | Clicks "Upgrade to Pro"  | /pricing       | Plan comparison loads          |
| 3    | Selects Pro plan         | /checkout      | Stripe checkout initializes    |
| 4    | Completes payment        | /checkout      | Subscription activated         |
| 5    | Redirected to dashboard  | /dashboard     | Pro features unlocked          |

4. Gap Audit Matrix (srd/gap-audit.md)

Persona x Journey impact matrix, revenue at risk per broken journey, and a tiered fix list.

### T0: Revenue Blockers ($38,000/mo at risk)