chore: moving towards agentic development

docs/FEATURES/platform-scaffold.md

@@ -0,0 +1,60 @@
+# Feature: Agentic Platform Scaffold
+
+## Status
+
+In Progress
+
+## Goal
+
+Align Socialize with the structure generated by `bootstrap-vdp-agentic.sh` while preserving the current product implementation.
+
+## Backend
+
+The backend is located at:
+
+```txt
+backend/src/Socialize.Api
+```
+
+The solution is:
+
+```txt
+backend/Socialize.slnx
+```
+
+The test project is:
+
+```txt
+backend/tests/Socialize.Tests
+```
+
+## Frontend
+
+The frontend remains the existing Vue 3 app. The scaffold directories `frontend/src/api`, `frontend/src/features`, `frontend/src/pages`, `frontend/src/layouts`, and `frontend/src/app` are available for incremental migration.
+
+## API Contract
+
+OpenAPI workflow:
+
+```bash
+./scripts/update-openapi.sh
+```
+
+Writes:
+
+```txt
+shared/openapi/openapi.json
+frontend/src/api/schema.d.ts
+```
+
+## Done When
+
+- [x] Backend code lives under `backend/src/Socialize.Api`
+- [x] Backend solution exists at `backend/Socialize.slnx`
+- [x] Test project exists under `backend/tests/Socialize.Tests`
+- [x] Root scripts exist
+- [x] Docker Compose and Caddy files exist
+- [x] Agentic docs, specs, tasks, and prompts exist
+- [ ] OpenAPI generation verified against a running backend
+- [x] Backend build passes
+- [x] Frontend build passes