# PRODUCTMARKETFIT.md — Stacc Brain
## Thesis
**PMF wedge:** people who already believe in Karpathy’s llm-wiki and **hit the scale wall** on personal comms dumps (Telegram first).
They don’t need education on “second brains.” They need the vault to stay usable when raw is hundreds of thousands of messages — and agents that don’t re-scan the world every turn.
---
## Problem (jobs to be done)
### Functional
- Keep a **compounding** knowledge base (not stateless RAG every time).
- Ingest **Telegram** (export + live) with **full conversation turns**.
- Query fast enough that agents and humans actually use it.
- Surface **counterparties, promises, traps** for adversarial/ops review.
### Emotional
- Trust local / own-the-data (Obsidian, files).
- Avoid “I lost the thread of who promised what.”
- Avoid shame of another abandoned wiki.
### Social
- Teams want a **shared brain** without dumping everyone’s TG into one Discord.
---
## Solution fit
| Need | Fit mechanism | Evidence |
|---|---|---|
| Familiar UI | Obsidian vaults + plugin | vault-a / vault-b shipped |
| Scale query | Holographic index (BrainB) | A/B: ~5k× p50 vs full md scan @ ~321k msgs |
| Compounding wiki | Extractive + redteam ledgers + agent schema | `wiki/people`, `traps/`, `promises/` |
| Live TG | Telethon session, conv-turn filter | `tg_pull_active.py` — 78 active chats / +18k msgs in one pull |
| Hosted groups | Multi-tenant HTTP + keys | `hosted_server.py`, demo tenant |
| Agent-native | AGENTS.md + HTTP query | schema + API |
### Honest non-fits
| Claim we should not make | Why |
|---|---|
| “No LLM needed for compile” | Free prose → structured claims still LLM/human |
| “Hologram beats grep on exact needles” | Planted-string R@1 is A’s game; ship hybrid |
| “We have multi-user OAuth TG product” | User-login Telethon exists; multi-tenant SaaS packaging incomplete |
| “Always-on public demo” | Host must be healthy (`brain.stacc.bio` has timed out from agent env) |
---
## Target market
### Beachhead (now)
- **TG-heavy crypto / builder / ops people** who already use agents daily.
- Already tried Obsidian + Claude/Codex wiki.
- Have Desktop exports or will connect Telethon.
### Expand
- Research / diligence teams
- Small funds with shared intel rooms
- Agent platforms needing **tenant memory** APIs
### Not beachhead
- Casual note-takers who never leave Apple Notes
- Enterprises needing SOC2 day one
- People who want Notion AI with no local files
---
## Value proposition
> **Same Karpathy workflow. Obsidian still the front. Under the hood, a brain that stays fast when your life is 300k Telegram messages — and tags who promised what and what smells like a trap.**
---
## Differentiation
1. **Measured scale cliff** — public A/B artifacts, not vibes.
2. **Obsidian-first GTM** — easier pitch than “custom holographic IDE.”
3. **Redteam ontology** — users / promises / traps as first-class wiki, not only chat search.
4. **Hybrid retrieval** — semantic hologram + exact keyword for needles.
5. **Agent schema** — AGENTS.md so tools behave like wiki maintainers, not chatbots.
---
## Monetization ↔ PMF
| Tier | Who pays | Why now |
|---|---|---|
| Free | Distribution | Learn Karpathy path; feel the cliff |
| Pro | Individuals with fat corpora | A/B shows scan latency; export + hologram is the fix |
| Hosted group | Teams / rooms | Isolation + shared demo narrative |
| Agent metered | Other agents / apps | High-margin cheap reads (roadmap) |
No token required for product narrative.
---
## Activation → retention loop
```
Connect TG or drop export
→ participated filter + full turns
→ raw md + redteam wiki + hologram
→ open Obsidian (A and/or B)
→ query plugin / brain.stacc.bio
→ lint traps & promises
→ live pull keeps it forward-looking
→ agent sessions file answers back
```
**Aha moment:** first query over “whole export” that returns in sub-ms index time *and* opens a real chat with both sides of the conversation.
**Habit moment:** trap/promise ledger catches something before a bad send / bad trust.
---
## Metrics that prove PMF
### North star
**Weekly active brains** that ran ≥1 successful query on a corpus ≥50k messages.
### Input metrics
- Exports completed / Telethon connects
- Chats kept (conv-turn filter)
- Plugin opens / hosted demo searches
### Quality metrics
- A/B p50/p95 (regressed if A wins latency on large N — bug)
- Planted-needle R@1 for hybrid keyword path
- % of queries with ≥1 click-through to raw chat
### Business metrics
- Free → Pro conversion after export size threshold
- Hosted tenants with non-demo keys
- Agent API call volume (later)
---
## Risks
| Risk | Mitigation |
|---|---|
| Privacy / demo optics | Label demo; private tenants default; no accidental public load of private TG |
| Telethon ToS / ban | User-owned sessions; rate limits; document my.telegram.org |
| Hologram quality skepticism | Hybrid keyword; publish A/B; abstain floors |
| Obsidian dependency | Files remain portable; API works without Obsidian |
| Ops burden of hosted | Single binary + Caddy; tenant isolation |
---
## Competitive landscape (short)
- **Karpathy gist clones** — free, no scale story.
- **MindBase / OSS MCP wikis** — md-native, agent-good, still file-scale.
- **Mem0/Zep** — app memory, not Obsidian second brain.
- **We** — Obsidian pitch + hologram scale + TG turns + redteam ledgers + hosted groups.
---
## 90-day PMF plan
| Window | Focus | Exit criterion |
|---|---|---|
| Days 1–30 | Stable demo + A/B public + dual vaults | 10 operators open vault + run query |
| Days 31–60 | Telethon connect UX for *their* accounts | 5 users with live forward ingest |
| Days 61–90 | Hosted private tenants + Pro cliff | 3 paying or LOI group tenants |
---
## Decision log (grounded in build)
| Decision | Why |
|---|---|
| Obsidian as pitch, not pure custom IDE | Easier GTM; user said so |
| Participated + full turns | “Where I chatted” without channel noise; need both sides |
| Redteam users/promises/traps | Adversarial ops value on TG-native users |
| Multi-export (`DataExport_2025` + shebang) | 463-folder dump was incomplete vs ~1.7k chat export |
| Hybrid retrieval | Exact needles ≠ geometry |
| No token in product story | User: we don’t care about $leOS here |
---
## One-paragraph PMF statement
Stacc Brain is for **Telegram-native operators and agent users** who already want a Karpathy llm-wiki in **Obsidian** but choke when raw is **hundreds of thousands of messages**. We keep the Obsidian face, store raw as full conversation turns, compile a **users / promises / traps** wiki, and serve a **holographic index** that is orders of magnitude faster than scanning the vault — with optional **hosted multi-tenant** demo and group brains. PMF is when those operators **weekly query a ≥50k-msg brain** instead of abandoning another markdown wiki.