Carros AI — Handbook

Welcome to the Carros AI team handbook. This is the single source of truth for everything you need to get started and work effectively on our team.

Getting Started

Follow the setup guides in order:

1. SSH Setup — Generate and configure your SSH key
2. Git Setup — Configure Git and connect to the org
3. Claude Code Setup — Set up your AI-driven dev environment
4. Password Manager — Set up Vaultwarden and join the team vault
5. Infrastructure Setup — Terraform, server access, and infra credentials

Architecture & Infrastructure

• Architecture Overview — High-level system design, repositories, tech stack, and ADRs
• Infrastructure as Code — How to work with Terraform
• VPN Setup — Connect to the private network via WireGuard
• Accessing Servers — SSH access to Hetzner servers
• Deploying with Coolify — How to deploy applications
• CI/CD — GitHub Actions workflows and deploy process
• Connecting to Databases — PostgreSQL, Redis, and MongoDB via VPN

Team

• How We Work — Principles, branches, and communication
• PR & Code Review — PR process and review guidelines

Need help?

Open an issue in this repo or ask in the team chat. If something in these docs is wrong or missing, open a PR — everyone is responsible for keeping this up to date.