mirror of
https://github.com/runbear-io/beardrive.git
synced 2026-08-25 08:08:08 +02:00
19da7dc890
The landing page sells BearDrive Cloud, so it now lives in the private cloud module (web/landing, served by the hub at / for signed-out visitors) instead of this repo. A self-hosted hub should never serve "Start free" CTAs pointing at our managed service, and marketing for the paid product doesn't belong in the AGPL tree. Rebuilt there as an Astro site on the webapp's own design tokens, so the landing and the app stop drifting apart visually. Doc pointers updated to the new location. Claude-Session: https://claude.ai/code/session_01RA5pQH92cxk5SfiYJeTUjK Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
88 lines
4.9 KiB
Markdown
88 lines
4.9 KiB
Markdown
# Spec: GTM readiness for BearDrive (reviewer-satisfied goal loop)
|
||
|
||
Authoritative spec for the GTM improvement loop. The bar is met by
|
||
independent review: a `beardrive-gtm` subagent (COSS operator persona)
|
||
audits the repo's go-to-market surfaces and scores them; the implementing
|
||
agent never scores its own work.
|
||
|
||
## Scope — what the loop may change
|
||
|
||
Everything GTM-relevant that lives in this repo:
|
||
|
||
- `README.md` (positioning, quickstart, time-to-wow, demo assets plan)
|
||
- `cloud/web/landing/` (headline, category claim, CTAs, pricing posture copy —
|
||
cloud-only, served by the hub at its root for signed-out visitors)
|
||
- `docs/` (self-host guide, quickstart, a launch plan, a metrics plan)
|
||
- Community surface: `CONTRIBUTING.md`, `.github/` issue/PR templates,
|
||
`CHANGELOG.md` or release-notes convention, a public `ROADMAP.md`
|
||
- `plugin/` copy where it is a funnel surface (install flow wording)
|
||
- The open↔paid line as *explanation* (docs/website copy about what OSS
|
||
ships vs what beardrive.ai adds)
|
||
|
||
## Hard guardrails (violating any = the round is void)
|
||
|
||
1. **Truth only.** Never fabricate social proof: no invented testimonials,
|
||
logos, user counts, star counts, or benchmarks. Every product claim
|
||
must be verifiable against the code/docs. Aspirations are labeled as
|
||
roadmap, not shipped features.
|
||
2. **No license change, no pricing decisions.** Pricing/packaging content
|
||
is written as clearly-labeled *proposal* for Snow to approve, not
|
||
published as fact.
|
||
3. **No external actions.** No posting, publishing, account creation,
|
||
emailing, or launching anywhere. Anything requiring action outside the
|
||
repo goes to `docs/gtm-handoff.md` — a prioritized checklist for Snow
|
||
(e.g. "post X to HN with this title", "enable GitHub Discussions",
|
||
"record 45s demo of Y") with ready-to-use draft copy where applicable.
|
||
4. Keep README ↔ SKILL.md ↔ CLAUDE.md consistent when CLI behavior is
|
||
described; never commit `internal/webapp/manual_serve_test.go`;
|
||
`go build ./... && go test ./...` stays green if anything code-adjacent
|
||
is touched; frontend changes rebuild committed static.
|
||
5. Branch `feat/gtm-readiness`, commit per round, PR at the end; never
|
||
merge or deploy.
|
||
|
||
## Review protocol (per round)
|
||
|
||
Launch a `beardrive-gtm` subagent. It must score the six dimensions from
|
||
its charter (positioning, funnel, open-vs-paid line, community readiness,
|
||
launch readiness, metrics) 0–10 **on repo-controllable readiness**: "has
|
||
everything within this repo's power been done for this dimension?" —
|
||
external-world gaps (no stars yet, no community yet) do NOT cap the score
|
||
if the corresponding handoff items exist and are well-prepared. It returns
|
||
findings tagged blocker / major / minor, each marked REPO-FIXABLE or
|
||
HANDOFF, with concrete fixes (replacement copy written out).
|
||
|
||
The implementing agent fixes every repo-fixable blocker/major (and minors
|
||
where cheap), routes handoff items into `docs/gtm-handoff.md`, and records
|
||
the round in the Scorecard below.
|
||
|
||
## Exit bar
|
||
|
||
Two CONSECUTIVE review rounds where every dimension scores ≥ 8 and there
|
||
are zero repo-fixable blocker or major findings. Disagreements: the
|
||
reviewer's judgment wins unless it violates a guardrail (e.g. demands
|
||
fabricated proof) — record such rejections under Won't-fix with reasons.
|
||
|
||
## Scorecard (append one row per round)
|
||
|
||
| Round | positioning | funnel | open-paid | community | launch | metrics | repo-fixable blockers/majors |
|
||
|---|---|---|---|---|---|---|---|
|
||
| 1 (baseline) | 6 | 4 | 8 | 3 | 3 | 2 | 3 blockers, 3 majors (all fixed this round; screenshots captured from the live demo hub — real UI, not fabricated) |
|
||
| 2 | 8 | 7 | 9 | 8 | 8 | 8 | 1 major (residual dead-deployment-mode copy ×3 on the site — fixed) + 4 minors fixed; share.png re-captured with real rendered content |
|
||
| 3 | 9 | 7 | 9 | 8 | 7 | 9 | 1 major (quickstart defaulted into the not-yet-live beardrive.ai — quickstart/closer rewritten to self-host-first, first-run gate added to handoff) + README trimmed 583→524, starter-issues & waitlist handoffs added |
|
||
| 4 | 9 | 6 | 9 | 9 | 7 | 9 | 2 majors: bare-login default survived in the README HERO and both plugin commands (+ SKILL walkthrough, website terminal animation) — all four surfaces now self-host-first, fixed this round |
|
||
| 5 | 9 | 8 | 9 | 9 | 8 | 9 | 0 — PASS #1 (two optional one-line minors applied after the round) |
|
||
| 6 (confirmation) | 9 | 8 | 9 | 9 | 8 | 9 | 0 — PASS #2, EXIT BAR MET (truth-verified against code; two optional minors — og:image, SKILL parity — applied post-exit) |
|
||
|
||
## Won't-fix / disputed
|
||
|
||
(none yet)
|
||
|
||
## Status
|
||
|
||
GOAL COMPLETE (2026-07-15): rounds 5 and 6 both scored every dimension
|
||
≥8 with zero repo-fixable blocker/major findings. Six reviewer rounds
|
||
total. The loop's own copy was audited for truth-overreach each round —
|
||
rounds 3 and 4 caught the loop routing strangers into the not-yet-live
|
||
cloud, which is exactly what independent review is for. Remaining work
|
||
is Snow's external checklist: docs/gtm-handoff.md (P0 first).
|