zl-q
e55e445906
- 新增好友搜索、添加、好友列表功能 - 集成 LiteLLM 代理服务及多模型定价配置 - 更新 iOS CocoaPods 配置 - 更新 .gitignore 和环境变量配置
2.0 KiB
2.0 KiB
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:
├── 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 - Never push to remote unless explicitly requested by user
Skills (Domain Knowledge)
| Skill | Purpose | When to Use |
|---|---|---|
| ag-ui | AG-UI protocol for agent-user interaction | Agent chat, streaming events, tool calls, state sync |
| agentscope-skill | AgentScope framework reference and examples | AgentScope multi-agent orchestration, API usage, implementation patterns |
Usage: Reference skills by name (e.g., "use the ag-ui skill") in development rules. Skills provide complete documentation, examples, and best practices.
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