docs: initialize project

.planning/PROJECT.md

@@ -0,0 +1,85 @@
+# OnlyPets
+
+## What This Is
+
+OnlyPets is a social platform where pets are the stars. Dogs, cats, and birds get their own profiles — owners manage them, but the pet is the identity. Think Instagram built from the ground up for animals: pets follow each other, post photos and videos, celebrate milestones, and track their health, all within a community that actually cares about animals.
+
+## Core Value
+
+Pets are first-class social identities — not just content on a human's feed — so every feature is built around the pet's life, not the owner's.
+
+## Requirements
+
+### Validated
+
+(None yet — ship to validate)
+
+### Active
+
+- [ ] Owner accounts — sign up, log in, manage their pets
+- [ ] Pet profiles — each pet (dog, cat, or bird) gets its own profile with name, breed, species, and bio
+- [ ] Pet-to-pet follows — pets follow other pets, not owner-to-owner
+- [ ] Content: photo posts with caption
+- [ ] Content: short video posts
+- [ ] Content: stories (24h disappearing)
+- [ ] Content: milestone posts (special format for life events)
+- [ ] Pet milestones — birthday, adoption anniversary, first walk, etc.
+- [ ] Breed & species tags — browse/filter by breed or species
+- [ ] Health & vet tracking — weight logs, vet visits, vaccines; shareable pet health card
+- [ ] Home feed — personalized feed from followed pets
+- [ ] Explore page — discover pets by breed/species
+- [ ] Hashtag & search discovery
+- [ ] Likes & paw-print reactions on posts
+- [ ] Comments on posts
+- [ ] Paw-backs (reposts) — share another pet's post to your own profile
+- [ ] Direct messages between pet profiles (managed by owners)
+
+### Out of Scope
+
+- Reptile & fish profiles — defer until v1 conversion rate justifies expansion
+- Native mobile app (iOS/Android) — web-first for v1; mobile app is a future milestone
+- Paid subscriptions / monetization — not in v1
+
+## Context
+
+- The project name "OnlyPets" signals a pet-exclusive space — no human lifestyle content bleeding in
+- Pets as social identities is the core differentiator from Instagram; the UX should reinforce this (pet name first, owner is "managed by @owner")
+- Content types mirror modern social platforms (photos, short video, stories) so the learning curve is low for Instagram/TikTok users
+- Health tracking is a meaningful differentiator — shareable vet records and milestone history turn the profile into a pet's digital life record
+- Dogs, cats, and birds cover the vast majority of pet-owner households; expansion to reptiles/fish is data-driven
+
+## Constraints
+
+- **Platform**: Web-first (mobile-responsive) for v1 — fastest path to launch; React Native is a future milestone
+- **Pet types**: Dogs, cats, birds only in v1
+- **Media storage**: Requires cloud storage solution for photos/videos (S3-compatible)
+- **Video**: Short-form only — no long-form video to keep storage/bandwidth manageable at launch
+
+## Key Decisions
+
+| Decision | Rationale | Outcome |
+|----------|-----------|---------|
+| Pets as primary identity (not owners) | Differentiates from Instagram; makes the platform about animals, not people | — Pending |
+| Web-first for v1 | Faster to build and iterate; mobile app follows after product-market fit | — Pending |
+| Dogs/cats/birds only in v1 | Covers ~90% of pet owners; cleaner breed/species taxonomy to start | — Pending |
+| All four content types in v1 | Photos + video + stories + milestones gives parity with Instagram expectations | — Pending |
+
+## Evolution
+
+This document evolves at phase transitions and milestone boundaries.
+
+**After each phase transition** (via `/gsd-transition`):
+1. Requirements invalidated? → Move to Out of Scope with reason
+2. Requirements validated? → Move to Validated with phase reference
+3. New requirements emerged? → Add to Active
+4. Decisions to log? → Add to Key Decisions
+5. "What This Is" still accurate? → Update if drifted
+
+**After each milestone** (via `/gsd-complete-milestone`):
+1. Full review of all sections
+2. Core Value check — still the right priority?
+3. Audit Out of Scope — reasons still valid?
+4. Update Context with current state
+
+---
+*Last updated: 2026-06-05 after initialization*