Skip to content
Back to search

res

MarketplaceWorks with Claude CodeGitHub

RES: reverse engineer a SaaS web product into a knowledge base for rebuilding it, without touching production data.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/alextnetto--res/badge.svg)](/listings/alextnetto--res)

HTML

<a href="/listings/alextnetto--res"><img src="/api/listings/alextnetto--res/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install

In a terminal:

claude plugin marketplace add alextnetto/res
claude plugin install res@res

Inside a Claude Code session, the same commands are `/plugin marketplace add alextnetto/res` and `/plugin install res@res`. Start a new session afterwards.

For other agents that read skills from disk, copy the skill folder where your agent reads skills:

git clone https://github.com/alextnetto/res.git && mkdir -p ~/.claude/skills && cp -R res/skills/reverse-engineering-saas ~/.claude/skills/

You need Node.js 22 or later and an agent that can drive a browser and run JavaScript in the page: Claude in Chrome, Playwright MCP or Chrome DevTools MCP.

Prepare a safe environment

Create a trial account of the product with an email you own, log in to it in a separate Chrome profile, and connect your agent's browser tool to that profile ([how](skills/reverse-engineering-saas/references/tools.md#separate-profile-for-l1)). This is the safest setup: the agent cannot reach your production account even by mistake.

Without a trial account, the agent writes only if you ask it to test or to create a test environment, and then only inside a separate workspace or a sandbox container. Otherwise it only observes.

Ask your agent

Study Pipedrive so my team can rebuild it for the Brazilian market.
Use the trial profile, and don't ask me anything until you're done.

Replace the product, the market and the scope with your own. The agent creates `re-<product>/` in its working directory, works through the phases below, and sends you `REPORT.html` and `re-<product>-handoff-<date>.zip` when it finishes. To continue later, start a session in the same directory and say "Continue the Pipedrive study."

Use the scripts directly

The scripts work without an agent, for example to inspect or repackage a knowledge base:

node skills/reverse-engineering-saas/scripts/init-kb.mjs --product "Acme CRM" --git
node skills/reverse-engineering-saas/scripts/check-kb.mjs re-acme-crm
node skills/reverse-engineering-saas/scripts/build-report.mjs re-acme-crm
node skills/reverse-engineering-saas/scripts/pack-kb.mjs re-acme-crm

Each script prints its options with `--help`.

Update

claude plugin marketplace update res
claude plugin update res@res

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 21 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "res",
  4. "description": "RES: reverse engineer a SaaS web product into a knowledge base for rebuilding it, without touching production data.",
  5. "owner": {
  6. "name": "Alex Netto",
  7. "url": "https://alexnet.to"
  8. },
  9. "plugins": [
  10. {
  11. "name": "res",
  12. "description": "Study a SaaS product through the browser and document screens, states, business rules, data model, API shapes, design tokens and production barriers, with a sandbox protocol, a change ledger and an automated check.",
  13. "source": "./",
  14. "strict": false,
  15. "skills": [
  16. "./skills/reverse-engineering-saas"
  17. ],
  18. "version": "0.4.0"
  19. }
  20. ]
  21. }
README.md · README · 280 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. # RES: Reverse Engineering SaaS
  3. ### Turn a SaaS product into a build kit your team or your coding agent can ship.
  4. **Study a web product through the browser, document how it works, and hand off everything needed to rebuild and launch it, without touching production data.**
  5. [![test](https://github.com/alextnetto/res/actions/workflows/test.yml/badge.svg)](https://github.com/alextnetto/res/actions/workflows/test.yml)
  6. [![release](https://img.shields.io/github/v/release/alextnetto/res)](https://github.com/alextnetto/res/releases)
  7. [![Node.js 22+](https://img.shields.io/badge/Node.js-22%2B-339933?logo=nodedotjs&logoColor=white)](#quick-start)
  8. [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  9. [Quick start](#quick-start) · [How RES works](#how-res-works) · [What you get](#what-you-get) · [Examples](#examples) · [Safety model](#safety-model) · [FAQ](#faq) · [Documentation](#documentation)
  10. <code>claude plugin marketplace add alextnetto/res</code>
  11. </div>
  12. > [!IMPORTANT]
  13. > RES drives a real browser on accounts you control. Use it only on products you are allowed to study, read the [safety model](#safety-model) before the first run, and prefer a trial account in a separate browser profile.
  14. <div align="center">
  15. <img src="docs/assets/res-hero.png" alt="RES studies a live product in a safe environment, writes a knowledge base with evidence, and hands it off as a zip for any coding agent" width="1200" />
  16. </div>
  17. ---
  18. Want to rebuild a product your team relies on, or launch a competitor in your market? Ask your agent to study it with RES. The agent explores the product in a test environment, records every change it makes, and writes what it learns to files: screens and states, business rules with evidence, the data model, API shapes, design tokens, and what could stop the clone from launching, such as integrations that need approval, licenses and certifications.
  19. At the end you get two files. `REPORT.html` is the report you read: one page that starts with the overview and the decisions you need to make, then walks through what the product does, every screen and rule, the data model and design, the build plan, and what to prepare before launch. The zip is for your coding agent: unzip it, give it the folder, and it starts from `BUILD.md`.
  20. RES is one agent skill with plain Markdown templates and a few dependency-free Node.js scripts. It adds about 130 tokens to every session and about 4,600 when it runs (measured with `claude plugin details`).
  21. ## Quick start
  22. ### Install
  23. In a terminal:
  24. ```bash
  25. claude plugin marketplace add alextnetto/res
  26. ```
  27. ```bash
  28. claude plugin install res@res
  29. ```
  30. Inside a Claude Code session, the same commands are `/plugin marketplace add alextnetto/res` and `/plugin install res@res`. Start a new session afterwards.
  31. For other agents that read skills from disk, copy the skill folder where your agent reads skills:
  32. ```bash
  33. git clone https://github.com/alextnetto/res.git && mkdir -p ~/.claude/skills && cp -R res/skills/reverse-engineering-saas ~/.claude/skills/
  34. ```
  35. You need Node.js 22 or later and an agent that can drive a browser and run JavaScript in the page: Claude in Chrome, Playwright MCP or Chrome DevTools MCP.
  36. ### Prepare a safe environment
  37. Create a trial account of the product with an email you own, log in to it in a separate Chrome profile, and connect your agent's browser tool to that profile ([how](skills/reverse-engineering-saas/references/tools.md#separate-profile-for-l1)). This is the safest setup: the agent cannot reach your production account even by mistake.
  38. Without a trial account, the agent writes only if you ask it to test or to create a test environment, and then only inside a separate workspace or a sandbox container. Otherwise it only observes.
  39. ### Ask your agent
  40. ```text
  41. Study Pipedrive so my team can rebuild it for the Brazilian market.
  42. Use the trial profile, and don't ask me anything until you're done.
  43. ```
  44. Replace the product, the market and the scope with your own. The agent creates `re-<product>/` in its working directory, works through the phases below, and sends you `REPORT.html` and `re-<product>-handoff-<date>.zip` when it finishes. To continue later, start a session in the same directory and say "Continue the Pipedrive study."
  45. ### Use the scripts directly
  46. The scripts work without an agent, for example to inspect or repackage a knowledge base:
  47. ```bash
  48. node skills/reverse-engineering-saas/scripts/init-kb.mjs --product "Acme CRM" --git
  49. ```
  50. ```bash
  51. node skills/reverse-engineering-saas/scripts/check-kb.mjs re-acme-crm
  52. ```
  53. ```bash
  54. node skills/reverse-engineering-saas/scripts/build-report.mjs re-acme-crm
  55. ```
  56. ```bash
  57. node skills/reverse-engineering-saas/scripts/pack-kb.mjs re-acme-crm
  58. ```
  59. Each script prints its options with `--help`.
  60. ### Update
  61. ```bash
  62. claude plugin marketplace update res
  63. ```
  64. ```bash
  65. claude plugin update res@res
  66. ```
  67. ## How RES works
  68. ```mermaid
  69. flowchart LR
  70. A[Charter] --> B[Safe environment<br/>and preflight]
  71. B --> C[Public docs<br/>and barrier scan]
  72. C --> D[Map screens]
  73. D --> E[Deep dive<br/>one feature at a time]
  74. E -->|next feature| E
  75. E --> F[Synthesis:<br/>PRD, parity, barriers]
  76. F --> G[Close:<br/>report and zip]
  77. ```
  78. | Phase | What happens |
  79. |---|---|
  80. | 1 Charter | Goal, scope, priorities and the clone's target market |
  81. | 2 Environment | Pick the safest environment; check for automations, webhooks and integrations that could fire |
  82. | 3 Recon | Public docs, API reference, pricing, integrations list and terms, read with web fetch; first barrier scan |
  83. | 4 Map | Every screen and route; stack and design tokens |
  84. | 5 Deep dive | One feature at a time: fixtures, states, rules, persistence, network, written to disk before the next feature |
  85. | 6 Synthesis | Data model, design tokens, barriers, PRD, parity tests |
  86. | 7 Close | Restore what changed, pass `check-kb`, send `REPORT.html` and the handoff zip |
  87. The knowledge base on disk is the agent's only memory, so a study can span many sessions and survive context limits. Every statement carries its evidence: `[obs]` seen in the product, `[net]` captured on the network, `[doc]` from public documentation, `[inf]` an inference with an open question.
  88. ## What you get
  89. | Area | What the knowledge base contains | Where |
  90. |---|---|---|
  91. | Inventory | Feature tree, screen catalog with URL patterns, a coverage matrix that works as the queue | `inventory/` |
  92. | UX | Anatomy, states (empty, loading, error, no permission, plan-gated), interactions, keyboard, accessibility, microcopy | `screens/`, `components/` |
  93. | Behavior | Business rules as Given/When/Then with evidence, user flows, cross-cutting topics | `rules/`, `flows/`, `topics/` |
  94. | Data | Entities with fields, enums and relations, ER diagram, TypeScript types, permissions matrix | `data-model/` |
  95. | API | Endpoint templates per user action, with JSON shapes and no values | `api/` |
  96. | Design | Color, type, spacing, radius, shadow and motion tokens, mapped to the product's CSS variables | `design/` |
  97. | Production barriers | Integrations that need approval, licenses, certifications, distribution gatekeepers and moats, with severity, market weight, lead time and mitigation | `clone/barriers.md` |
  98. | Build plan | Requirements, parity tests derived from the rules, what to copy, avoid and improve | `clone/` |
  99. | Report | `REPORT.html`: one self-contained page a person reads, with images embedded and every ID linked | KB root |
  100. | Handoff | `BUILD.md`, a brief for any coding agent: read order, rules as tests, what not to copy | zip root |
  101. A rule:
  102. ```markdown
  103. ### R-014 Completing the last open activity prompts for the next one
  104. - Given a deal with exactly one open activity
  105. - When the user marks that activity done
  106. - Then a "Schedule next activity" dialog opens; Cancel closes it and the deal shows a warning icon
  107. - Evidence: [obs EV-031, EV-032]
  108. ```
  109. A production barrier:
  110. ```markdown
  111. ### BR-003 WhatsApp messages need Meta business verification
  112. - Category: permissioned integration
  113. - Blocks: F-014 (WhatsApp notifications)
  114. - Gatekeeper: Meta, WhatsApp Business Platform
  115. - Severity: blocks feature
  116. - Market weight: required to sell
  117. - Lead time and cost: [doc SRC-021]
  118. - Mitigation: start verification in month one; launch with email notifications
  119. - Evidence: [doc SRC-021]
  120. ```
  121. ## Examples
  122. Two end-to-end studies, run by Claude Code with Claude in Chrome without a person at the keyboard:
  123. | Product | Environment | Result | Read |
  124. |---|---|---|---|
  125. | ClickUp: board, task view, custom fields | L2, a new free workspace | 55 rules, 19 components, 14 production barriers | [Report](https://alextnetto.github.io/res/examples/clickup/REPORT.html) · [Knowledge base](examples/clickup/) |
  126. | Pipedrive: pipeline, deals, next-activity rule, won and lost | L3, a sandbox pipeline in a production account, removed at the end | 46 rules, 8 components, 15 production barriers | [Report](https://alextnetto.github.io/res/examples/pipedrive/REPORT.html) · [Knowledge base](examples/pipedrive/) |
  127. Each folder is the unzipped handoff. Notes on trademarks and terms: [examples/README.md](examples/README.md).
  128. ## Safety model
  129. | Level | Environment | What the agent may change |
  130. |---|---|---|
  131. | L1 | Trial account in a separate browser profile, created by you | Everything except outbound and irreversible actions |
  132. | L2 | New, empty workspace under your login | Test data and configuration inside that workspace |
  133. | L3 | One sandbox list, project or pipeline inside production | Test data inside the container only |
  134. | L4 | Production, observe only | Nothing |
  135. - At every level the agent never sends messages or invites, never assigns or mentions other people, never touches billing, never creates accounts and never types passwords.
  136. - Autosave, read receipts, dismissed banners and persistent view changes count as writes.
  137. - Before every write it checks the location, the audience, the undo path and the ledger.
  138. - Every change goes to `sandbox/ledger.csv`. At the end it is restored, removed, or listed for you to resolve.
  139. - When you ask it not to interrupt you, it writes what needs you under "Needs human" in `STATUS.md` and keeps working on the rest.
  140. The full procedures are in [references/safety.md](skills/reverse-engineering-saas/references/safety.md).
  141. ## RES and REA
  142. [REA](https://github.com/morluto/rea) is an open-source reverse engineering toolkit for binaries, Android, Electron, network captures and websites. It answers what a product is built with; RES answers how it works for the user and what it takes to rebuild and launch it. We ran both on ClickUp: [docs/comparison-with-rea.md](docs/comparison-with-rea.md).
  143. ## FAQ
  144. <details>
  145. <summary><strong>Will it change my production data?</strong></summary>
  146. Only inside a sandbox you allowed. Every change is recorded in a ledger and, at the end, restored, removed, or listed for you to resolve. Without permission to write, it only observes. Messages, invites, mentions of other people and billing actions are forbidden at every level.
  147. </details>
  148. <details>
  149. <summary><strong>Does it need my password?</strong></summary>
  150. No. The agent never types passwords or creates accounts. You log in, preferably to a trial account in a separate browser profile.
  151. </details>
  152. <details>
  153. <summary><strong>Which agents and browsers work?</strong></summary>
  154. Any agent that reads skills from disk and can drive a browser and run JavaScript in the page. RES was written for Claude Code; the method was tested with Claude Code subagents and the page scripts in headless Chromium. Claude in Chrome, Playwright MCP and Chrome DevTools MCP are covered in [references/tools.md](skills/reverse-engineering-saas/references/tools.md).
  155. </details>
  156. <details>
  157. <summary><strong>Can I leave it running overnight?</strong></summary>
  158. Yes. Tell it not to ask you anything. It records what needs you under "Needs human" in `STATUS.md`, keeps working on the rest, and restores what it changed before it stops.
  159. </details>
  160. <details>
  161. <summary><strong>How do I give the result to my developers?</strong></summary>
  162. Ask for the handoff, or wait for the end of the study. The agent sends `REPORT.html` for people and a zip with the knowledge base and `BUILD.md` for coding agents. Account details (`sandbox/`, `log/`) stay out of the zip, except a copy of the change ledger without object IDs, locations or URLs.
  163. </details>
  164. <details>
  165. <summary><strong>Does it work for desktop or mobile apps?</strong></summary>
  166. Not well. It needs the DOM and the network. For binaries and Electron internals, use [REA](https://github.com/morluto/rea).
  167. </details>
  168. <details>
  169. <summary><strong>Is copying a product legal?</strong></summary>
  170. That depends on the product's terms and your jurisdiction. RES records the relevant terms clause, rebuilds from behavior instead of copying assets, and flags legal questions for counsel. It does not give legal advice.
  171. </details>
  172. ## Documentation
  173. - [SKILL.md](skills/reverse-engineering-saas/SKILL.md): the rules the agent follows.
  174. - [Safety](skills/reverse-engineering-saas/references/safety.md): environment setup, preflight, ledger, teardown, incidents.
  175. - [Exploration](skills/reverse-engineering-saas/references/exploration.md): recon, mapping, per-screen checklist, fixtures, rule probing, synthesis.
  176. - [Production barriers](skills/reverse-engineering-saas/references/barriers.md): categories, sources, format.
  177. - [Knowledge base](skills/reverse-engineering-saas/references/knowledge-base.md): layout, IDs, evidence, checks, handoff.
  178. - [Extraction](skills/reverse-engineering-saas/references/extraction.md): page scripts, design tokens, component names, data model, network.
  179. - [Browser tools](skills/reverse-engineering-saas/references/tools.md): Claude in Chrome, Playwright MCP, Chrome DevTools MCP, separate profiles.
  180. - [Design decisions](docs/design.md) and [testing](docs/testing.md): why RES works this way and how it was tested.
  181. ## Status
  182. Version 0.4.0. The method was tested with scenario runs on subagents, before and after each change to the skill, and the scripts with automated tests on Node.js 22 and 24. Two end-to-end studies on real products (ClickUp at L2, Pipedrive at L3) are in [examples/](examples/). Version 0.3.0 fixes the gaps the Pipedrive study found; the ClickUp study's are tracked in [an issue](https://github.com/alextnetto/res/issues/5). Reports from real runs are welcome: open a [study report](https://github.com/alextnetto/res/issues/new?template=study_report.yml).
  183. ## Responsible use
  184. Use RES only on accounts you own or are authorized to examine. Read the product's terms: many forbid reverse engineering or competing use, and that decision is yours. Rebuild from observed behavior; do not copy code, icons, illustrations, logos or long text. The barrier analysis is research, not legal advice.
  185. ## Contributing
  186. See [CONTRIBUTING.md](CONTRIBUTING.md). Security problems go through [SECURITY.md](SECURITY.md).
  187. ## License
  188. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.