Artifact Market — Product Spec

A marketplace for hosting and viewing production-ready specs (PRDs, technical designs, research, memos). The new artifact type in the dev flow: comprehensive enough for agents, scannable for humans.

---

Core Concept

Problem: PRDs are now 1,000+ lines (for agent consumption), but humans need to grasp the product quickly. Current options (markdown, Notion, PDF) don't bridge this gap.

Solution: A viewer that inverts the typical document experience:

• Traditional: Read doc → find diagrams buried within
• This viewer: See all visuals first → click to get context

Primary insight: "Starting with a picture of it always makes more sense."

---

Artifact Schema

interface Artifact {
  // Identity
  id: string
  title: string
  summary: string  // one-liner
  type: 'prd' | 'technical-design' | 'research' | 'memo'

  // Creator
  creator: Creator | 'anonymous'

  // Structure (Base: Overview → Context → Core → Appendix)
  context: Section
  core: Section[]
  appendix: Section[]

  // Visual Anchors (thumbnails always visible)
  anchors: Anchor[]

  // Process (optional, treated as section for access control)
  chatContext?: Section  // the "making of"
  iterations?: Section

  // Stats (auto-generated)
  stats: {
    lines: number
    sections: number
    anchors: number
    words: number
    messages?: number
    custom: Record<string, number>  // type-specific
  }

  // Access Control
  access: {
    sectionAccess: Record<string, 'free' | 'preview' | 'paid'>
    pricing: {
      amount: number
      currency: string
    }
  }

  // Discovery
  category: string
  tags: string[]
  featured: boolean

  // Versioning
  version: number
  history: ArtifactVersion[]

  // Metadata
  createdAt: Date
  updatedAt: Date
}

---

Artifact Types

PRD Template

Section	Required	Description
Context	✓	Background, why this exists
Problem	✓	What problem are we solving
Solution	✓	How we solve it
Scope	✓	What's in/out for MVP
Wireframes	○	Visual specs, screens
User Flows	○	Journeys, interactions
Psychology/Research	○	Behavioural backing
Risks	○	What could go wrong
Technical Considerations	○	Implementation notes
Open Questions	○	Unresolved decisions

Technical Design Template

Section	Required	Description
Context	✓	Background, why this exists
Problem	✓	Technical challenge being solved
Architecture	✓	System design, components
Data Model	✓	Schema, entities, relationships
APIs	○	Endpoints, contracts
Trade-offs	○	Decisions and alternatives
Security	○	Auth, permissions, vulnerabilities
Performance	○	Scaling, optimisation
Migration	○	Rollout plan, backwards compatibility

Research Template

Section	Required	Description
Context	✓	Background, why this research
Methodology	✓	How the research was conducted
Findings	✓	Key discoveries, data
Recommendations	✓	What to do with the findings
Raw Data	○	Tables, charts, sources
Limitations	○	Caveats, gaps
Next Steps	○	Follow-up research needed

Memo Template

Section	Required	Description
Context	✓	Background, why this memo
Thesis	✓	Core argument/position
Evidence	✓	Supporting data, analysis
Conclusion	✓	Summary, recommendation
Catalysts	○	What could change the thesis
Risks	○	What could go wrong
Valuation	○	Numbers, models
Comparables	○	Related examples, precedents

---

Stats Bar Per Type

Type	Stat 1	Stat 2	Stat 3
PRD	wireframes	sections	lines
Technical Design	diagrams	APIs	lines
Research	charts	sources	findings
Memo	tables	sources	lines

Optional: + N messages if chat context attached.

---

Access Model

Element	Visibility
Title, summary, stats	Always free
Anchor thumbnails (grid)	Always free
Anchor full view	Follows section access
Section content	Per-section (free/preview/paid)
Chat context	Per-section access (if attached)

Paywall UX: Blur + overlay — content visible but obscured, CTA on top.

Single unlock price — one payment unlocks all paid content.

---

Creator Flow

Entry → Choose type → Add content (import/write) → Validate
→ Configure anchors → Configure access/pricing → Preview
→ Publish / Save draft / Share preview

1. Entry: No account required to start
2. Choose type: PRD / Technical Design / Research / Memo
3. Add content: Import markdown OR write in editor
4. Validate: System checks against schema, creator fixes errors
5. Configure anchors: Review auto-extracted, upload additional, reorder
6. Configure access: Per-section free/preview/paid, set price
7. Preview: See as free/preview/paid viewer
8. Publish: Requires account; can also save draft or share preview link

---

Buyer Flow

Discovery → Artifact landing (hero + stats + anchor grid)
→ Explore free content → Hit paywall (blur + overlay)
→ Checkout (Stripe embedded) → Instant unlock
→ Persistence prompt → Account OR magic link recovery

1. Discovery: Shared link OR marketplace browse
2. Landing: Hero + stats bar + anchor thumbnail grid
3. Explore: Click anchors → navigate to sections
4. Paywall: Blur + overlay with price and CTA
5. Checkout: Stripe embedded modal, never leave page
6. Unlock: Instant — blur lifts, continue reading
7. Receipt: Email with magic link for future access
8. Persistence: Account required for cross-device; magic link as fallback

---

Homepage Structure

┌─────────────────────────────────────────────────────────┐
│  NAVBAR (persistent search)                             │
├─────────────────────────────────────────────────────────┤
│  HERO: Featured Carousel (3-5 artifacts)                │
├─────────────────────────────────────────────────────────┤
│  CATEGORIES: PRD / Technical / Research / Memo          │
├─────────────────────────────────────────────────────────┤
│  TRENDING: Artifact cards (thumb + title + stats +      │
│            creator + price)                             │
├─────────────────────────────────────────────────────────┤
│  TOP CREATORS: Creator cards (avatar + name + count)    │
├─────────────────────────────────────────────────────────┤
│  FOOTER                                                 │
└─────────────────────────────────────────────────────────┘

---

Creator Dashboard

Sidebar: Overview / Artifacts / Analytics / Payouts / Settings

Overview shows:

• Earnings: Total + this month + pending + chart
• Recent activity: Sales, views
• Artifacts: Published / Drafts tabs

Per-artifact stats: Views + sales + revenue

Artifact actions: Edit / Delete / Unpublish / Share

---

Buyer Library

• Grid of purchased artifacts
• Cards: Thumbnail + title + creator
• Filter by type + sort + search
• Download for offline (PDF/Markdown)

---

MVP Remaining

• Creator profile page
• Revenue model (platform cut, payouts)
• Auth system
• Notifications

---

Open Questions

• Exact platform cut percentage
• OAuth providers (Google? X? Email only?)
• Notification channels (email? in-app? push?)
• Content moderation approach

---

Last updated: 2026-01-15