index 76e0d3f..9a465a8 100644
@@ -10,6 +10,8 @@ A personal variant of [Cortex](https://cortex.ideaflow.app), tuned for one devel
**Status:** Planning phase — no code yet. See [PRD](docs/prd/001-picortex-v1.md) and the [initial roadmap](docs/plans/2026-04-23-initial-roadmap.md).
+> ⚠️ **Architecture provisional (2026-04-23).** This README, the PRD, ADR-0003, and Specs 002/003 describe a tmux-centered single-host design. Later in the same session, Jacob reframed the product as "awesome texting experience" (not dev-surface-first), and [prototype-options.md](docs/plans/2026-04-23-prototype-options.md) reopened the core architecture choice. The tmux path is **one option (#1)** of six under consideration. A [Piyush-era study](docs/wiki/piyush-era-design.md) argues Option 2 (`claude -c -p` per turn, two-box physical split) is probably the better v0.1 shape. Do not start implementation until [Q0-Q4 tickets](https://wikihub.globalbr.ai/@jacobcole/picortex) close and the [reconciliation sweep](https://wikihub.globalbr.ai/@jacobcole/picortex) (picortex-357) rewrites this doc against the chosen option.
+
## Elevator pitch
Cortex (IdeaFlowCo/cortex) has spent the last month solving 90% of the problems this project needs solved — per-chat workspaces, attention gating, scoped tokens, sharing bridge, Linq webhook ingestion, linq-sim dev harness. picortex is a personal spin that keeps Cortex's architecture but:
@@ -49,9 +51,12 @@ Cortex (IdeaFlowCo/cortex) has spent the last month solving 90% of the problems
## Documents
-- `docs/prd/001-picortex-v1.md` — PRD v1
-- `docs/plans/2026-04-23-initial-roadmap.md` — phased roadmap
-- `docs/specs/` — technical specs per subsystem
+- `docs/prd/001-picortex-v1.md` — PRD v1 (provisional)
+- `docs/plans/2026-04-23-initial-roadmap.md` — phased roadmap (Option-1 shape; provisional)
+- `docs/plans/2026-04-23-prototype-options.md` — **the live brainstorm** comparing 6 architecture options
+- `docs/wiki/piyush-era-design.md` — study of pre-container Cortex; source of Option 2
+- `docs/reviews/codex-2026-04-23.md` — codex review of the initial plan
+- `docs/specs/` — technical specs per subsystem (provisional)
- `docs/adrs/` — architecture decisions (one per file, Nygard format)
- `docs/wiki/` — Karpathy-style LLM wiki (concept graph)
- `docs/runbooks/` — ops playbooks
@@ -59,6 +64,11 @@ Cortex (IdeaFlowCo/cortex) has spent the last month solving 90% of the problems
- `CLAUDE.md` → symlink to `AGENTS.md`
- `llms.txt` — LLM sitemap
+### Session history
+- `~/memory/session-logs/2026-04-23-picortex-planning/` — full JSONL session + cleaned transcript + codex's session-level review (`session-review.md`)
+- Public mirror: https://wikihub.globalbr.ai/@jacobcole/picortex
+- Documentation best practices that informed this doc set: `~/memory/research/documentation-best-practices-2026-04-23.md`
+
## Ports
Per [dev-patterns](https://github.com/tmad4000/jacob-computer-config-private) rule: no default ports.