# Trecio Docs

Documentation for the Trecio platform.

---

## 📚 Documentation Index

### Core Docs
- **[ONBOARDING.md](ONBOARDING.md)** — Welcome guide (Slack vs. terminal, how to work with Cleo)
- **[AGENTS.md](AGENTS.md)** — Agent overview, capabilities, rules, development workflow
- **[SETUP.md](SETUP.md)** — How to set up Trecio on a new machine (macOS)
- **[README.md](README.md)** — This file

### Team & Context
- **[team/team2.md](team/team2.md)** — Team 2 (Co-Executive, Platform Architect)
- **[team/team1.md](team/team1.md)** — Team 1 (Co-Executive, Agent Lead)

### Platform Context (Root)
- **[../trecio.md](../trecio.md)** — Full platform vision, goals, business model, principles
- **[../README.md](../README.md)** — Platform overview and folder structure
- **[../core/slack_manifest.json](../core/slack_manifest.json)** — Slack app configuration

### Integration & Services
- **[ARCHITECTURE.md](ARCHITECTURE.md)** — System architecture, data flows, integration points
- **[TWILIO.md](TWILIO.md)** — SMS/voice automation setup and use cases
- **[APIFY.md](APIFY.md)** — Web scraping and sentiment analysis for political sales research
- **[RECEPTION.md](RECEPTION.md)** — Reception agent (IVR, call routing, voicemail, SMS opt-in)

---

## 🚀 Getting Started

**First time here?**
1. Read [AGENTS.md](AGENTS.md) to understand the platform structure
2. Check [team/team2.md](team/team2.md) and [team/team1.md](team/team1.md) for who's building what
3. Review [../trecio.md](../trecio.md) for the full vision

**Setting up on a new machine?**
1. Follow [SETUP.md](SETUP.md) step by step
2. Verify with `openclaw gateway status`
3. Try `@Cleo status` in Slack (if configured)

**Contributing?**
- All agent work goes under `../agents/{agent-name}/`
- All work outputs go under `../projects/`
- Keep `../scratch/` for temporary files only
- See [AGENTS.md](AGENTS.md) for agent specifications

---

## 📁 Folder Structure

```
docs/
├── README.md              ← You are here
├── AGENTS.md              ← Agent specs and development workflow
├── SETUP.md               ← Installation and setup instructions
└── team/                  ← Executive context
    ├── marcus.md
    └── nina.md
```

---

## 🔗 Quick Links

| Resource | Purpose |
|----------|----------|
| [AGENTS.md](AGENTS.md) | Understand each agent's role |
| [SETUP.md](SETUP.md) | New machine? Start here |
| [../trecio.md](../trecio.md) | Platform vision & strategy |
| [../README.md](../README.md) | Platform overview |
| [GitHub Repo](https://github.com/treciolabs/trecio) | Source code |

---

## 💡 For GitHub

When pushing updates to the repo:
- Keep this folder as-is — team context and setup instructions stay current
- Update [AGENTS.md](AGENTS.md) when agent specs change
- Update [../trecio.md](../trecio.md) when platform vision/goals shift
- All work outputs go to `../projects/`, not here
- Never commit secrets — use env vars only

---

## ❓ Questions?

- Check [SETUP.md](SETUP.md) for troubleshooting
- Ask Cleo: `@Cleo help` in Slack or `/btw` in terminal
- Review [../trecio.md](../trecio.md) for platform principles
- Contact Marcus or Nina (see `team/` folder)