Add local instaswap E2E workspace harness

README.md

@@ -0,0 +1,28 @@
+# skunk-net-e2e
+
+This repo is the cross-repo local E2E harness for the instant-swap / OPP work.
+
+It is intentionally not a monorepo mirror of the underlying projects. The real
+code stays in the original repos; this workspace repo tracks:
+
+- Docker compose and bootstrap scripts
+- local environment examples
+- protocol notes used for this bring-up
+- a dated checkpoint with the current blocker and reproduction steps
+- the dependency repo matrix and expected branches
+
+## Start Here
+
+1. Read `WORKSPACE-MANIFEST.md`.
+2. Clone each dependency repo into the top-level paths listed there.
+3. Check out the recorded branches in those repos.
+4. Copy `.env.local.example` to `.env.local` if you need overrides.
+5. Use `./local-e2e-up.sh` or the individual commands in `LOCAL-E2E.md`.
+
+## Key Files
+
+- `WORKSPACE-MANIFEST.md`: remotes, branches, and current local heads
+- `CHECKPOINT-2026-04-03.md`: current live state, blocker, and next steps
+- `LOCAL-E2E.md`: bring-up and runtime commands
+- `OPP-COHESIVE-DESIGN.md`: directional OPP design notes
+- `protocol/opp/v1/opp.proto`: shared protobuf draft used for the cohesive design