Architecture

Stack

• Ruby 3.1+ / Rails 7.2 / PostgreSQL
• ERB views, Tailwind CSS via CDN, Alpine.js
• Import maps (no JS build step)
• Montserrat font, dark navy/mint/violet theme

Database Schema

All foreign keys use slug strings (not integer IDs).

Core Tables

• agents — Registry of all AI agents with status, type, and config
• tasks — Work items with stage pipeline and agent assignment
• skills — Capability catalog
• skill_assignments — Agent-skill join table with proficiency scores
• activities — Chronological log of all agent actions
• usages — Per-agent, per-period API cost and token tracking
• users — Human operators with bcrypt + Google OAuth auth
• error_logs — Structured error capture with polymorphic context

Task Pipeline

new → queued → in_progress → done
                            → failed
         any stage → archived

API

JSON API at /api/v1/ for programmatic agent access:
- GET/POST /api/v1/tasks — List and create tasks
- POST /api/v1/tasks/:slug/queue|start|complete|fail_task — Stage transitions
- GET/PATCH /api/v1/agents/:slug — Read and update agent status
- POST /api/v1/activities — Log agent activity
- POST /api/v1/usages — Report usage metrics

Frontend

Dashboard is public (monitoring). Task mutations require authentication.
All views use the shared dark theme with stage-colored badges.