Overview
Rosetta is a consulting control plane for AI coding agents. It consults them with versioned, expert-prepared instructions so every agent follows your organization's rules, conventions, and knowledge — from day one.
Architecture
When you type a request in your IDE, the agent loads context from Rosetta first — then follows your organization's proven workflows. Source code never leaves your machine.
Session Lifecycle
Bootstrap → Classify → Load → Execute. Guardrails and project context load automatically before the agent acts.
Progressive Disclosure
Instructions load on demand. The agent gets only what it needs for your specific request — context stays focused, responses stay precise.
Three-Layer Instructions
Core · Organization · Project — merged at runtime into a single resource path. Published via Rosetta CLI from your Instructions Repo.
Design Principles
Agent-agnostic
Click to exploreWorks across Cursor, Claude Code, VS Code, Windsurf, JetBrains, GitHub Copilot, Codex, and any MCP-compatible IDE. Adopts agent-specific features where available, simulates them where not.
Progressive disclosure
Click to exploreInstructions load in stages — bootstrap, classification, workflow-specific. The agent gets only what it needs for the current task. Prevents context overflow.
Classification-first
Click to exploreEvery request is auto-classified into a workflow type before any work begins. Classification drives which instructions, skills, and rules load.
Release-based versioning
Click to exploreInstructions organized by release (r1, r2, r3). New instructions develop without breaking stable agents. Rollback is always possible.
Rules-as-code
Click to exploreAI behavior is authored, versioned, reviewed, and approved through standard engineering workflows — same rigor as application code.
Security by design
Click to exploreNo source code transfer. Air-gap capable. Runs inside the organization's perimeter.
Batteries included
Click to exploreShips proven defaults from real-world projects. Makes the right thing the easy thing.
How It Works
Rosetta structures every AI task into five deliberate phases. Reusable prompts apply without modification for each service — consistent, governed results across every IDE and every team. Human review at each transition is critically important.
- Business & technology context
- Replace old patterns with modern counterparts
- Update tests, move components, update dependents
- Dependencies & dependents of migrated services
- Project structure: modules, imports, libraries
- Legacy code to rewrite, bridge between frameworks
- Small code changes per phase — review before they apply
- Task description, motivation, and required change per step
- Automated validation (e.g. unit tests) at end of each phase
- Phase completion tracked inside the prompt itself
- Grounding rules enforced: tests run, commits after each phase
- New session picks up with the same prompt if context fills
- Systematically validates implementation against specs
- Implements integration and E2E tests
- Compatible with subagents and background agents
Key concepts, session lifecycle, three-layer architecture, workflow patterns, and everything else in one place.