Scenario — standalone clone vs submodule layout

Outcome

You pick a root Lenses should treat as authoritative for scans and docs policy, understanding how submodules appear compared with a flat sibling tree.

Canonical path

Workspace setup — root choice explains trade-offs; pair with Layouts for physical directory shape.

Fixtures

— (layout and git submodule pointers vary by org)

Avoid

• Editing read-only submodule copies inside a consumer repo without promoting changes to the standalone upstream (workspace submodule rules).