Skip to content

Restore the upstream README and drop the Claude Code adapter - #29

Merged
caelaxie merged 3 commits into
mainfrom
cursor/restore-readme-drop-claude-adapter-9106
Oct 21, 2026
Merged

caelaxie merged 3 commits into
mainfrom
cursor/restore-readme-drop-claude-adapter-9106

Conversation

@caelaxie

@caelaxie caelaxie commented Oct 21, 2026 •

Copy link
Copy Markdown
Contributor

Closes #8
Closes #9

The README is upstream pstack/README.md at 88d4751 again, including the skill tables and the 0.15.29 /sharpen row. The install block is the Droid marketplace commands. The cursor-team-kit bundling credit stays under the title, and deslop, control-cli, and control-ui are no longer described as missing.

Harness renames, only where a line names a Cursor-only feature:

  • agents/ → droids/, generalPurpose → worker, plus one sentence for poteto-judgment because Task has no per-spawn model
  • install, custom-mode keybinding, and cursor.com docs → Droid install and "start each task with /poteto-mode"
  • /loop and spec mode named as Droid's, not Cursor's plan mode
  • model config path → ~/.factory/AGENTS.md
  • Benny path → .factory/automations/benny/
  • /make-bot-ui row wakes a Droid
  • /create-skill described as the Droid user pane, not a Cursor built-in

The opening stays poteto's except the two harness names: "this turns droid into a real engineering team" and "droid gives you the best of all worlds." "ship high quality code at Cursor" stays. That one is about working there.

docs/harness/claude-code.md is deleted. Nothing in the port links to it, and it only maps Cursor names onto Claude Code.

Open in Web Open in Cursor 

The install stub pointed readers at Cursor setup. The README is the upstream text again, with the Droid install commands, the cursor-team-kit bundle credit, and the harness renames the rest of the port already uses. docs/harness/claude-code.md is a Cursor-to-Claude shim nothing in this port reads.

Co-authored-by: Kaitian Xie <caelaxie@users.noreply.github.com>
@cursor

cursor Bot commented Oct 21, 2026

Copy link
Copy Markdown

Harness proof. Command output is unedited.

HOME=/tmp/droid-proof-readme
which=/tmp/droid-proof-readme/.local/bin/droid
0.245.0
===== droid plugin marketplace add =====
Successfully added marketplace: droid-pstack@cursor-restore-readme-drop-claude-adapter-9106
===== droid plugin install =====
Successfully installed pstack@droid-pstack@cursor-restore-readme-drop-claude-adapter-9106 (2803587)
===== droid plugin list =====
Installed plugins:
Active:
  pstack@droid-pstack@cursor-restore-readme-drop-claude-adapter-9106  [user]  2803587
$ git -C /tmp/droid-proof-readme/.factory/plugins/cache/droid-pstack@cursor-restore-readme-drop-claude-adapter-9106-c5cc135c6029/pstack-7171b73fae68/2803587d245b rev-parse HEAD
2803587d245bb3f7ed95b6b3f7207e99daa43425
(exit 0)
$ echo expected
2803587d245bb3f7ed95b6b3f7207e99daa43425
$ git -C /workspace diff --name-status 3a60c3580a01bba100804e6efe3395d9f5dd924e cursor/restore-readme-drop-claude-adapter-9106
M	README.md
D	docs/harness/claude-code.md
(exit 0)
MATCH README.md
DELETED docs/harness/claude-code.md
===== droid exec =====
Skill "poteto-mode" activated
Error during droid execution: Authentication failed. Please log in using /login or set a valid FACTORY_API_KEY environment variable.

@caelaxie caelaxie left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

verdict: changes requested (comment review, same account). not merging.

passes: validate plugin green at 2803587, Closes #8 / Closes #9, not a draft. docs/harness/claude-code.md is gone and nothing links to it. i diffed the readme against upstream pstack/README.md at 88d4751: tables, /sharpen row, principles, and sections are all there, and the install block is the droid one. the agents/ -> droids/, generalPurpose -> worker, setup path, and benny path renames are right.

blocking:

  1. L9 and L13 still name cursor as the harness. "this turns cursor into a real engineering team" and "cursor gives you the best of all worlds." are claims about the product the reader is running, not about working at Cursor, and multi-model isn't Cursor-only. the pr renamed the same kind of line at L51 and L110 ("so droid attaches", "droid's /loop"), so do the same here: cursor -> droid in those two sentences only. "ship high quality code at Cursor" and the Meta/Netflix/Cursor line stay.

non-blocking:

  • L108 says how to keep /poteto-mode on across turns, then says it fades. droid has no custom mode, so say that plainly, e.g. "droid has no persistent mode, so start each new task with /poteto-mode."
  • L36 and the subagents section don't list poteto-agent-readonly / poteto-judgment-readonly, which landed in #26. not this issue's scope; fine as a follow-up.

@caelaxie caelaxie left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

line comments for the review above.

Comment thread README.md Outdated
## Install
there's a growing sense that ai writes too much slop code. i agree. i don't want to ship like a team of twenty slop artists. throughput without quality is not a goal i aspire to. if you want to go fast, go deep first.

**pstack is my answer.** these are the same skills i use every day to ship high quality code at Cursor. this turns cursor into a real engineering team. the goal is not to maximize loc, in fact it's the opposite. pstack helps you write less, but higher quality code.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

blocking: "this turns cursor into a real engineering team" -> "this turns droid into a real engineering team". keep "ship high quality code at Cursor"; that one is about working there.

Comment thread README.md Outdated

**pstack gives you fearless parallelism.** when you can go deep on one agent and trust it to write good, verifiable code, you can truly parallelize with confidence. start multiple agents up with `poteto-mode` and trust that they'll apply rigorous engineering principles to their work.

**cursor gives you the best of all worlds.** every frontier model has its strengths and weaknesses. use any model with pstack. in fact, many of my skills use multi-model workflows to take advantage of each model's unique strengths.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

blocking: "cursor gives you the best of all worlds." -> "droid gives you the best of all worlds.". droid runs many models too, so this is the harness rename, not a rewrite.

Comment thread README.md

the full rules and playbooks live in [`skills/poteto-mode/SKILL.md`](./skills/poteto-mode/SKILL.md).

to keep [`/poteto-mode`](./skills/poteto-mode/SKILL.md) on across turns, start each new task with `/poteto-mode`. droid attaches it to that message, and it fades as the chat moves on.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

non-blocking: the sentence tells you how to keep it on, then says it fades. droid has no custom mode, so say that: "droid has no persistent mode, so start each new task with /poteto-mode."

cursoragent and others added 2 commits October 21, 2026 02:44
The lines that say the tool turns into an engineering team and gives the best of all worlds were still calling the harness Cursor.

Co-authored-by: Kaitian Xie <caelaxie@users.noreply.github.com>
Co-authored-by: Kaitian Xie <caelaxie@users.noreply.github.com>
@cursor

cursor Bot commented Oct 21, 2026

Copy link
Copy Markdown

Harness proof for 1c06f87. Command output is unedited.

HOME=/tmp/droid-proof-readme3
which=/tmp/droid-proof-readme3/.local/bin/droid
0.245.0
===== droid plugin marketplace add =====
Successfully added marketplace: droid-pstack@cursor-restore-readme-drop-claude-adapter-9106
marketplace_add_exit=0
===== droid plugin install =====
Successfully installed pstack@droid-pstack@cursor-restore-readme-drop-claude-adapter-9106 (1c06f87)
install_exit=0
===== droid plugin list =====
Installed plugins:
Active:
  pstack@droid-pstack@cursor-restore-readme-drop-claude-adapter-9106  [user]  1c06f87
list_exit=0
$ git -C /tmp/droid-proof-readme3/.factory/plugins/cache/droid-pstack@cursor-restore-readme-drop-claude-adapter-9106-c5cc135c6029/pstack-7171b73fae68/1c06f87247ee rev-parse HEAD
1c06f87247ee29c22b982c5dc0f6d12c43eff624
(exit 0)
$ echo expected
1c06f87247ee29c22b982c5dc0f6d12c43eff624
$ git -C /workspace diff --name-status origin/main HEAD
M	README.md
D	docs/harness/claude-code.md
(exit 0)
MATCH README.md
DELETED docs/harness/claude-code.md
===== droid exec =====
Skill "poteto-mode" activated
Error during droid execution: Authentication failed. Please log in using /login or set a valid FACTORY_API_KEY environment variable.
exec_exit=1

@caelaxie caelaxie left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

verdict: pass at 1c06f87, merging.

  • diffed against the last reviewed head 2803587: only L9 and L13 changed, both cursor -> droid. the Cursor biography lines are unchanged.
  • readme against upstream 88d4751: only the install block and the harness renames differ. docs/harness/claude-code.md is deleted and nothing points at it.
  • validate plugin is green at 1c06f87, and the harness proof comment is at the same sha (marketplace add, install, list, cache HEAD match). droid exec failed on auth in the proof, which isn't part of the bar.
  • Closes #8 / Closes #9, not a draft.

the L108 wording and listing the read-only twins are still open as follow-ups, not blockers.

@caelaxie
caelaxie merged commit dff589a into main Oct 21, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

audit: claude code adapter is still shipped audit: readme replaces the upstream readme with an install stub

2 participants