feat(FN-1397): replace MultiProjectFlow smoke tests with behavior tests

docs/README.md

@@ -20,6 +20,7 @@ For a full walkthrough (installation, onboarding, first task, and lifecycle), st
 |---|---|
 | [Getting Started](./getting-started.md) | Installation, first-run onboarding, first task, and daily workflow basics. |
 | [Architecture](./architecture.md) | System architecture, package layout, storage model, and engine execution flow. |
+| [Memory Plugin Contract](./memory-plugin-contract.md) | Pluggable memory backend architecture, interface contract, and migration strategy. |
 | [CLI Reference](./cli-reference.md) | Complete `fn` command reference with subcommands, flags, and examples. |
 | [Dashboard Guide](./dashboard-guide.md) | Detailed guide to board/list views, terminal, git manager, files, planning, and UI tools. |
 | [Task Management](./task-management.md) | Task creation modes, lifecycle, prompt specs, comments, archiving, and GitHub integration. |

docs/architecture.md

@@ -145,6 +145,17 @@ From `packages/core/src/index.ts` exports:
 - Project memory helpers: `project-memory.ts`, `memory-insights.ts`
 - Migration and compatibility helpers: `db-migrate.ts`, `migration.ts`
 
+### Memory System
+
+Fusion includes a pluggable memory backend system for storing durable project learnings:
+
+- **Two-stage memory**: Working memory (`memory.md`) + distilled insights (`memory-insights.md`)
+- **Plugin architecture**: `MemoryBackend` interface enables alternative storage backends
+- **Settings integration**: `memoryEnabled` toggle controls agent prompt injection
+- **Insight extraction**: Scheduled AI-powered distillation of patterns, principles, pitfalls
+
+See [Memory Plugin Contract](./memory-plugin-contract.md) for the full specification.
+
 ---
 
 ## 5) Engine Package (`@fusion/engine`)