potetos-for-everyone 0.1.0

package/.agents/plugins/marketplace.json

@@ -0,0 +1,21 @@
+{
+  "name": "potetos-for-everyone",
+  "interface": {
+    "displayName": "potetos-for-everyone (pstack universal)"
+  },
+  "plugins": [
+    {
+      "name": "pstack",
+      "source": {
+        "source": "local",
+        "path": "./"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL",
+        "products": ["CODEX"]
+      },
+      "category": "Developer Tools"
+    }
+  ]
+}

package/.claude-plugin/marketplace.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
+  "name": "potetos-for-everyone",
+  "owner": {
+    "name": "TheOnlyFusionCube",
+    "url": "https://github.com/TheOnlyFusionCube"
+  },
+  "description": "Universal distribution of Lauren Tan's pstack & Poteto Mode for Claude Code, Cursor, Codex, Gemini CLI, Prime Agent, and all AI agents. (pstack-claude alternative & superset).",
+  "plugins": [
+    {
+      "name": "pstack",
+      "description": "Lauren Tan's pstack & Poteto Mode engineering workflow for Claude Code: evidence-first, minimal blast radius, TDD, and rigorous verification. Full v0.15.0+ upstream sync.",
+      "source": "./",
+      "category": "developer-tools",
+      "version": "0.15.0"
+    },
+    {
+      "name": "poteto-mode",
+      "description": "Poteto Mode workflow for Claude Code: disciplined engineering, systematic decomposition, and rigorous verification.",
+      "source": "./",
+      "category": "developer-tools",
+      "version": "0.15.0"
+    },
+    {
+      "name": "pstack-claude",
+      "description": "Drop-in replacement and superset for pstack-claude with complete upstream v0.15.0+ parity, SessionStart hooks, and multi-agent support.",
+      "source": "./",
+      "category": "developer-tools",
+      "version": "0.15.0"
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,36 @@
+{
+  "name": "pstack",
+  "displayName": "pstack / poteto-mode (Universal Claude Code & Multi-Agent Edition)",
+  "version": "0.15.0",
+  "description": "If you want to go fast, go deep first. Lauren Tan's pstack and Poteto Mode engineering workflow: evidence-first, minimal blast radius, TDD, behavioral verification, and parallel execution. Upstream v0.15.0+.",
+  "author": {
+    "name": "TheOnlyFusionCube",
+    "url": "https://github.com/TheOnlyFusionCube"
+  },
+  "homepage": "https://github.com/TheOnlyFusionCube/potetos-for-everyone",
+  "repository": "https://github.com/TheOnlyFusionCube/potetos-for-everyone",
+  "license": "MIT",
+  "keywords": [
+    "pstack",
+    "pstack-claude",
+    "poteto-mode",
+    "claude-code",
+    "claude-code-plugin",
+    "claude-plugin",
+    "claude-skills",
+    "codex",
+    "codex-plugin",
+    "cursor",
+    "agent-skills",
+    "coding-agents",
+    "subagents",
+    "tdd",
+    "unslop",
+    "code-review",
+    "gemini-cli",
+    "prime-agent",
+    "opencode",
+    "windsurf",
+    "copilot"
+  ]
+}

package/.codex-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "pstack",
+  "displayName": "pstack / poteto-mode (Universal Multi-Agent Edition)",
+  "version": "0.15.0",
+  "description": "Lauren Tan's pstack and Poteto Mode engineering workflow for Codex, Claude Code, and any AI coding agent.",
+  "author": {
+    "name": "TheOnlyFusionCube",
+    "url": "https://github.com/TheOnlyFusionCube"
+  },
+  "homepage": "https://github.com/TheOnlyFusionCube/potetos-for-everyone",
+  "repository": "https://github.com/TheOnlyFusionCube/potetos-for-everyone",
+  "license": "MIT"
+}

package/.codex-plugin/prompts/architect.md

@@ -0,0 +1,6 @@
+---
+name: architect
+description: Settle data shapes, ownership, boundaries, and interfaces before code crosses a function/module boundary. Use for non-trivial design work.
+---
+
+Invoke the `architect` skill and follow it.

package/.codex-plugin/prompts/arena.md

@@ -0,0 +1,6 @@
+---
+name: arena
+description: Spawn parallel candidate implementations for the same task, cross-judge, and graft the best parts into the winning base. Use when exploring competing designs or critical artifacts.
+---
+
+Invoke the `arena` skill and follow it.

package/.codex-plugin/prompts/automate-me.md

@@ -0,0 +1,6 @@
+---
+name: automate-me
+description: Create a personal mode skill from recurring workflow patterns in available history. Use when the user wants their own agent style encoded.
+---
+
+Invoke the `automate-me` skill and follow it.

package/.codex-plugin/prompts/blast-radius.md

@@ -0,0 +1,6 @@
+---
+name: blast-radius
+description: Prove what a small-looking change can affect before or after editing. Use for compatibility, caller, state, schema, or behavior impact analysis.
+---
+
+Invoke the `blast-radius` skill and follow it.

package/.codex-plugin/prompts/bro.md

@@ -0,0 +1,6 @@
+---
+name: bro
+description: Restate the last technical explanation in plain human language with minimal jargon. Use when the user asks for a simpler version.
+---
+
+Invoke the `bro` skill and follow it.

package/.codex-plugin/prompts/create-verification-skill.md

@@ -0,0 +1,6 @@
+---
+name: create-verification-skill
+description: Generate a project-local verification skill that drives the real app and captures evidence. Use when setting up automated verification for a repo.
+---
+
+Invoke the `create-verification-skill` skill and follow it.

package/.codex-plugin/prompts/figure-it-out.md

@@ -0,0 +1,6 @@
+---
+name: figure-it-out
+description: Design a rigorous custom playbook when no bundled playbook safely fits a large or unusual task. Use for cross-cutting ambiguous execution.
+---
+
+Invoke the `figure-it-out` skill and follow it.

package/.codex-plugin/prompts/how.md

@@ -0,0 +1,6 @@
+---
+name: how
+description: Trace how a subsystem works using code and runtime evidence. Use for architecture walkthroughs, data flow, call paths, and are-we-sure investigations.
+---
+
+Invoke the `how` skill and follow it.

package/.codex-plugin/prompts/interrogate.md

@@ -0,0 +1,6 @@
+---
+name: interrogate
+description: Adversarially review a diff or design with independent lenses and evidence. Use before shipping contested or high-impact changes.
+---
+
+Invoke the `interrogate` skill and follow it.

package/.codex-plugin/prompts/maintain-verification-skill.md

@@ -0,0 +1,6 @@
+---
+name: maintain-verification-skill
+description: Repair a project verification skill whose feature map or commands drifted. Use when app behavior and verification docs no longer agree.
+---
+
+Invoke the `maintain-verification-skill` skill and follow it.

package/.codex-plugin/prompts/make-bot-ui.md

@@ -0,0 +1,6 @@
+---
+name: make-bot-ui
+description: Build a small operator UI over an agent/webhook backend. Use when buttons or controls should trigger an agent workflow.
+---
+
+Invoke the `make-bot-ui` skill and follow it.

package/.codex-plugin/prompts/no-comments.md

@@ -0,0 +1,6 @@
+---
+name: no-comments
+description: Remove redundant comments, dead workaround explanations, and AI tells from code while preserving necessary constraints. Use when cleaning up code or diffs.
+---
+
+Invoke the `no-comments` skill and follow it.

package/.codex-plugin/prompts/poteto-mode.md

@@ -0,0 +1,6 @@
+---
+name: poteto-mode
+description: Lauren Tan-inspired rigorous engineering mode for concise communication, deliberate decomposition, simple code, independent review when available, and runtime verification. Use for non-trivial engineering tasks or when the user asks for Poteto Mode/pstack-style rigor.
+---
+
+Invoke the `poteto-mode` skill and follow it.

package/.codex-plugin/prompts/recall.md

@@ -0,0 +1,6 @@
+---
+name: recall
+description: Reconstruct current task context from available durable history and records. Use when resuming work or rebuilding context on a topic.
+---
+
+Invoke the `recall` skill and follow it.

package/.codex-plugin/prompts/reflect.md

@@ -0,0 +1,6 @@
+---
+name: reflect
+description: Convert lessons from a completed difficult task into structural improvements. Use after a long or unexpectedly painful workflow.
+---
+
+Invoke the `reflect` skill and follow it.

package/.codex-plugin/prompts/setup-pstack.md

@@ -0,0 +1,6 @@
+---
+name: setup-pstack
+description: Configure potetos-for-everyone model roles and capability preferences for the current agent/runtime. Use during initial setup or routing changes.
+---
+
+Invoke the `setup-pstack` skill and follow it.

package/.codex-plugin/prompts/show-me-your-work.md

@@ -0,0 +1,6 @@
+---
+name: show-me-your-work
+description: Maintain a compact auditable decision trail during autonomous or high-stakes work. Use when the user will review decisions later.
+---
+
+Invoke the `show-me-your-work` skill and follow it.

package/.codex-plugin/prompts/swarm.md

@@ -0,0 +1,6 @@
+---
+name: swarm
+description: Fan out independent slices or coverage partitions and aggregate them with owner verification. Use for large audits, races, and parallel work.
+---
+
+Invoke the `swarm` skill and follow it.

package/.codex-plugin/prompts/tdd.md

@@ -0,0 +1,6 @@
+---
+name: tdd
+description: Write a minimal failing test before implementation, make it pass with the simplest code, and refactor cleanly. Use when implementing bug fixes or features with clear verification targets.
+---
+
+Invoke the `tdd` skill and follow it.

package/.codex-plugin/prompts/teach.md

@@ -0,0 +1,6 @@
+---
+name: teach
+description: Teach a subsystem or change so the reader can reason about it, combining how and why evidence. Use for real understanding rather than summary.
+---
+
+Invoke the `teach` skill and follow it.

package/.codex-plugin/prompts/technical-writing.md

@@ -0,0 +1,6 @@
+---
+name: technical-writing
+description: Write maintainable technical docs, RFCs, READMEs, PR descriptions, and commit messages. Use for durable engineering prose.
+---
+
+Invoke the `technical-writing` skill and follow it.

package/.codex-plugin/prompts/typescript-best-practices.md

@@ -0,0 +1,6 @@
+---
+name: typescript-best-practices
+description: Apply disciplined TypeScript modeling and boundary parsing. Use when reading or editing TypeScript.
+---
+
+Invoke the `typescript-best-practices` skill and follow it.

package/.codex-plugin/prompts/unslop.md

@@ -0,0 +1,6 @@
+---
+name: unslop
+description: Cut AI tells, filler prose, superficial -ing phrases, and bloated commentary from writing and code. Use for all written deliverables and code cleanup.
+---
+
+Invoke the `unslop` skill and follow it.

package/.codex-plugin/prompts/why.md

@@ -0,0 +1,6 @@
+---
+name: why
+description: Recover why a system or decision exists by triangulating source history and connected evidence. Use for rationale archaeology and historical questions.
+---
+
+Invoke the `why` skill and follow it.

package/AGENTS.md

@@ -0,0 +1,11 @@
+# potetos-for-everyone agent bootstrap
+
+This repository contains a portable engineering skill stack adapted from Lauren Tan's pstack.
+
+When working in this repository:
+
+1. Treat `skills/` as canonical. Never fork behavioral instructions into an adapter.
+2. For non-trivial work, read `skills/poteto-mode/SKILL.md`, select its matching playbook, and follow the referenced leaf skills only as needed.
+3. Interpret capability names via `PORTABILITY.md`. Feature-detect host tools instead of assuming a vendor API.
+4. Preserve the Lauren Tan attribution in `NOTICE.md` and `LICENSE`.
+5. Run `./scripts/verify` before declaring repository changes complete.

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Lauren Tan (portions derived from pstack)
+Copyright (c) 2026 potetos-for-everyone contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE.md

@@ -0,0 +1,17 @@
+# Attribution and provenance
+
+`potetos-for-everyone` is an independent, portability-focused adaptation of **pstack**.
+
+## Original work
+
+- **pstack / Poteto Mode:** Lauren Tan (GitHub: `@poteto`)
+- Upstream: https://github.com/cursor/plugins/tree/main/pstack
+- Upstream license: MIT
+- Upstream copyright: **Copyright (c) 2026 Lauren Tan**
+- Initial adaptation baseline: `d7cde2b84eadbcd6fd890302c876f4436ccb6d82`
+
+Lauren Tan's original pstack introduced the core architecture this project adapts: Poteto Mode as a routing skill, task-specific engineering playbooks, small principle skills, deliberate multi-agent review/fan-out, and verification as a completion condition.
+
+This repository rewrites those ideas around a vendor-neutral capability contract and the open Agent Skills format. It is not affiliated with or endorsed by Lauren Tan or Cursor unless they explicitly say otherwise.
+
+The original MIT copyright and permission notice are preserved in `LICENSE` as required for copied or substantially adapted portions.

package/PORTABILITY.md

@@ -0,0 +1,29 @@
+# Portability contract
+
+The canonical `skills/` tree is runtime-neutral. A skill asks for a capability, not a product API.
+
+## Capabilities
+
+| Capability | Meaning | Required fallback |
+|---|---|---|
+| `files.read` | Read repository/workspace content | Ask for supplied context only when nothing readable exists |
+| `files.write` | Make workspace edits | Return an exact patch/draft when writes are unavailable |
+| `run` | Execute commands, tests, profilers, or scripts | State that runtime proof is unavailable; do not claim success |
+| `vcs` | Inspect diff/history/branches/PR state | Use available repository files; label missing history explicitly |
+| `delegate` | Spawn isolated workers/subagents | Run sequential passes; label them non-independent |
+| `search` | Query web, docs, issues, chat, observability, analytics | Use only available evidence and report the gap |
+| `observe` | Drive/inspect the real UI, service, device, CLI, or artifact | Use the closest artifact only as a proxy and label it |
+| `track` | Maintain todos/decision logs/checkpoints | Write a small repo-local Markdown/TSV log when writes exist |
+
+## Rules
+
+1. Do not name a vendor-specific tool in canonical workflow instructions unless the vendor itself is the subject of the task.
+2. Feature-detect. Never assume subagents, a browser, a PR API, MCP, memory, or a particular model exists.
+3. A fallback must preserve epistemic honesty. Sequential role-play is not independent review. A compile is not runtime proof. A screenshot description is not pixel comparison.
+4. Prefer the open Agent Skills package shape: `SKILL.md` plus optional `scripts/`, `references/`, and `assets/`.
+5. Keep model routing in `.potetos/config.json`, outside canonical skill logic.
+6. Irreversible or externally consequential actions remain safety-gated by the host agent's own policy and permissions.
+
+## Host adapters
+
+Adapters do only two things: expose skill discovery and tell a host how to invoke the canonical files. They must not fork skill behavior. If an adapter needs different behavior, change the capability contract or the canonical skill instead.