Best Practices
This section is the rulebook for building, operating, debugging, and scaling the OpenSIN fleet. It is not a loose suggestion shelf. It is the operational memory of the system.
Core Mandates
| Document | Focus |
|---|---|
| Agent Design | Ultimate fleet mandates, no-silo rules, self-healing, test-proof culture |
| Code Quality | Extreme commenting mandate, anti-AI-slop, review discipline |
| Error Handling | Immediate bug registry, no-assumptions, self-healing escalation |
| Browser Automation | DevTools-first, anti-bot bypass, Chrome profile law |
| A2A Communication | Pure agentic paradigm, inbound governance, opencode-only LLM usage |
System Reliability & Execution
| Document | Focus |
|---|---|
| Testing | Runtime proof, workflow validation, UI/browser verification |
| Monitoring & Observability | Health, metrics, evidence retention, alert usefulness |
| Team Orchestration | Parallel vs sequential work, retries, specialist routing |
| HF Fleet Keep-Alive | Hugging Face wake strategy, persistence, recovery |
| CI/CD mit n8n + sin-github-action | Zero-billing CI via OCI + n8n |
Advanced / Specialized
| Document | Focus |
|---|---|
| MCP Integration | MCP transport, safety, integration patterns |
| Plugin Development | Plugin architecture and extension rules |
| Performance | Cost, model routing, latency, efficiency |
| Security | Secrets, auth boundaries, operator trust |
| Software 3.0: Neural-Bus | Higher-level architecture doctrine |
| SEO Pipeline | Proof-of-work blog publishing pipeline |
| Simone MCP + PCPM ⭐ PFLICHT | Semantic code intelligence + cross-session memory — mandatory for every agent |
Before You Call Something “Done”
- [ ] issue exists and matches the work
- [ ] code is commented with WHAT / WHY / WHY NOT / CONSEQUENCES
- [ ] repo-native checks pass
- [ ] runtime proof exists
- [ ] screenshots/logs exist where relevant
- [ ] docs updated if architecture or workflow changed
- [ ] remaining risk is clearly stated
Final Reminder
The OpenSIN fleet is allowed to move fast only because it is forced to leave evidence, structure, and recoverable knowledge behind. Without that, autonomy becomes chaos.