docs: rewrite PRD, Spec, and Implementation Plan for clarity #1

Merged
pat merged 1 commits from docs/plain-language-rewrite into main 2026-08-26 13:56:33 +00:00
Owner

Plain-language rewrite of the three AIBook.fun planning docs, with a product
review folded in:

  • Name one core loop (read -> run -> share) and a single North-Star metric
    (activation), reported ahead of the fundraising numbers.
  • Layer the product: v1 = the core loop; contributor economy, cohorts,
    agent-onboarding, and the ecosystem funnel become explicit later layers
    instead of co-equal launch goals.
  • Add the "Minimum Lovable Library" launch gate: seed 15-20 tested workflows
    ourselves before asking anyone to pay, rather than betting the launch on the
    crowd filling an empty shelf.
  • Reframe the contributor incentive honestly: today's mechanic is affiliate
    referral, not payment for writing workflows; make paid contribution a
    launch-blocking decision.
  • Force the subscription-vs-lifetime pricing tension into a reasoned decision.
  • Split the product-validation bar from the funding floor ("funded" != validated).
  • Lead the pitch with utility; make ownership the retention layer.
  • Trim governance to the two gates that matter (no-crypto scrub, truth in claims).
  • Turn the domain "decision" into a same-day chore.
  • Translate internal jargon, handles, and merge-history out of the doc bodies.

Old versions preserved in git history; a field-by-field ID mapping can be
produced on request.

Plain-language rewrite of the three AIBook.fun planning docs, with a product review folded in: - Name one core loop (read -> run -> share) and a single North-Star metric (activation), reported ahead of the fundraising numbers. - Layer the product: v1 = the core loop; contributor economy, cohorts, agent-onboarding, and the ecosystem funnel become explicit later layers instead of co-equal launch goals. - Add the "Minimum Lovable Library" launch gate: seed 15-20 tested workflows ourselves before asking anyone to pay, rather than betting the launch on the crowd filling an empty shelf. - Reframe the contributor incentive honestly: today's mechanic is affiliate referral, not payment for writing workflows; make paid contribution a launch-blocking decision. - Force the subscription-vs-lifetime pricing tension into a reasoned decision. - Split the product-validation bar from the funding floor ("funded" != validated). - Lead the pitch with utility; make ownership the retention layer. - Trim governance to the two gates that matter (no-crypto scrub, truth in claims). - Turn the domain "decision" into a same-day chore. - Translate internal jargon, handles, and merge-history out of the doc bodies. Old versions preserved in git history; a field-by-field ID mapping can be produced on request.
pat added 1 commit 2026-08-26 13:55:56 +00:00
Plain-language rewrite of the three AIBook.fun planning docs, with a product
review folded in:

- Name one core loop (read -> run -> share) and a single North-Star metric
  (activation), reported ahead of the fundraising numbers.
- Layer the product: v1 = the core loop; contributor economy, cohorts,
  agent-onboarding, and the ecosystem funnel become explicit later layers
  instead of co-equal launch goals.
- Add the "Minimum Lovable Library" launch gate: seed 15-20 tested workflows
  ourselves before asking anyone to pay, rather than betting the launch on the
  crowd filling an empty shelf.
- Reframe the contributor incentive honestly: today's mechanic is affiliate
  referral, not payment for writing workflows; make paid contribution a
  launch-blocking decision.
- Force the subscription-vs-lifetime pricing tension into a reasoned decision.
- Split the product-validation bar from the funding floor ("funded" != validated).
- Lead the pitch with utility; make ownership the retention layer.
- Trim governance to the two gates that matter (no-crypto scrub, truth in claims).
- Turn the domain "decision" into a same-day chore.
- Translate internal jargon, handles, and merge-history out of the doc bodies.

Old versions preserved in git history; a field-by-field ID mapping can be
produced on request.
pat merged commit 99ca572ab4 into main 2026-08-26 13:56:33 +00:00
Sign in to join this conversation.