# 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](backend/AGENTS.md) |
| Flutter mobile dev | [apps/AGENTS.md](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`
- **Never push to remote unless explicitly requested by user**

## 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`