docs: use Docker Compose as primary Quick Start, rename docker scripts

Make Docker Compose the default development path in the README, with a
separate Local Development section for faster Node.js iteration. Add seed
script to both paths. Rename docker:up/docker:down to docker:db:up/docker:db:down
to clarify they only start PostgreSQL for local development.

https://claude.ai/code/session_01JTbjLrkLpw9qMsaLup2Kqa

Author: claude

AGENTS.md

@@ -53,8 +53,8 @@ pnpm check                    # Lint + format
 pnpm test                     # Run all tests
 
 # Docker
-pnpm docker:up                # Start database
-pnpm docker:down              # Stop database
+pnpm docker:db:up             # Start PostgreSQL + PostGIS
+pnpm docker:db:down           # Stop database
 ```
 
 ## Quick Reference

README.md

@@ -13,10 +13,23 @@ A self-hostable web application for relationship management. Think of it as your
 ## Quick Start
 
 ```bash
-# Prerequisites: Node.js 24+, pnpm 8+, PostgreSQL 18+ (or Docker)
+docker compose up -d
+docker compose exec backend pnpm migrate
+docker compose exec backend pnpm seed    # Optional: populate with sample data
+```
+
+The app is available at `http://localhost:8080` (nginx reverse proxy).
+
+## Local Development
+
+For faster iteration on the Node.js apps (hot reload without container overhead):
+
+```bash
+# Prerequisites: Node.js 24+, pnpm 8+
+docker compose up -d
 pnpm install
-pnpm docker:up
 pnpm migrate
+pnpm seed                # Optional: populate with sample data
 pnpm dev
 ```
 

docs/development.md

@@ -37,8 +37,8 @@ pnpm pgtyped:watch          # Watch and regenerate types
 pnpm seed                   # Seed database with test data
 
 # Docker
-pnpm docker:up              # Start Docker services
-pnpm docker:down            # Stop Docker services
+pnpm docker:db:up           # Start PostgreSQL + PostGIS
+pnpm docker:db:down         # Stop Docker services
 ```
 
 ## Git Conventions

package.json

@@ -25,8 +25,8 @@
     "pgtyped": "pnpm --filter backend run pgtyped",
     "pgtyped:watch": "pnpm --filter backend run pgtyped:watch",
     "seed": "pnpm --filter backend run seed",
-    "docker:up": "docker-compose up -d",
-    "docker:down": "docker-compose down",
+    "docker:db:up": "docker compose up postgres -d",
+    "docker:db:down": "docker compose down",
     "prepare": "husky && pnpm --filter frontend run sync",
     "release": "semantic-release",
     "version:sync": "node scripts/sync-versions.mjs",