Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
4d3888e
feat: implement draft version of orchestration skill and assit/o-suba…
YevheniiaLementova Jun 25, 2026
a377de2
docs(story/reduce-bootsrap.md): add more details about orchetsration …
YevheniiaLementova Jun 25, 2026
2714b27
refactor(skills/orchestration): restructure SKILL.md into focused sec…
YevheniiaLementova Jun 26, 2026
2a37d47
docs(story): mark orchestration skill as done in reduce-bootstrap pro…
YevheniiaLementova Jun 26, 2026
35ebdcf
docs (definition/skill): add new orchestration skill
YevheniiaLementova Jun 26, 2026
7718a06
fix: use new skill name (load-project-context); improve decription of…
YevheniiaLementova Jun 26, 2026
00f2f1f
feat: introduce new version of orchestration skill
YevheniiaLementova Jul 3, 2026
d6f54aa
Merge remote-tracking branch 'origin/main' into feat/orchestration-skill
isolomatov-gd Jul 6, 2026
100086a
current state
isolomatov-gd Jul 6, 2026
4266128
reduce-bootstrap: dissolve load-context-instructions, remove r2 plan-…
isolomatov-gd Jul 9, 2026
0183b47
reduce-bootstrap: dissolve r3 core-policy, guardrails, execution-poli…
isolomatov-gd Jul 10, 2026
8846456
reduce-bootstrap: dissolve r3 bootstrap-rosetta-files; full ref + req…
isolomatov-gd Jul 10, 2026
ccec020
reduce-bootstrap: slim r3 mode files, remove 3 superseded skills, ros…
isolomatov-gd Jul 10, 2026
dcfe062
reduce-bootstrap: queue prep-steps canonicalization + description/com…
isolomatov-gd Jul 10, 2026
99a3478
Integrate post-mortem into deviation
isolomatov-gd Jul 10, 2026
e214e9d
Fix tool commands => compress even more
isolomatov-gd Jul 10, 2026
563c3c9
Add readmes to all skills, minor fixes
isolomatov-gd Jul 10, 2026
102a498
Fix HITL
isolomatov-gd Jul 11, 2026
99475a1
Merge remote-tracking branch 'origin/main' into feat/orchestration-skill
isolomatov-gd Jul 11, 2026
95b1f24
Fixes
isolomatov-gd Jul 11, 2026
6626a8c
Fix terminology, rename bootstrap.md, etc.
isolomatov-gd Jul 11, 2026
7270e35
Compress
isolomatov-gd Jul 11, 2026
f28de0d
Compress more!
isolomatov-gd Jul 11, 2026
1231cfe
Before mechanical work
isolomatov-gd Jul 11, 2026
628b42d
More redundancy removal
isolomatov-gd Jul 11, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 6 additions & 7 deletions .github/prompts/prompt-comparison.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,17 +8,16 @@ Rosetta is an instructions and processes enforcement for AI coding agents (like
It is public OSS and central repository of rules/skills/agents/subagents/commands/workflows stored as markdown files.
These artifacts are deployed via plugins (preferred) or MCP into a target real software project repository, which has its own files and folder structure.

Coding agents will always be exposed to the same Rosetta bootstrap as you are now (always injected in context):
bootstrap_guardrails, bootstrap_core_policy, bootstrap_execution_policy, bootstrap_hitl_questioning, bootstrap_rosetta_files. Plus either bootstrap.md (mcp mode) or plugin-files-mode.md (plugins/standalone mode).
Top-agent sessions receive `bootstrap-alwayson.md` plus exactly one mode file: `mcp-files-mode.md` (MCP), `plugin-files-mode.md` (plugin/standalone), or `local-files-mode.md` (developing Rosetta). Spawned subagents receive only `bootstrap-alwayson.md` + their dispatch prompt, which requires `subagent-directives` and any task-needed skills. Heavy process loads on demand through skills and workflows; the plugin mode file carries no alias mapping because typed aliases operate natively on plugin files.

Rosetta predefine key folders and files using that bootstrap_rosetta_files XML tag that will be present in target project.
Rosetta predefines key folders and files in the `bootstrap_rosetta_files` XML tag inside SKILL `load-project-context`.

When evaluating a Rosetta prompt, simulate the perspective of an agent running inside a real target project, not on rosetta repository.
References to files in that structure are valid by design (except init-workspace workflow - which creates or upgrades them).

Read `docs/CONTEXT.md` and `docs/ARCHITECTURE.md` in current rosetta repo to better understand rosetta implementation itself. Remember that current and target repositories ARE DIFFERENT (this content is only available in this repo!).

MUST USE SKILL `orchestrator-contract` for all subagent dispatches.
MUST USE SKILL `orchestration` for all subagent dispatches.
MUST USE SKILL `coding-agents-prompt-authoring` to review and to harden the changes and at least must include pa-rosetta.md, pa-patterns, pa-hardening.md, pa-schemas.md.
Subagents MUST USE SKILL `coding-agents-prompt-authoring` with references listed above (and more if they determine additional references are needed).

Expand Down Expand Up @@ -46,13 +45,13 @@ Use references `rosetta`, `cto-ims-kb`, `RulesOfPower` (all must be).
1. **Analyze diff**: Read the provided diff file. Assess size (line count, word count, number of files). Check whether the PR contains changes outside `instructions/` that may affect prompt behavior — run `git diff --stat <base_ref>...HEAD` to see the full PR scope and factor non-instruction changes into your reasoning.
2. **Evaluate prompts**:
- **Small changes** (≤7 files AND ≤1000 changed lines total): evaluate all files yourself.
- **Large changes** (>7 files OR >1000 changed lines): spawn parallel subagents using the Task tool. Provide each subagent with the FULL and EXACT context: diff file path, base ref, their assigned file subset, and their output path in `.tmp/agents/`. Group files by release folder, then by prompt family. MUST USE SKILL `orchestrator-contract` for every subagent dispatch. Each subagent writes its JSON results to `.tmp/agents/{subagent-id}.json`.
- **Large changes** (>7 files OR >1000 changed lines): spawn parallel subagents using the Task tool. Provide each subagent with the FULL and EXACT context: diff file path, base ref, their assigned file subset, and their output path in `.tmp/agents/`. Group files by release folder, then by prompt family. MUST USE SKILL `orchestration` for every subagent dispatch. Each subagent writes its JSON results to `.tmp/agents/{subagent-id}.json`.
- Pass "How to think about Rosetta to subagents"
- Always extend context to remove blind spots (example: changes made to skill asset only, but you still load unmodified SKILL.md to understand full context; same with workflows, phases, rules, bootstraps)
- Do not report the same issue multiple times
3. **Recombine**: Merge all subagent JSON outputs (or your own results) into a single JSON array.
4. **Prompt engineer review**: Spawn a subagent (prompt engineer role) to review the combined JSON results. Allow the subagent to read repository files for additional context. The reviewer verifies findings are grounded, removes false positives, and flags missed regressions. MUST USE SKILL `orchestrator-contract`.
5. **Behavioral simulation**: Spawn a subagent to simulate how coding agents would behave with the new prompt versions versus the base versions. Identify behavioral regressions, safety gaps, or improvements. MUST USE SKILL `orchestrator-contract`.
4. **Prompt engineer review**: Spawn a subagent (prompt engineer role) to review the combined JSON results. Allow the subagent to read repository files for additional context. The reviewer verifies findings are grounded, removes false positives, and flags missed regressions. MUST USE SKILL `orchestration`.
5. **Behavioral simulation**: Spawn a subagent to simulate how coding agents would behave with the new prompt versions versus the base versions. Identify behavioral regressions, safety gaps, or improvements. MUST USE SKILL `orchestration`.
6. **Finalize**: Incorporate review and simulation feedback into the JSON findings. Write the final array to the output file path provided in the prompt.

## File Reference Validation Rules
Expand Down
4 changes: 2 additions & 2 deletions FAQ.md
Original file line number Diff line number Diff line change
Expand Up @@ -129,11 +129,11 @@ See [OVERVIEW.md](OVERVIEW.md) for the full picture.

**Where do I put project-specific overrides?**

In `gain.json` at the repo root. It defines SDLC setup and locations of Rosetta files and wins in any conflict with default Rosetta conventions. See [bootstrap-rosetta-files](https://github.com/griddynamics/rosetta/blob/main/instructions/r2/core/rules/bootstrap-rosetta-files.md?plain=1) for the canonical file list.
In `gain.json` at the repo root. It defines SDLC setup and locations of Rosetta files and wins in any conflict with default Rosetta conventions. See the [load-project-context skill](https://github.com/griddynamics/rosetta/blob/main/instructions/r3/core/skills/load-project-context/SKILL.md?plain=1) (`<bootstrap_rosetta_files>`) for the canonical file list.

**What files does Rosetta create in my repo?**

The headline ones are `docs/CONTEXT.md` and `docs/ARCHITECTURE.md`. The full set (including `TODO.md`, `ASSUMPTIONS.md`, `TECHSTACK.md`, `DEPENDENCIES.md`, `CODEMAP.md`, `IMPLEMENTATION.md`, `MEMORY.md`, and the `plans/` and `refsrc/` directories) is documented in the `bootstrap-rosetta-files` rule. <!-- TODO: link to a user-friendly explainer once one exists -->
The headline ones are `docs/CONTEXT.md` and `docs/ARCHITECTURE.md`. The full set (including `TODO.md`, `ASSUMPTIONS.md`, `TECHSTACK.md`, `DEPENDENCIES.md`, `CODEMAP.md`, `IMPLEMENTATION.md`, `MEMORY.md`, and the `plans/` and `refsrc/` directories) is documented in the `load-project-context` skill (`<bootstrap_rosetta_files>` section). <!-- TODO: link to a user-friendly explainer once one exists -->

---

Expand Down
2 changes: 1 addition & 1 deletion REVIEW.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ Instructions (skills, agents, workflows, rules, templates) define how AI agents

### Agent and Tool Agnosticism

- **No hardcoded tool names.** Instructions must not reference specific MCPs and tools, unless those are commonly available. Additionally, use [command aliases](docs/ARCHITECTURE.md#command-aliases) (`ACQUIRE FROM KB`, `SEARCH IN KB`) or describe the action generically.
- **No hardcoded tool names.** Instructions must not reference specific MCPs and tools, unless those are commonly available. Additionally, use [command aliases](docs/ARCHITECTURE.md#command-aliases) (`USE SKILL …`, `APPLY PHASE …`, `READ RULE …`) or describe the action generically.
- **No IDE-specific logic.** Instructions work across Cursor, Claude Code, VS Code, JetBrains, Codex, and any MCP-compatible agent. If a PR introduces IDE-specific behavior, it must be justified and isolated. Target models: Sonnet, Opus, GPT-5.3-codex, GPT-5.4, Gemini-3.1-Pro.
- **No hardcoded paths or env vars.** Unless the instruction explicitly manages configuration, paths and environment details belong in setup docs or deployment config.
- **Flexible over rigid.** Prefer solutions that adapt to task complexity. Avoid brittle assumptions about project structure, language, or toolchain.
Expand Down
Loading
Loading