shared docs folder

Author: simonredfern

apps/api-manager/CLAUDE.md

@@ -14,15 +14,15 @@
 
 ## Page layout & width
 
-Follow [`page-layout.md`](../../page-layout.md) (repo root — shared with Portal) for content width on pages:
+Follow [`docs/page-layout.md`](../../docs/page-layout.md) (repo root — shared with Portal) for content width on pages:
 
 - Default config/dashboard page wrapper is `container mx-auto max-w-7xl px-4 py-8`.
 - These are API configuration pages, not prose — caps exist to limit eye-scan distance and center content, not to fit small screens.
 - Wide tables / code blocks should break out to full width (and use `overflow-x-auto`) rather than widening the whole page.
 
 ## HTML best practices
 
-Follow the guidelines in [`docs/playwright-friendly-html.md`](docs/playwright-friendly-html.md) when writing or modifying Svelte components:
+Follow the guidelines in [`docs/playwright-friendly-html.md`](../../docs/playwright-friendly-html.md) (repo root — shared with Portal) when writing or modifying Svelte components:
 
 - Add `data-testid` attributes to interactive and assertable elements
 - Use semantic HTML and ARIA labels

apps/portal/CLAUDE.md

@@ -6,15 +6,15 @@ When making client-side calls to the OBP-API, use the generic proxy at `/proxy/o
 
 ## Page Layout & Width
 
-Follow [page-layout.md](../../page-layout.md) (repo root — shared with API Manager) for content width on pages:
+Follow [docs/page-layout.md](../../docs/page-layout.md) (repo root — shared with API Manager) for content width on pages:
 
 - Default config/dashboard page wrapper is `container mx-auto max-w-7xl px-4 py-8`.
 - These are configuration pages, not prose — caps exist to limit eye-scan distance and center content, not to fit small screens.
 - Wide tables / code blocks should break out to full width (and use `overflow-x-auto`) rather than widening the whole page.
 
 ## HTML Best Practices
 
-Follow the guidelines in [docs/playwright-friendly-html.md](docs/playwright-friendly-html.md) when writing HTML. Key points:
+Follow the guidelines in [docs/playwright-friendly-html.md](../../docs/playwright-friendly-html.md) (repo root — shared with API Manager) when writing HTML. Key points:
 
 - Add `data-testid` attributes to interactive and assertable elements
 - Use semantic HTML and ARIA attributes for accessibility and testability