# 🚀 Quickstart: Production-Grade AgentOps
## The "Developer Foundation" (v1.3)

"From `pip install` to `Well-Architected` in 60 seconds."

---

## ⚡ 1. Install & Scaffold

```bash
pip install agentops-cockpit --upgrade
```

### Create a new project (A2UI/React/FastAPI)
```bash
agent-ops create my-agent --ui a2ui
```
*This scaffolds the **Agentic Trinity**: Engine, Face, and Cockpit.*

---

## ⚙️ 2. The Engine (The Brain)
Build your agent logic in `src/agent_ops_cockpit/agent.py`.
- **Middleware**: Every engine comes with `PIIScrubber`, `CostOptimizer`, and `SemanticCache`.
- **Grounding**: wrap outputs in `EvidencePacket` for transparency.

## 🎭 3. The Face (The Interface)
The Face layer uses the **A2UI Protocol** to transform reasoning into rich visual surfaces.
- **Adaptive Surfaces**: UIs that change layout based on tool outputs.
- **Thought visibility**: Real-time streaming of internal "chains of thought."

---

## 🔍 4. The "Aha!" Moment: Your First Audit

```bash
make audit
```
1.  **Architecture Review**: Detects your framework and grades it against the [**Google Well-Architected Framework**](./GOOGLE_ARCHITECTURE.md).
2.  **Fast Red-Team**: Checks for injections and PII leakage.
3.  **Audit-to-Action**: run `agent-ops audit --apply` to automatically harden your code.

---

## 🎮 5. Operational Mission Control
Launch the local dashboard to monitor traces and manage the **Hive Mind Cache**.

```bash
make dev
```
*Visit `localhost:5173/ops` to step into the flight deck.*

---

## 🏁 v1.3 Next Steps
- [ ] **Lead Dev**: Integrate [**A2A Standards**](TECHNICAL_A2A_GUIDE.md).
- [ ] **Security Lead**: Review [**Red Team Hardening**](TECHNICAL_REDTEAM_GUIDE.md).
- [ ] **Ops Engineer**: Deploy to [**Google Cloud Run**](DEPLOYMENT.md).
- [ ] **Principal Architect**: Run a [**Master v1.3 Audit**](TECHNICAL_AUDIT_GUIDE.md).

---
*Generated by the AgentOps Cockpit. Sovereign Systems Division (v1.3).*
