created IDE/Agent support table, deleted quickstart section and move…#106
created IDE/Agent support table, deleted quickstart section and move…#106ymakaruk-pixel wants to merge 8 commits into
Conversation
Rosetta Triage ReviewSummary: This PR improves README.md by replacing the plain comma-separated IDE/Agent list with a structured Plugin/MCP support table, promotes the conflict warning to a GitHub Findings:
Suggestions:
Automated triage by Rosetta agent |
📋 Prompt Quality Validation Report✅ Validation PassedSummary by File
📄
|
| Severity | Gate | Details |
|---|---|---|
| 🔵 Medium | Conflict Resolution | Problem: Two MUST-USE commands now overlap for the 'add a new phase' case. The new 'plan upsert ... [--kind phase |
| 🔵 Medium | Input Contract | Problem: The new positional argument on create-with-template (and "<PHASE_STEPS_JSON_STRING>" in Phase 0 Step 1) has no optional-bracket marker and no in-file format or example, unlike every other optional arg shown as [limit], [--kind ...], or [--target ...]. So it reads as required, but the orchestrator has nothing in the file telling it the JSON shape. This is the mandatory first call of Phase 0. Reason: An eager agent that skips 'help plan' may emit malformed JSON on the first required call. Impact is bounded because an omitted value is accepted, but a guessed malformed value still causes an avoidable error and retry. Solution: Add a short inline cue to the create-with-template bullet, for example point to 'help plan' for the JSON shape and state a safe fallback of passing an empty array. Mark it optional if it is optional. |
| ⚪ Low | Precision & Explicitness | Problem: The same JSON-string argument is quoted inconsistently in Phase 0 prose: create-with-template shows it quoted as "<PHASE_STEPS_JSON_STRING>" while the upsert-with-template delegation line shows it unquoted as . A JSON string with spaces must be shell-quoted. Reason: The unquoted exemplar models a call that could break shell argument parsing if copied literally. Solution: Quote both occurrences consistently to match the commands-list style. |
📊 Gates Comparison
| Gate | Score | Comparison |
|---|---|---|
| Input Contract | 4 | ⬆️ Slightly better |
| Decision Branching | 4 | ⬆️ Slightly better |
| Precision & Explicitness | 4 | ⬆️ Slightly better |
| Reference Integrity | 5 | ⬆️ Slightly better |
📄 instructions/r3/core/rules/local-files-mode.md
⚠️ Issues Found
| Severity | Gate | Details |
|---|---|---|
| 🔵 Medium | Conflict Resolution | Problem: Same as bootstrap.md: the new 'plan upsert ... [--kind phase |
| 🔵 Medium | Input Contract | Problem: Same as bootstrap.md: the new arg on create-with-template (and "<PHASE_STEPS_JSON_STRING>" in Phase 0 Step 1) has no optional-bracket marker and no in-file format or example, so it reads as required without telling the orchestrator the JSON shape on the mandatory first call. Reason: An agent that skips 'help plan' may emit malformed JSON on the first required call; bounded because omission is accepted, but a guessed value still causes an avoidable error and retry. Solution: Add a short inline cue pointing to 'help plan' for the JSON shape and state a safe empty-array fallback; mark optional if it is optional. |
| ⚪ Low | Precision & Explicitness | Problem: Same as bootstrap.md: the JSON-string arg is quoted as "<PHASE_STEPS_JSON_STRING>" on create-with-template but unquoted as on the upsert-with-template delegation line. Reason: The unquoted exemplar models a call that could break shell argument parsing if copied literally. Solution: Quote both occurrences consistently to match the commands-list style. |
📊 Gates Comparison
| Gate | Score | Comparison |
|---|---|---|
| Input Contract | 4 | ⬆️ Slightly better |
| Decision Branching | 4 | ⬆️ Slightly better |
| Precision & Explicitness | 4 | ⬆️ Slightly better |
| Reference Integrity | 5 | ⬆️ Slightly better |
| Structural Coherence | 5 | ⬆️ Slightly better |
| Bloat Control | 5 | ⬆️ Slightly better |
📄 instructions/r3/core/rules/plugin-files-mode.md
⚠️ Issues Found
| Severity | Gate | Details |
|---|---|---|
| 🔵 Medium | Conflict Resolution | Problem: Same as bootstrap.md: the new 'plan upsert ... [--kind phase |
| 🔵 Medium | Input Contract | Problem: Same as bootstrap.md: the new arg on create-with-template (and "<PHASE_STEPS_JSON_STRING>" in Phase 0 Step 1) has no optional-bracket marker and no in-file format or example, so it reads as required without telling the orchestrator the JSON shape on the mandatory first call. Reason: An agent that skips 'help plan' may emit malformed JSON on the first required call; bounded because omission is accepted, but a guessed value still causes an avoidable error and retry. Solution: Add a short inline cue pointing to 'help plan' for the JSON shape and state a safe empty-array fallback; mark optional if it is optional. |
| ⚪ Low | Precision & Explicitness | Problem: Same as bootstrap.md: the JSON-string arg is quoted as "<PHASE_STEPS_JSON_STRING>" on create-with-template but unquoted as on the upsert-with-template delegation line. Reason: The unquoted exemplar models a call that could break shell argument parsing if copied literally. Solution: Quote both occurrences consistently to match the commands-list style. |
📊 Gates Comparison
| Gate | Score | Comparison |
|---|---|---|
| Input Contract | 4 | ⬆️ Slightly better |
| Decision Branching | 4 | ⬆️ Slightly better |
| Precision & Explicitness | 4 | ⬆️ Slightly better |
| Reference Integrity | 5 | ⬆️ Slightly better |
| Structural Coherence | 5 | ⬆️ Slightly better |
| Bloat Control | 5 | ⬆️ Slightly better |
917c851 to
0f710d8
Compare
|
|
||
| ### Automated QA | ||
|
|
||
| **WHAT**: Automate one UI test at a time from a TestRail case, reusing your existing Page Objects and selectors. Scope each run to a single test case or feature — never ask it to automate everything at once. |
There was a problem hiding this comment.
Utterly specific. And at the same time not showing what AQA actually is. The workflow is not per page or single test case. That is aweful description. Please talk to Maksym and keep it similar to the one we have for coding. Simple and easy.
7135300 to
d109b44
Compare
| @@ -27,31 +27,24 @@ Every AI interaction follows four phases: **Prepare** (load guardrails and conte | |||
|
|
|||
| ## Supported IDEs and Agents | |||
There was a problem hiding this comment.
Let's call it Quick Start
Merge it with existing quickstart
use warning for that note
Format
Quick Start
Two Ways:
- Plugins (recommended):[Link to install] [LIST of IDEs]
- MCP: [Link to install] [LIST of IDEs]
690708f to
82208e8
Compare
| </div> | ||
|
|
||
| ## What is Rosetta | ||
| Rosetta gives an AI coding agent the context and instructions any senior engineer would need before touching the code. As the result, AI agents work from real knowledge of your project instead of guessing. Rosetta feeds the agent your system architecture, domain rules, and engineering standards, plus a library of ready-made instructions to follow. Those instructions include: |
There was a problem hiding this comment.
Please match that with our elevator speech in the repo.
…d doc links to the page buttom
…use slash-command + feature style, fixed Note
… case handling and execution processes.
82208e8 to
7248b66
Compare
Reader profiles, per-document contracts, and a profile-based reading journey. Un-ignore the file so it travels with the PR. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
No description provided.