docs: record POC placement conventions in OQ-TN-10

Worktree/branch for repo-dependent POCs; standalone crate in the
global workspace for self-contained POCs (alknet-channels-poc
precedent); findings always land in docs/research/.
This commit is contained in:
2026-09-06 09:15:24 +00:00
parent 42790797b5
commit 648feb194d
+10 -4
View File
@@ -607,8 +607,14 @@ Phase 0 may need (in rough priority order, per the SDD process's
agnostic" beyond IP substrates.
4. **Two-pump helper extraction spike** — OQ-TN-06, only after 13.
POCs live in `.worktrees/research/<task-id>/` per the SDD process, or as
standalone crates (`/workspace/alknet-channels-poc` precedent).
POC placement conventions (2026-09-05): a POC that needs code from
this repo runs in a worktree/branch (`.worktrees/research/<task-id>/`
per the SDD process); a POC that is self-contained runs as a
standalone crate in the global workspace (the
`/workspace/alknet-channels-poc` precedent) with its findings written
into `docs/research/` here. Both are valid; pick per the POC's
dependency footprint. Findings always land in `docs/research/`
regardless of where the code lives.
**Status:** open — pick 1 (and probably 2) after the research pass;
3 is cheap enough to fold into whichever POC runs first.
@@ -645,9 +651,9 @@ Candidate reading for the research specialist (to be expanded):
## Convergence checklist (what Phase 0 must produce)
- [ ] Survey notes: SSH/SOCKS5/tun2proxy addressing + UDP framing
- [ ] Survey notes: SSH/SOCKS5 addressing + UDP framing
(OQ-TN-01, OQ-TN-02) — tun2proxy UDP gateway done (§Prior art);
SSH/SOCKS5 addressing survey still open
SSH/SOCKS5 survey delegated to research specialist
- [x] Reframe landed (OQ-TN-01) — params = self-contained JSON open-op
object identifying a produced resource + substrate
discriminator (`tcp`/`udp`/extensible); producer owns the