social-app/AGENTS.md

Project Development Guide

This file serves as the entry point for project development, directing to appropriate constraint files based on development context.

Project Structure

social-app/
├── apps/          # Flutter mobile app
├── backend/       # FastAPI backend service
├── infra/         # Infrastructure (Docker, deployment scripts)
└── docs/          # Documentation and design/planning artifacts

Rules Hierarchy

Follow this hierarchy when developing:

~/.config/opencode/AGENTS.md          # Global core rules (skills, agents, process)
├── This file (root AGENTS.md)        # Project-level entry
│   ├── backend/AGENTS.md              # Backend-specific rules
│   └── apps/AGENTS.md                 # Frontend-specific rules

Development Guidance

Development Context	Follow Rules
Backend Python dev	backend/AGENTS.md
Flutter mobile dev	apps/AGENTS.md
Infrastructure/ops	This file + infra/ directory conventions
API doc changes	Sync to docs/runtime/runtime-route.md

Git Workflow

• Default branch: dev
• Feature development: use worktree git worktree add -b feature/xxx ../feature-xxx dev
• Never develop directly on main

Supabase Services

Project uses locally hosted Supabase for development.

• Docker config: infra/docker/docker-compose.yml
• Start services: cd infra/docker && docker compose up -d
• Stop services: cd infra/docker && docker compose down