Skip to content

Latest commit

 

History

History
243 lines (140 loc) · 13.1 KB

File metadata and controls

243 lines (140 loc) · 13.1 KB
Rosetta

Engineering governance and context for AI coding agents — shared instructions, architecture, standards, workflows, and guardrails in every session.

MCP Downloads CLI Downloads Instructions Python 3.12+ License: Apache-2.0

AI coding agents are impressive on their own — but on a real team they don't know your architecture, your conventions, or your rules. So they read a couple of open files and confidently do the wrong thing.

Rosetta fixes that. It loads your team's shared engineering knowledge into every agent session, so the agent works the way an experienced teammate would: understand the codebase first, propose a plan, get your sign-off, do the work, then check it actually works.

It's not a new AI agent and it doesn't replace the tools you already have. It plugs into Claude Code, Cursor, GitHub Copilot, Codex, Antigravity, and other MCP-compatible agents, and makes them behave better.

1. Install

Install Rosetta as a plugin in your agent. Or connect through MCP.

  • Plugin (recommended) — PLUGINS
  • MCP (evaluation, or agents with no plugin support) — MCPs

Tip

Choose your model with care. Use Sonnet 5 medium, GPT-5.4-medium, gemini-3.1-pro, or newer. Do not use Auto. Rosetta conflicts with JUXT, Superpowers, GSD, and AI-DevKit. Keep the tool you already use.

2. Onboard (required)

Run the init workflow once per repository. The agent reads your code and writes the context files every later task needs.

3. Configure Ecosystem (optional — recommended)

Connect the agent to your other tools, such as a code graph or test runner. Add your organization's own rules on top of the core instructions.

4. All-In-One Workflows

Those are implemented to fully cover entire area of work as All-In-One. If full workflow is not needed you can ask or use skills directly.

4.1 Help Workflow

Finds the right workflow for your request and hands off directly into it.

Use it when you do not know what Rosetta can do, or which workflow fits.

Skills: /natural-writing, /reasoning

Help Workflow Details

4.2 Coding Workflow

Orchestrates subagents and executes: discovery, design, specifications, hitl, implementation, review, unit/integration/e2e testing, final manual validation by AI.

Covers E2E and gives a fully implemented and tested solution. Intended for medium to large tasks.

Skills: /requirements-use, /tech-specs, /planning, /coding, /testing

Coding Workflow Details

4.3 Code Analysis Workflow

Reverse-engineers a codebase into architecture documentation. Every claim traces to real code.

Use it to understand a system before you plan, refactor, or migrate it.

Skills: /requirements-authoring, /reverse-engineering, /reasoning, /large-workspace-handling, /questioning

Code Analysis Workflow Details

4.4 Ad-hoc Workflow

Builds a custom plan from reusable building blocks, then executes it with tracking.

Use it for small or unusual tasks that do not fit any other workflow.

Skills: /planning, /reasoning, /tech-specs

Ad-hoc Workflow Details

4.5 Test Case Generation Workflow

Turns a ticket into a requirements document and a set of manual test cases.

Use it when you need designed test scenarios with traceability, before any automation code exists.

Skills: /data-collection, /qa-knowledge, /hitl, /coding

Test Case Generation Workflow Details

4.6 API AQA Workflow

Turns API contracts and test cases into working, corrected, automated tests. Gated by your approval.

Use it to automate backend API tests from OpenAPI specs or request/response cases.

Skills: /data-collection, /qa-knowledge, /qa-structure, /reverse-engineering, /coding, /testing, /debugging

API AQA Workflow Details

4.7 UI AQA Workflow

Turns a test case into a working automated UI test. Follows your repo's existing page objects.

Use it to automate browser or end-to-end tests, or to fix a failing one.

Skills: /data-collection, /qa-knowledge, /qa-structure, /reverse-engineering, /coding, /testing, /debugging

UI AQA Workflow Details

4.8 Requirements Authoring Workflow

Drafts and validates requirements as small, atomic units. Each unit needs your approval.

Use it when behavior is unclear or high-impact, or when you need traceability.

Skills: /hitl, /requirements-authoring, /reverse-engineering

Requirements Authoring Workflow Details

4.9 Research Workflow

Drafts a research prompt for your approval, then runs it and documents the answer.

Use it for deep investigation or a technology comparison before you choose an approach.

Skills: /reasoning, /research

Research Workflow Details

4.10 Modernization Workflow

Migrates or upgrades a system through sequential, spec-first phases. Each phase needs your approval.

Use it for a real migration: a language conversion, a framework upgrade, or a persistence change.

Skills: /hitl, /load-project-context, /orchestration

Modernization Workflow Details

4.11 External Library Onboarding Workflow

Packages an external library into reference material and a short learning guide.

Use it when your project depends on an internal SDK or external client, without source access.

Skills: /hitl, /load-project-context, /orchestration

External Library Onboarding Workflow Details

4.12 Security Workflow

Runs an authorized security review and prepares remediation inputs. It never fixes code itself.

Use it for an authorized review of an application, a repository, or an AI system.

Skills: /hitl, /security, /risk-assessment, /dangerous-actions, /sensitive-data, /subagent-directives

Security Workflow Details

4.13 Coding Agents Prompting Workflow

Authors or adapts prompts for AI agents: skills, subagents, workflows, and rules.

Use it to create, refactor, review, or port a prompt to another agent.

Skills: /coding-agents-prompt-authoring

Coding Agents Prompting Workflow Details

Skills

40+ skills power these workflows. Browse them here.

Documentation

Every document, and when to read it
Read this When
PLUGINS · MCPs You are picking a delivery mode, or installing one
CONFIGURATION Engineers setting up a workspace (in the VS Code sense) for the first time, so AI coding agents work well in it
OVERVIEW Engineers, leads, and architects who want to understand how Rosetta works before contributing or evaluating it
CONTEXT Contributors, architects, and stakeholders who need to understand the business purpose, domain, and requirements behind Rosetta
TROUBLESHOOTING · FAQ Anyone blocked while using or developing Rosetta
CHANGELOG Weekly change log
ARCHITECTURE · MCP-ARCHITECTURE Contributors who need to understand how Rosetta works before changing it
USER GUIDE Guide helps you use Rosetta
CONTRIBUTING · DEVELOPER_GUIDE First-time and active contributors
REVIEW Reviewers and PR authors
SECURITY Discover a security vulnerability in Rosetta

Community and support

For AI agents

Machine-readable instruction bundle: llms-full.txt.

Demo

Watch the demo
Rosetta-2-min-Speech.mp4

Tech Demo

Init and Coding
Rosetta-5-min-Demo.mp4
Frontend Migration
Frontend.Migration.Demo_1080p_Final.mp4

License

Apache-2.0. See LICENSE and NOTICE.