diff --git a/README.md b/README.md
index 716c35a..7bc42a7 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,7 @@ Docs:
 - `docs/ROADMAP.md`
 - `docs/REPO_FACTS.json`
 - `docs/NARRATIVE.md`
+- `docs/PORTING_MAP.md`
 
 Quickstart:
 - `python -m afs init --context-root ~/src/context --workspace-name trunk`
diff --git a/docs/PORTING_MAP.md b/docs/PORTING_MAP.md
new file mode 100644
index 0000000..380ce8c
--- /dev/null
+++ b/docs/PORTING_MAP.md
@@ -0,0 +1,39 @@
+# Feature Map (legacy -> current)
+
+Scope: inventory of legacy features and their status in the current AFS/AFS Scawful repos. Use this as a porting checklist; verify specifics when moving code.
+
+Sources (local workspace):
+- Previous core: `trunk/scawful/research/legacy/afs_legacy`
+- Previous plugin: `trunk/scawful/research/legacy/afs_scawful_legacy`
+- Current core: `trunk/scawful/research/afs`
+- Current plugin: `trunk/scawful/research/afs_scawful`
+
+Status legend: Ported, Partial, Planned, Not started.
+
+## AFS Core
+- Context roots + workspace registry: Ported (config + CLI + workspaces.toml). `src/afs/config.py`, `src/afs/cli.py`.
+- Context validation/mapping/policy/graph: Ported. `src/afs/manager.py`, `src/afs/mapping.py`, `src/afs/policy.py`, `src/afs/validator.py`, `src/afs/graph.py`.
+- Discovery + ensure-all: Ported. `src/afs/discovery.py`, `src/afs/cli.py`.
+- Studio UI (ImGui): Ported (apps/studio). Active.
+- CLI surface: Partial (core context + graph + plugins; orchestration/services missing).
+- Plugin framework + adapters: Partial (discovery + load only; adapters not yet).
+- Orchestration/pipelines/swarm: Not started.
+- Service management + daemons: Not started.
+- TUI: Not started.
+- API/backends/integrations/models/llm: Not started.
+- Native/cc/editor tooling: Not started.
+
+## AFS Scawful Plugin
+- Training paths/resources config: Ported. `src/afs_scawful/config.py`.
+- Dataset registry indexing: Ported. `src/afs_scawful/registry.py`, `src/afs_scawful/cli.py`.
+- Resource indexing: Ported. `src/afs_scawful/resource_index.py`, `src/afs_scawful/cli.py`.
+- Training monitor config: Ported (AFS Studio loads plugin config).
+- Validators (ASM/C++/KG/ASAR): Planned.
+- Generators (ASM/Oracle/curated/etc.): Planned.
+- Ops/runbooks/host scripts: Not started (needs reorg as CLI tasks).
+
+## Near-term ports (priority)
+1) Service config + minimal service manager (core).
+2) Orchestrator config + routing skeleton (core).
+3) Validator base + first validators (plugin).
+4) Generator base + one small generator (plugin).
diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md
index b2ea200..a03d228 100644
--- a/docs/ROADMAP.md
+++ b/docs/ROADMAP.md
@@ -1,13 +1,18 @@
 # ROADMAP
 
 ## Committed
-- Minimal module layout + package stubs
-- One small utility
+- Core config + schema + CLI
+- Context manager (init/ensure/mount/list) + discovery + graph export
+- Plugin discovery + load hooks
+- AFS Studio port (ImGui app)
 
 ## Planned
-- Configuration schema
-- Basic CLI entry point
+- Service config + minimal service manager (no auto-start by default)
+- Orchestrator config + routing skeleton
+- TUI starter (status + context browsing)
+- Test harness for core modules
 
 ## Ideas
-- Idea: Status TUI
-- Idea: Plugin discovery via ~/.config/afs/plugins
+- Idea: Full orchestration pipeline (plan/execute/verify) with adapters
+- Idea: Context window builder + token budgeting helpers
+- Idea: Service adapters for launchd/systemd with dry-run previews