---
title: "memory.wiki — Product Specification"
url: https://memory.wiki/Tk71NDw0
updated: 2026-05-21T02:49:51.771Z
source: "mcp"
---
# memory.wiki — Product Specification

> **Internal spec.** Hand-off document for implementation planning. Defines what "true memory.wiki" means, what's required to honor that promise, and what is explicitly out of scope.
>
> **Author**: strategic conversation between founder + Claude (mdcore1 session)
> **Audience**: implementation session (phase2) + future contributors
> **Status**: draft v0.1 — pending founder lock + scoping to launch window
> **Last updated**: 2026-05-14

---

## 0. TL;DR

`memory.wiki`는 **개인 지식 위키**이면서 동시에 **모든 AI에 deploy 가능한 메모리 레이어**다. 두 문이 하나의 hub에서 만난다.

핵심 약속 한 줄: **"You author. AI uses. The wiki maintains itself."**

이 약속을 정직하게 만들기 위해 현재 mdfy 대비 부족한 것은 — 한 문장으로 — **링크 그래프, 의미 기반 검색, LLM 자가 정리** 셋.

---

## 1. Vision

### 1.1 한 문장 정의

> **memory.wiki는 당신이 author하고, AI가 사용하고, LLM이 스스로 유지하는 개인 위키다.**

### 1.2 Two Doors

| 문 | 약속 | 핵심 행동 |
|---|---|---|
| **Memory door** | "AI가 나를 기억한다" | 1-click capture → URL → paste anywhere |
| **Wiki door** | "내 머릿속이 정리된다" | 자동 concept index, backlinks, search, LLM lint |

### 1.3 Brand Pillars

1. **You author. AI uses.** — AI가 추출하는 게 아니라 사용자가 직접 author/소유.
2. **One URL deploys everywhere.** — Cross-AI, cross-tool, cross-session.
3. **The wiki maintains itself.** — LLM이 정기적으로 정리.
4. **Open spec, not platform lock-in.** — Bundle URL format은 표준, mdcore 엔진은 MIT.

### 1.4 What it is NOT

- ❌ 또 하나의 노트 앱 (Notion, Obsidian)
- ❌ AI-extracted memory (Mem.ai 모델 — 정반대)
- ❌ 기업용 위키 (Confluence)
- ❌ Login wall 뒤의 콘텐츠
- ❌ Vendor lock-in

---

## 2. Product Architecture

### 2.1 4 Primitives

```
Hub                                 ← 사용자 namespace
 ├── Docs                           ← 단일 markdown URL
 │    ├── outbound [[links]]
 │    ├── backlinks (computed)
 │    ├── concepts (LLM-extracted)
 │    └── version history
 ├── Bundles                        ← deployable URL
 │    ├── compact form (?compact=1)
 │    ├── semantic API (?q=...)
 │    └── citations
 └── Concept Index                  ← 자동 생성 색인
```

### 2.2 URL Spec

| URL | 역할 |
|---|---|
| `memory.wiki/{user}` | Hub home |
| `memory.wiki/{user}/{slug}` | 단일 doc |
| `memory.wiki/{user}/b/{bundle}` | Bundle deploy URL |
| `memory.wiki/{user}/c/{concept}` | Concept page |
| `memory.wiki/{user}/llms.txt` | AI-readable hub index |
| `memory.wiki/{user}/search?q=...` | Hub-wide search |
| `memory.wiki/{user}?compact=1` | Token-efficient form |
| `memory.wiki/{user}?q=react&limit=5` | Semantic retrieval |
| `memory.wiki/spec` | 공식 spec 페이지 |

### 2.3 Key User Journeys

1. **First Capture (Memory door)**: ChatGPT 응답 → Chrome ext 1 click → memory.wiki URL → 다른 AI에 paste
2. **Wiki Browse (Wiki door)**: 자기 hub 방문 → Concept Index 자동 → concept 클릭 → 관련 docs + backlinks
3. **Deploy to AI**: Cursor에 *"내 hub 컨텍스트로 작업해"* → Cursor가 native로 memory.wiki/{user} 인지
4. **Self-Maintaining Wiki**: 매일 밤 LLM lint → orphan/duplicate/contradiction surface → morning digest

---

## 3. Required Features (3 tiers)

### Tier 1 — 이름이 거짓말이 되지 않으려면 (Must)

- **[F1] `[[wikilink]]` syntax + auto-resolve** ⭐
- **[F2] Backlinks panel** ⭐
- **[F3] Hub-wide full-text search**
- **[F4] Concept Index (LLM-generated)** ⭐
- **[F5] Semantic Retrieval API** ⭐
- **[F6] llms.txt for hub**
- **[F7] Compact form** (`?compact=1`)
- **[F8] Public spec page** (`memory.wiki/spec`)

### Tier 2 — 깊이 (3개월 내)

- **[F9] AI Wiki Lint** — nightly LLM 작업 (orphan, duplicate, contradiction, stale)
- **[F10] Auto-build** — Chrome ext intelligence layer
- **[F11] Version history UI** with diff
- **[F12] Doc graph view**
- **[F13] Bundle templates**

### Tier 3 — Trust + Network (6개월 내)

- **[F14] Native LLM 인식** ⭐ — Cursor, Claude Skills, Codex, Aider 통합
- **[F15] Verified profiles** — 이메일 + 도메인 인증 → blue check
- **[F16] Inter-hub references** — 다른 hub doc cite
- **[F17] Public hub directory + curation**
- **[F18] Bundle marketplace (fork-able)**

---

## 4. Technical Specs

### 4.1 Core Stack

| Layer | Tech |
|---|---|
| Frontend | Next.js 15 App Router, Tiptap editor, Tailwind |
| Backend | Vercel Functions (Node.js / Fluid Compute) |
| Database | Supabase (Postgres) |
| Search | Postgres full-text → Meilisearch/Typesense |
| Vector store | pgvector — Upstage Solar embeddings |
| Markdown engine | markdown-it (shared) |
| AI | Upstage Solar (primary), Claude (lint), Gemini (fallback) |

### 4.2 AI Integration Patterns

- **Pattern A**: URL paste (current)
- **Pattern B**: llms.txt fetch
- **Pattern C**: MCP server (already shipped)
- **Pattern D**: Native partner integration (target — Cursor, Claude Skills, OpenAI Apps SDK)

---

## 5. Success Criteria

### Product Quality

| Metric | Target |
|---|---|
| Capture speed | < 30초 |
| Concept index coverage | ≥ 80% |
| Backlinks accuracy | ≤ 5% false-positive |
| Search relevance | ≥ 85% |
| Semantic retrieval recall@5 | ≥ 80% |
| LLM lint precision | ≥ 90% |

### Adoption (6개월)

| Metric | Target |
|---|---|
| 활성 public hubs | 1,000+ |
| Hub당 평균 doc | 15+ |
| Native LLM 통합 | 3+ |
| Enterprise PoC | 1+ (Upstage) |

---

## 6. Migration from mdfy.app

```
Primary brand:  memory.wiki
Short URL:      mori.wiki  (이미 확보)
Legacy:         mdfy.app   (1년 이상 redirect 유지)

mori.wiki/{x}    → memory.wiki/{x} (301)
mdfy.app/{x}     → memory.wiki/{x} (301)
mdfy.app/{id}    → memory.wiki/d/{id} (legacy doc URL)
```

---

## 7. Implementation Priority for Launch

### Pre-Launch (~6월 초 HN/PH)
- [F1] wikilink + resolver
- [F2] Backlinks panel
- [F4] Concept Index v1
- [F8] Public spec page

→ 이 4개 ship 직후 **memory.wiki 리브랜드** + HN/PH 런칭

### Post-Launch (6-8월, K-Tech 시작 전)
- [F5] Semantic Retrieval API
- [F11] Version history
- [F12] Doc graph
- [F15] Verified profiles

### K-Tech 6개월 (8-12월)
- [F5] Semantic Retrieval deepening (Solar production)
- [F9] AI Wiki Lint (Solar agent로 — Upstage demo deliverable)
- [F10] Auto-build intelligence
- [F14] Native LLM partner 통합 (3개 목표)

---

## 8. Open Questions

1. Concept extraction frequency: weekly cron vs on-demand vs incremental?
2. Wiki lint opt-in/out granularity?
3. Verified profile criteria?
4. Public hub default: opt-in vs opt-out?
5. Bundle pricing tier 정의?
6. LLM lint auto-apply vs user approval categories?
7. Cross-hub references: 모든 hub? friend graph?
8. Token budget per request — free tier API rate limits?

---

## Glossary

| Term | Definition |
|---|---|
| **Hub** | 한 사용자의 namespace. `memory.wiki/{slug}` |
| **Doc** | 단일 markdown 문서, 영속 URL |
| **Bundle** | 큐레이션된 doc 묶음, 단일 URL deploy |
| **Concept** | LLM이 hub 전체에서 추출한 반복 개념 |
| **Concept Index** | 모든 concept를 모은 자동 생성 페이지 |
| **Wiki Lint** | LLM이 hub 검사하고 정리 제안 |
| **Compact form** | `?compact=1` token-efficient version |
| **Semantic Retrieval** | `?q=...&limit=N` 임베딩 기반 chunk 검색 |
| **llms.txt** | Anthropic 권장 AI-readable hub index |
| **Native partner integration** | LLM tool이 memory URL을 paste 없이 자동 인지 |

---

*— end of spec v0.1 —*

(Full version: `docs/MEMORY-WIKI-SPEC.md` in mdcore repo, commit `7ede8ae3`)