Skip to content
Tamma Docs

Welcome to the Tamma Wiki

Tamma is an autonomous development platform that maintains itself. This wiki provides comprehensive documentation for understanding, contributing to, and using Tamma.

What is Tamma?

Tamma is an autonomous development platform designed to achieve 70%+ autonomous completion of software development tasks without human intervention. The platform’s ultimate goal is self-maintenance — Tamma will maintain its own codebase.

Key Features

  • Autonomous Development Loop — 70%+ completion rate without human intervention
  • Multi-Provider Flexibility — 8+ AI providers, 7 Git platforms, no vendor lock-in
  • Config-Driven Multi-Agent System — Role-based agent selection with provider chains, fallback, and circuit breakers
  • Dual-Stack Architecture — TypeScript (Node.js) for providers, CLI, and API; C# (.NET 8) ELSA Workflows for orchestration
  • Production-Ready Security — Content sanitization, URL validation, action gating, SSRF protection, LLM injection defense
  • ELSA Workflow Engine — Visual, composable, pausable/resumable workflows with ELSA Studio
  • Diagnostics Pipeline — Per-provider cost, token, latency, and error tracking
  • System Monitoring — Comprehensive observability dashboard for all services, providers, workflows, and infrastructure
  • Voice Interface — Realtime voice conversation with the orchestrator via browser
  • Self-Maintenance — Tamma maintains its own codebase (MVP validation goal)

Architecture Highlights

  • Hybrid TypeScript + C# Architecture — TypeScript for AI providers, CLI, API; .NET ELSA for workflow orchestration
  • Interface-Based Provider Abstraction — Swap AI providers (Claude, GPT-4, Gemini, OpenRouter, local LLMs)
  • Platform-Agnostic Git Integration — GitHub, GitLab, Gitea, Forgejo, Bitbucket, Azure DevOps
  • ELSA Workflow Engine — 20+ code-first C# workflows with visual designer (ELSA Studio)
  • Event Sourcing and Audit Trail — Complete transparency via DCB (Development Context Bus)
  • Role-Based Agent Resolution — Workflow phases map to agent roles; each role has an ordered provider chain
  • Defense-in-Depth Security — Content sanitization at prompt and output boundaries, secure fetch with SSRF protection
  • SaaS + CLI Dual Mode — Works as self-hosted CLI or multi-tenant SaaS with GitHub App integration

Current Status

Phase: Active Implementation Deployment: VPS at 204.168.131.39 (Hetzner CPX42, 16GB) with Docker Compose stack Domains: app.tamma.dev, api.tamma.dev, elsa.tamma.dev (Cloudflare DNS, Full SSL) Last Audit: 2026-03-31 (sprint-status.yaml audited against codebase for all 26 epics)

Recent Progress

  • Epic 2 near complete — 13/16 autonomous loop stories done (issue selection through prompt optimization); retrospective completed
  • Sprint status audit — all 26 epics audited against codebase, story statuses corrected
  • Epic 1.5 — NPM publishing (1.5-8) and binary releases (1.5-9) now done; Kubernetes deployment (1.5-10) in progress
  • Epic 1 — additional AI providers (1-10) and agent customization (1-13) in progress
  • Landing page prototypes — 3 redesign variants with video integration
  • Epic 25 added — Custom Wiki Site on Cloudflare Workers (Astro Starlight, wiki.tamma.dev / wiki.its-done.dev)
  • Video production plans finalized — ELI5 ~75s + Deep Dive ~4 min, 79 scene images at 4K Pro
  • CodeQL security alerts fixed — 9 files patched (log forging, incomplete URL sanitization, SQL wildcard escaping, API key validation)

Completed Epics (12)

EpicNameKey Deliverables
Epic 6Context & Knowledge ManagementCodebase indexer, vector DB, RAG pipeline, MCP client, cost monitor, permissions, knowledge base, scrum master
Epic 7Mentorship Workflow28-state mentorship workflow, 12+ ELSA activities, TypeScript bridge
Epic 9Agent ManagementConfig-driven multi-agent, circuit breakers, diagnostics, security layer
Epic 10Engine CoreWorkflow-driven engine, ELSA integration, event store
Epic 11Security HardeningC# security pipeline, LLM input/output sanitization, tool validation
Epic 12Agentic Tool LoopMulti-turn tool execution, context compaction, streaming
Epic 13Workflow DecompositionTDD/CI retry sub-workflows, consolidated finish sequences
Epic 14Custom ELSA StudioCustom Blazor WASM studio, Tamma branding, UI hints
Epic 15ObservabilityOpenSearch log aggregation (3 bug fixes for ESM/Serilog/Fastify)
Epic 16Unified Auth & AdminGitHub OAuth SSO (oauth2-proxy removed), user management, admin panel, RBAC, ELSA Studio auto-login

Near Complete (3)

EpicNameDoneRemaining
Epic 1Foundation & Core Infrastructure10/152 in progress (AI providers, agent customization), 3 ready
Epic 1.5Infrastructure & Deployment9/10Kubernetes deployment in progress
Epic 2Autonomous Development Loop13/16Issue decomposition, task dependencies, sequencing (ready for dev)

Planned / Drafted

EpicNameStoriesStatus
Epic 3Quality Gates & Intelligence12Ready for Dev
Epic 4Event Sourcing & Audit Trail8Ready for Dev
Epic 5Observability Dashboard & Docs12Partially Implemented
Epic 8Distribution & Installation8Drafted
Epic 17Multi-Tenancy Foundation5Drafted
Epic 18End-User Auth & Registration5Drafted
Epic 19GitHub App Agent Dispatch5Drafted
Epic 20Billing & Payments5Drafted
Epic 21Marketing Site & User Dashboard5Drafted
Epic 22CLI Mode Preservation5Drafted
Epic 23System Monitoring & Observability Dashboard12Drafted (26 task plans)
Epic 24Realtime Voice Conversation7Drafted (24 task plans)
Epic 25Documentation & Wiki Site1Drafted

Getting Started

  1. Read the Architecture overview
  2. Review the Roadmap to understand the project timeline
  3. Check out Epic 1 to see foundational work
  4. See Epic 9 for the multi-agent system
  5. Visit Contributing to learn how to help

Documentation

All technical documentation is maintained in the /docs directory:

  • PRD - Product requirements
  • Architecture - Technical architecture
  • Epics - Epic breakdown
  • Tech Specs - Technical specifications per epic
  • Stories - User story documentation (26 epics, 220+ stories, 50+ task plans)

Last updated: 2026-03-31 | Maintained by: meywd