Skip to content

audit: readme is a stub instead of the upstream pstack readme #15

Closed

Description

@caelaxie

port: README.md L1–21

upstream: pstack/README.md at 88d4751 (pstack 0.15.29), the full readme (288 lines). It opens:

pstack

i'm poteto. i'm not a president or ceo, but i've worked with millions of lines of code at Meta, Netflix, and Cursor. ...

and runs through ## install, ## get started, ## usage, ## skills (the skill table, including the /sharpen row from cursor/plugins#729), ### examples, the poteto-agent and Comment Sicko section, ## principles, ## not shipped here, ## why are there no planning skills?, ## make it yours, ## automations, and ## license.

port: a 21-line stub:

devin-pstack

Devin (devin) port of pstack (0.15.29) by Lauren Tan (poteto).

See the upstream pstack README and the guide for usage and documentation.

followed by the install block. #14 skipped the /sharpen table row on the grounds that "this port's readme is a pointer, not a copy of the upstream catalog".

why devin doesn't require it: Devin only changes how the plugin is installed. Nothing in the harness needs the readme replaced. The stub also links cursor/plugins/blob/main, which moves past the pinned ref, and it points readers at a readme full of Cursor install steps and /poteto-mode names that don't work in Devin.

smallest fix: restore upstream pstack/README.md at 88d4751. Change only:

  • the ## install block to devin plugins install pstack-ports/devin-pstack, then devin plugins list;
  • drop the Claude Code install lines and the two paragraphs after them (claude code prefixes, the harness/pstack/ generator);
  • /pstack: prefixes on pstack skills, and the same Devin adaptations the guide already uses (paths, Custom Modes to AGENTS.md, and so on).

Keep the version marker the repo already records.

found by the whole-port audit against upstream 88d4751 (pstack 0.15.29). fix with Closes #15.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions