npm - potetos-for-everyone - Versions diffs - 0.1.0 - Mend

potetos-for-everyone 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (144) hide show

package/.agents/plugins/marketplace.json +21 -0
package/.claude-plugin/marketplace.json +32 -0
package/.claude-plugin/plugin.json +36 -0
package/.codex-plugin/plugin.json +13 -0
package/.codex-plugin/prompts/architect.md +6 -0
package/.codex-plugin/prompts/arena.md +6 -0
package/.codex-plugin/prompts/automate-me.md +6 -0
package/.codex-plugin/prompts/blast-radius.md +6 -0
package/.codex-plugin/prompts/bro.md +6 -0
package/.codex-plugin/prompts/create-verification-skill.md +6 -0
package/.codex-plugin/prompts/figure-it-out.md +6 -0
package/.codex-plugin/prompts/how.md +6 -0
package/.codex-plugin/prompts/interrogate.md +6 -0
package/.codex-plugin/prompts/maintain-verification-skill.md +6 -0
package/.codex-plugin/prompts/make-bot-ui.md +6 -0
package/.codex-plugin/prompts/no-comments.md +6 -0
package/.codex-plugin/prompts/poteto-mode.md +6 -0
package/.codex-plugin/prompts/recall.md +6 -0
package/.codex-plugin/prompts/reflect.md +6 -0
package/.codex-plugin/prompts/setup-pstack.md +6 -0
package/.codex-plugin/prompts/show-me-your-work.md +6 -0
package/.codex-plugin/prompts/swarm.md +6 -0
package/.codex-plugin/prompts/tdd.md +6 -0
package/.codex-plugin/prompts/teach.md +6 -0
package/.codex-plugin/prompts/technical-writing.md +6 -0
package/.codex-plugin/prompts/typescript-best-practices.md +6 -0
package/.codex-plugin/prompts/unslop.md +6 -0
package/.codex-plugin/prompts/why.md +6 -0
package/AGENTS.md +11 -0
package/LICENSE +22 -0
package/NOTICE.md +17 -0
package/PORTABILITY.md +29 -0
package/README.md +483 -0
package/UPSTREAM.json +9 -0
package/UPSTREAM_INVENTORY.json +13 -0
package/VERSION +1 -0
package/adapters/README.md +9 -0
package/adapters/registry.json +46 -0
package/agents/comment-reviewer.md +3 -0
package/agents/comment-sicko.md +31 -0
package/agents/poteto-agent.md +14 -0
package/assets/logo.png +0 -0
package/automations/benny/FOR_AGENTS.md +5 -0
package/automations/benny/README.md +10 -0
package/automations/benny/skills/reproduce-and-fix-issues/SKILL.md +12 -0
package/automations/benny/skills/triage-issue-reports/SKILL.md +11 -0
package/automations/benny/templates/configuration.example.yaml +11 -0
package/automations/benny/templates/reproduce-automation-prompt.md +1 -0
package/automations/benny/templates/triage-automation-prompt.md +1 -0
package/bin/potetos +547 -0
package/docs/.nojekyll +0 -0
package/docs/guide/01-setup.md +25 -0
package/docs/guide/02-poteto-mode.md +11 -0
package/docs/guide/03-understand.md +5 -0
package/docs/guide/04-design.md +5 -0
package/docs/guide/05-build-and-clean.md +5 -0
package/docs/guide/06-verify-and-ship.md +5 -0
package/docs/guide/07-overnight.md +5 -0
package/docs/guide/08-principles.md +5 -0
package/docs/guide/09-make-it-yours.md +5 -0
package/docs/guide/10-recipes-and-pitfalls.md +8 -0
package/docs/guide/README.md +16 -0
package/docs/index.html +422 -0
package/hooks/hooks.json +17 -0
package/hooks/session-start-context.md +11 -0
package/npm/core.mjs +318 -0
package/npm/postinstall.mjs +22 -0
package/npm/potetos.mjs +145 -0
package/package.json +98 -0
package/runtime/README.md +21 -0
package/runtime/__init__.py +1 -0
package/runtime/capabilities.json +36 -0
package/runtime/config.example.json +17 -0
package/runtime/runner.py +240 -0
package/skills/architect/SKILL.md +14 -0
package/skills/arena/SKILL.md +14 -0
package/skills/automate-me/SKILL.md +11 -0
package/skills/blast-radius/SKILL.md +11 -0
package/skills/bro/SKILL.md +7 -0
package/skills/create-verification-skill/SKILL.md +11 -0
package/skills/figure-it-out/SKILL.md +13 -0
package/skills/how/SKILL.md +14 -0
package/skills/interrogate/SKILL.md +14 -0
package/skills/maintain-verification-skill/SKILL.md +11 -0
package/skills/make-bot-ui/SKILL.md +11 -0
package/skills/no-comments/SKILL.md +11 -0
package/skills/poteto-mode/SKILL.md +93 -0
package/skills/poteto-mode/playbooks/authoring-a-skill.md +7 -0
package/skills/poteto-mode/playbooks/autonomous-run.md +7 -0
package/skills/poteto-mode/playbooks/autopilot-full.md +7 -0
package/skills/poteto-mode/playbooks/autopilot-stack.md +7 -0
package/skills/poteto-mode/playbooks/babysit.md +7 -0
package/skills/poteto-mode/playbooks/bug-fix.md +8 -0
package/skills/poteto-mode/playbooks/eval.md +7 -0
package/skills/poteto-mode/playbooks/feature.md +8 -0
package/skills/poteto-mode/playbooks/hillclimb.md +8 -0
package/skills/poteto-mode/playbooks/investigation.md +7 -0
package/skills/poteto-mode/playbooks/multi-phase-plan.md +7 -0
package/skills/poteto-mode/playbooks/opening-a-pr.md +7 -0
package/skills/poteto-mode/playbooks/orchestrate.md +8 -0
package/skills/poteto-mode/playbooks/pause-safely.md +7 -0
package/skills/poteto-mode/playbooks/perf-issue.md +8 -0
package/skills/poteto-mode/playbooks/prototype.md +7 -0
package/skills/poteto-mode/playbooks/refactoring.md +7 -0
package/skills/poteto-mode/playbooks/runtime-forensics.md +7 -0
package/skills/poteto-mode/playbooks/session-pickup.md +7 -0
package/skills/poteto-mode/playbooks/shipping.md +7 -0
package/skills/poteto-mode/playbooks/trace-forensics.md +7 -0
package/skills/poteto-mode/playbooks/visual-parity.md +7 -0
package/skills/poteto-mode/playbooks/worktree-cleanup.md +7 -0
package/skills/principle-attack-the-premise/SKILL.md +20 -0
package/skills/principle-boundary-discipline/SKILL.md +20 -0
package/skills/principle-build-the-lever/SKILL.md +20 -0
package/skills/principle-encode-lessons-in-structure/SKILL.md +20 -0
package/skills/principle-exhaust-the-design-space/SKILL.md +20 -0
package/skills/principle-experience-first/SKILL.md +20 -0
package/skills/principle-fix-root-causes/SKILL.md +20 -0
package/skills/principle-foundational-thinking/SKILL.md +20 -0
package/skills/principle-guard-the-context-window/SKILL.md +20 -0
package/skills/principle-laziness-protocol/SKILL.md +20 -0
package/skills/principle-make-operations-idempotent/SKILL.md +20 -0
package/skills/principle-migrate-callers-then-delete-legacy-apis/SKILL.md +20 -0
package/skills/principle-minimize-reader-load/SKILL.md +20 -0
package/skills/principle-model-the-domain/SKILL.md +20 -0
package/skills/principle-never-block-on-the-human/SKILL.md +20 -0
package/skills/principle-outcome-oriented-execution/SKILL.md +20 -0
package/skills/principle-prove-it-works/SKILL.md +20 -0
package/skills/principle-redesign-from-first-principles/SKILL.md +20 -0
package/skills/principle-separate-before-serializing-shared-state/SKILL.md +20 -0
package/skills/principle-sequence-verifiable-units/SKILL.md +20 -0
package/skills/principle-subtract-before-you-add/SKILL.md +20 -0
package/skills/principle-test-behavior-not-implementation/SKILL.md +20 -0
package/skills/principle-type-system-discipline/SKILL.md +20 -0
package/skills/recall/SKILL.md +13 -0
package/skills/reflect/SKILL.md +11 -0
package/skills/setup-pstack/SKILL.md +12 -0
package/skills/show-me-your-work/SKILL.md +17 -0
package/skills/swarm/SKILL.md +12 -0
package/skills/tdd/SKILL.md +12 -0
package/skills/teach/SKILL.md +11 -0
package/skills/technical-writing/SKILL.md +12 -0
package/skills/typescript-best-practices/SKILL.md +14 -0
package/skills/unslop/SKILL.md +11 -0
package/skills/why/SKILL.md +14 -0

package/docs/guide/07-overnight.md ADDED Viewed

@@ -0,0 +1,5 @@
+# 7. Long autonomous runs
+Use `autonomous-run` for a bounded long task and `orchestrate` for a standing multi-slice project. Define the completion predicate, irreversible-action boundary, and proof for every work unit before starting.
+Maintain a durable decision trail with `show-me-your-work`. Recompute the queue after evidence changes. A host without background execution cannot literally continue after the session ends; the playbook still produces resumable checkpoints and a precise `session-pickup` handoff instead of claiming otherwise.

package/docs/guide/08-principles.md ADDED Viewed

@@ -0,0 +1,5 @@
+# 8. Principles
+The principle skills are small on purpose. They cover scope, data modeling, premise attacks, domain boundaries, types, idempotence, concurrency ownership, root-cause fixes, behavioral tests, runtime proof, context preservation, and encoding recurring lessons into structure.
+Load a principle when it changes a decision. If it does not change a decision, citing it is noise. Explicit user constraints outrank stylistic preference; state the tradeoff rather than silently overriding the request.

package/docs/guide/09-make-it-yours.md ADDED Viewed

@@ -0,0 +1,5 @@
+# 9. Make it yours
+Use `setup-pstack` to record model-role preferences without contaminating canonical skills with model names. Use `automate-me` to derive a personal mode from repeated successful workflows, and `reflect` after a difficult task to encode lessons into reusable checks or skills.
+New host support should normally be one adapter-registry entry and a test. Never copy all skill bodies into a vendor directory; that creates drift immediately.

package/docs/guide/10-recipes-and-pitfalls.md ADDED Viewed

@@ -0,0 +1,8 @@
+# 10. Recipes and pitfalls
+- **Bug:** `poteto-mode` -> bug-fix -> optional `tdd` -> `interrogate` -> real-surface proof.
+- **Architecture:** `architect` -> optional `arena`/`prototype` -> implement -> `blast-radius` -> verify.
+- **Large migration:** multi-phase-plan -> `show-me-your-work` -> verifiable units -> session-pickup as needed.
+- **Performance:** perf-issue or hillclimb -> measured baseline -> one hypothesis at a time -> measured acceptance.
+Common failures: treating sequential role-play as independent review, optimizing without a baseline, preserving legacy APIs by reflex, loading every skill into context, claiming a proxy proves the real surface, and asking the user questions that a reversible experiment could answer.

package/docs/guide/README.md ADDED Viewed

@@ -0,0 +1,16 @@
+# potetos-for-everyone guide
+This guide follows the same learning path as Lauren Tan's upstream pstack guide, but describes capabilities rather than one agent product.
+1. [Setup](01-setup.md)
+2. [Poteto Mode](02-poteto-mode.md)
+3. [Understand before editing](03-understand.md)
+4. [Design boundaries](04-design.md)
+5. [Build and clean](05-build-and-clean.md)
+6. [Verify and ship](06-verify-and-ship.md)
+7. [Long autonomous runs](07-overnight.md)
+8. [Principles](08-principles.md)
+9. [Make it yours](09-make-it-yours.md)
+10. [Recipes and pitfalls](10-recipes-and-pitfalls.md)
+The rule across every host is the same: use the strongest evidence the host can actually obtain, and label weaker fallbacks honestly.

package/docs/index.html ADDED Viewed

@@ -0,0 +1,422 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>How to Use pstack Without Cursor | potetos-for-everyone</title>
+  <meta name="description" content="The definitive guide and universal distribution for running Lauren Tan's pstack and Poteto Mode outside of Cursor in Claude Code, Pi, Codex, and terminal agents." />
+  <meta name="keywords" content="pstack without cursor, how to use pstack without cursor, pstack-claude, pi-pstack, poteto-mode, claude code pstack, open-pstack, pstack terminal, agent skills, coding agents" />
+  <meta name="author" content="TheOnlyFusionCube" />
+  <link rel="canonical" href="https://theonlyfusioncube.github.io/potetos-for-everyone/" />
+  <!-- Open Graph / Facebook / LinkedIn -->
+  <meta property="og:type" content="website" />
+  <meta property="og:url" content="https://theonlyfusioncube.github.io/potetos-for-everyone/" />
+  <meta property="og:title" content="How to Use pstack Without Cursor | potetos-for-everyone" />
+  <meta property="og:description" content="Universal distribution of Lauren Tan's pstack for Claude Code, Pi Agent, Codex, Gemini, and terminal agents. 100% upstream parity (v0.15.0+), zero dependencies." />
+  <meta property="og:image" content="https://raw.githubusercontent.com/TheOnlyFusionCube/potetos-for-everyone/main/assets/logo.png" />
+  <!-- Twitter -->
+  <meta name="twitter:card" content="summary" />
+  <meta name="twitter:title" content="How to Use pstack Without Cursor | potetos-for-everyone" />
+  <meta name="twitter:description" content="Run pstack and Poteto Mode in Claude Code, Pi, Codex, and terminal agents. The modern, up-to-date alternative to pstack-claude and pi-pstack." />
+  <meta name="twitter:image" content="https://raw.githubusercontent.com/TheOnlyFusionCube/potetos-for-everyone/main/assets/logo.png" />
+  <!-- Schema.org JSON-LD Structured Data for Google Search & AI Overviews -->
+  <script type="application/ld+json">
+  {
+    "@context": "https://schema.org",
+    "@graph": [
+      {
+        "@type": "SoftwareApplication",
+        "name": "potetos-for-everyone",
+        "alternateName": [
+          "pstack without cursor",
+          "pstack-claude",
+          "pi-pstack",
+          "pstack for claude code",
+          "open-pstack",
+          "pstack-codex",
+          "poteto-mode"
+        ],
+        "applicationCategory": "DeveloperApplication",
+        "operatingSystem": "Cross-platform (macOS, Linux, Windows)",
+        "description": "Universal distribution of Lauren Tan's pstack and Poteto Mode engineering workflow for Claude Code, Pi Coding Agent, Codex, Gemini, and terminal AI agents.",
+        "url": "https://github.com/TheOnlyFusionCube/potetos-for-everyone",
+        "downloadUrl": "https://www.npmjs.com/package/potetos-for-everyone",
+        "softwareVersion": "0.15.0",
+        "license": "https://opensource.org/licenses/MIT",
+        "author": {
+          "@type": "Person",
+          "name": "Lauren Tan",
+          "url": "https://github.com/poteto"
+        }
+      },
+      {
+        "@type": "FAQPage",
+        "mainEntity": [
+          {
+            "@type": "Question",
+            "name": "How to use pstack without Cursor?",
+            "acceptedAnswer": {
+              "@type": "Answer",
+              "text": "You can use pstack outside of Cursor by installing potetos-for-everyone, the universal open-source distribution. It supports Claude Code natively via plugin (/plugin install pstack@potetos-for-everyone), Pi Coding Agent via pi install npm:potetos-for-everyone, OpenAI Codex via prompt linking, and all terminal agents via npx potetos."
+            }
+          },
+          {
+            "@type": "Question",
+            "name": "Can you use pstack in Claude Code?",
+            "acceptedAnswer": {
+              "@type": "Answer",
+              "text": "Yes. Install potetos-for-everyone using Claude Code's native plugin manager: run `/plugin marketplace add TheOnlyFusionCube/potetos-for-everyone` then `/plugin install pstack@potetos-for-everyone`. It provides automatic SessionStart hooks and native subagents."
+            }
+          },
+          {
+            "@type": "Question",
+            "name": "How to use pstack in Pi coding agent?",
+            "acceptedAnswer": {
+              "@type": "Answer",
+              "text": "Run `pi install npm:potetos-for-everyone` in your terminal. It registers the pi-package manifest, all 47 canonical skills, and /poteto-mode."
+            }
+          },
+          {
+            "@type": "Question",
+            "name": "What is the best alternative to pstack-claude and pi-pstack?",
+            "acceptedAnswer": {
+              "@type": "Answer",
+              "text": "potetos-for-everyone is the modern superset that replaces fragmented single-platform ports. While pstack-claude and pi-pstack are pinned to older releases, potetos-for-everyone tracks upstream pstack v0.15.0+ and supports Claude Code, Pi, Codex, and terminal agents in a single zero-dependency package."
+            }
+          }
+        ]
+      }
+    ]
+  }
+  </script>
+  <style>
+    :root {
+      --bg: #0d1117;
+      --card-bg: #161b22;
+      --border: #30363d;
+      --text: #c9d1d9;
+      --heading: #f0f6fc;
+      --accent: #58a6ff;
+      --accent-hover: #1f6feb;
+      --badge-bg: #21262d;
+      --code-bg: #0d1117;
+      --green: #2ea44f;
+      --purple: #bc8cff;
+    }
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+      background-color: var(--bg);
+      color: var(--text);
+      line-height: 1.6;
+      padding: 2rem 1rem;
+    }
+    .container {
+      max-width: 900px;
+      margin: 0 auto;
+    }
+    header {
+      text-align: center;
+      margin-bottom: 3rem;
+      padding-bottom: 2rem;
+      border-bottom: 1px solid var(--border);
+    }
+    .logo {
+      width: 100px;
+      height: 100px;
+      margin-bottom: 1rem;
+    }
+    h1 {
+      color: var(--heading);
+      font-size: 2.5rem;
+      margin-bottom: 0.5rem;
+    }
+    .tagline {
+      font-size: 1.25rem;
+      color: #8b949e;
+      margin-bottom: 1.5rem;
+    }
+    .badges {
+      display: flex;
+      flex-wrap: wrap;
+      justify-content: center;
+      gap: 0.5rem;
+      margin-bottom: 1.5rem;
+    }
+    .answer-box {
+      background: rgba(88, 166, 255, 0.1);
+      border: 1px solid var(--accent);
+      border-radius: 8px;
+      padding: 1.5rem;
+      margin-bottom: 2.5rem;
+      font-size: 1.1rem;
+    }
+    .answer-box strong { color: var(--heading); }
+    h2 {
+      color: var(--heading);
+      font-size: 1.75rem;
+      margin: 2.5rem 0 1rem;
+      padding-bottom: 0.5rem;
+      border-bottom: 1px solid var(--border);
+    }
+    h3 {
+      color: var(--heading);
+      font-size: 1.3rem;
+      margin: 1.5rem 0 0.5rem;
+    }
+    p { margin-bottom: 1rem; }
+    pre {
+      background: var(--code-bg);
+      border: 1px solid var(--border);
+      border-radius: 6px;
+      padding: 1rem;
+      overflow-x: auto;
+      font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, monospace;
+      font-size: 0.95rem;
+      color: #79c0ff;
+      margin: 0.75rem 0 1.25rem;
+    }
+    code {
+      background: var(--badge-bg);
+      padding: 0.2rem 0.4rem;
+      border-radius: 4px;
+      font-size: 0.9em;
+      font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, monospace;
+      color: #ff7b72;
+    }
+    pre code {
+      background: transparent;
+      padding: 0;
+      color: inherit;
+    }
+    .grid {
+      display: grid;
+      grid-template-columns: 1fr;
+      gap: 1.5rem;
+      margin: 1.5rem 0;
+    }
+    @media(min-width: 768px) {
+      .grid { grid-template-columns: 1fr 1fr; }
+    }
+    .card {
+      background: var(--card-bg);
+      border: 1px solid var(--border);
+      border-radius: 8px;
+      padding: 1.5rem;
+    }
+    .card h3 { margin-top: 0; }
+    table {
+      width: 100%;
+      border-collapse: collapse;
+      margin: 1.5rem 0;
+      font-size: 0.95rem;
+    }
+    th, td {
+      border: 1px solid var(--border);
+      padding: 0.75rem 1rem;
+      text-align: left;
+    }
+    th {
+      background: var(--card-bg);
+      color: var(--heading);
+    }
+    .faq-item {
+      background: var(--card-bg);
+      border: 1px solid var(--border);
+      border-radius: 6px;
+      margin-bottom: 1rem;
+      padding: 1.25rem;
+    }
+    .faq-item h4 {
+      color: var(--heading);
+      font-size: 1.1rem;
+      margin-bottom: 0.5rem;
+    }
+    footer {
+      margin-top: 4rem;
+      padding-top: 2rem;
+      border-top: 1px solid var(--border);
+      text-align: center;
+      color: #8b949e;
+      font-size: 0.9rem;
+    }
+    a { color: var(--accent); text-decoration: none; }
+    a:hover { text-decoration: underline; }
+    .btn {
+      display: inline-block;
+      background: var(--green);
+      color: #fff;
+      font-weight: 600;
+      padding: 0.75rem 1.5rem;
+      border-radius: 6px;
+      margin-top: 1rem;
+      text-decoration: none;
+    }
+    .btn:hover { background: #2c974b; text-decoration: none; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <header>
+      <img class="logo" src="https://raw.githubusercontent.com/TheOnlyFusionCube/potetos-for-everyone/main/assets/logo.png" alt="potetos-for-everyone logo" />
+      <h1>How to Use pstack Without Cursor</h1>
+      <p class="tagline">The Universal Guide to Lauren Tan's pstack &amp; Poteto Mode for Claude Code, Pi, Codex, &amp; Terminal Agents</p>
+      <div class="badges">
+        <a href="https://github.com/TheOnlyFusionCube/potetos-for-everyone"><img src="https://img.shields.io/github/stars/TheOnlyFusionCube/potetos-for-everyone?style=flat&color=yellow" alt="GitHub stars" /></a>
+        <a href="https://www.npmjs.com/package/potetos-for-everyone"><img src="https://img.shields.io/npm/v/potetos-for-everyone?label=npm&color=cb3837" alt="npm" /></a>
+        <img src="https://img.shields.io/badge/Upstream-v0.15.0%2B-blue" alt="Upstream v0.15.0+" />
+        <img src="https://img.shields.io/badge/Dependencies-0-success" alt="Zero Dependencies" />
+        <img src="https://img.shields.io/badge/License-MIT-green" alt="MIT License" />
+      </div>
+      <a class="btn" href="https://github.com/TheOnlyFusionCube/potetos-for-everyone">View on GitHub &rarr;</a>
+    </header>
+    <div class="answer-box">
+      <strong>Can you use pstack outside of Cursor?</strong><br />
+      <strong>Yes.</strong> While pstack was originally created by Lauren Tan (@poteto) as a Cursor IDE plugin, its core behavior—consisting of <code>/poteto-mode</code>, 23 task playbooks, and 23 architectural principles—is defined in open Markdown specifications. <strong><code>potetos-for-everyone</code></strong> is the official universal distribution that brings this exact workflow to <strong>Claude Code</strong>, <strong>Pi Coding Agent</strong>, <strong>OpenAI Codex</strong>, and <strong>terminal agents</strong> with zero dependencies and zero manual file copying.
+    </div>
+    <h2>Why potetos-for-everyone Replaces Fragmented Ports</h2>
+    <p>Previously, running pstack without Cursor required juggling fragmented single-platform ports or manually copying Markdown files:</p>
+    <ul>
+      <li><strong><code>pstack-claude</code>:</strong> Pinned to older upstream v0.14.8 commits, restricted to Claude Code, and collapsed multi-model panels into a single vendor.</li>
+      <li><strong><code>pi-pstack</code>:</strong> Pinned to an older v0.1.0 release, tailored strictly for the Pi agent.</li>
+      <li><strong>Manual DIY Setups:</strong> Required cloning Cursor mirrors and maintaining Markdown copies by hand.</li>
+    </ul>
+    <p><strong><code>potetos-for-everyone</code> unifies all of them into a single continuously synced package (tracking v0.15.0+):</strong></p>
+    <h2>Step-by-Step Installation by Agent</h2>
+    <div class="grid">
+      <div class="card">
+        <h3>🟣 Claude Code (pstack-claude Replacement)</h3>
+        <p>Install via Claude Code's native plugin marketplace:</p>
+        <pre><code>/plugin marketplace add TheOnlyFusionCube/potetos-for-everyone
+/plugin install pstack@potetos-for-everyone</code></pre>
+        <p><strong>Features:</strong> Includes auto-firing <code>SessionStart</code> hooks (activates on startup, <code>/clear</code>, and compact) and registers native <code>poteto-agent</code> &amp; <code>comment-sicko</code> subagents.</p>
+      </div>
+      <div class="card">
+        <h3>🌸 Pi Coding Agent (pi-pstack Replacement)</h3>
+        <p>Install directly with Pi's package manager:</p>
+        <pre><code>pi install npm:potetos-for-everyone
+# or from git:
+pi install git:github.com/TheOnlyFusionCube/potetos-for-everyone</code></pre>
+        <p><strong>Features:</strong> Built-in <code>"pi-package"</code> manifest auto-exposes all 47 skills, 23 playbooks, and the <code>/poteto-mode</code> command.</p>
+      </div>
+      <div class="card">
+        <h3>🤖 OpenAI Codex</h3>
+        <p>Symlink the shared skills and Codex slash prompts:</p>
+        <pre><code>git clone https://github.com/TheOnlyFusionCube/potetos-for-everyone.git
+cd potetos-for-everyone
+mkdir -p ~/.agents/skills ~/.codex/prompts
+for s in skills/*/; do ln -s "$PWD/$s" ~/.agents/skills/"$(basename "$s")"; done
+for p in .codex-plugin/prompts/*.md; do ln -s "$PWD/$p" ~/.codex/prompts/"$(basename "$p")"; done</code></pre>
+        <p><strong>Features:</strong> Enables <code>/poteto-mode</code>, <code>/tdd</code>, <code>/arena</code>, and <code>/architect</code> in Codex.</p>
+      </div>
+      <div class="card">
+        <h3>⚡ Terminal CLI (Zero Setup)</h3>
+        <p>For Windsurf, Copilot, Cline, Roo Code, Gemini CLI, or generic workflows:</p>
+        <pre><code>npx potetos</code></pre>
+        <p><strong>Features:</strong> Auto-detects your workspace and provisions <code>CLAUDE.md</code>, <code>GEMINI.md</code>, <code>AGENTS.md</code>, and IDE rules with zero dependencies.</p>
+      </div>
+    </div>
+    <h2>Feature Comparison</h2>
+    <table>
+      <thead>
+        <tr>
+          <th>Capability</th>
+          <th>potetos-for-everyone (Universal)</th>
+          <th>pstack-claude (Claude only)</th>
+          <th>pi-pstack (Pi only)</th>
+          <th>Manual Custom Setup</th>
+        </tr>
+      </thead>
+      <tbody>
+        <tr>
+          <td><strong>Upstream Version</strong></td>
+          <td><strong>v0.15.0+ (Latest)</strong></td>
+          <td>v0.14.8 (Frozen)</td>
+          <td>v0.1.0 (Outdated)</td>
+          <td>Manual / Stale</td>
+        </tr>
+        <tr>
+          <td><strong>Claude Code Native Plugin</strong></td>
+          <td>&check; Yes (<code>/plugin install</code>)</td>
+          <td>&check; Yes</td>
+          <td>&cross; No</td>
+          <td>&cross; Manual copy</td>
+        </tr>
+        <tr>
+          <td><strong>Pi Agent Package</strong></td>
+          <td>&check; Yes (<code>pi install</code>)</td>
+          <td>&cross; No</td>
+          <td>&check; Yes</td>
+          <td>&cross; Manual copy</td>
+        </tr>
+        <tr>
+          <td><strong>Codex Slash Prompts</strong></td>
+          <td>&check; Yes (24 prompts)</td>
+          <td>&check; Yes</td>
+          <td>&cross; No</td>
+          <td>&cross; No</td>
+        </tr>
+        <tr>
+          <td><strong>Zero-Setup Universal Runner</strong></td>
+          <td>&check; Yes (<code>npx potetos</code>)</td>
+          <td>&cross; No</td>
+          <td>&cross; No</td>
+          <td>&cross; No</td>
+        </tr>
+        <tr>
+          <td><strong>Multi-Model Panels</strong></td>
+          <td>&check; Genuine cross-vendor diversity</td>
+          <td>&cross; Single-vendor only</td>
+          <td>&cross; Single-vendor only</td>
+          <td>&cross; Manual config</td>
+        </tr>
+        <tr>
+          <td><strong>Canonical Skills Count</strong></td>
+          <td><strong>47 skills (all playbooks &amp; principles)</strong></td>
+          <td>31 public + 23 internal</td>
+          <td>44 skills</td>
+          <td>Variable</td>
+        </tr>
+        <tr>
+          <td><strong>Multi-Platform CI</strong></td>
+          <td>&check; macOS, Ubuntu, Windows tested</td>
+          <td>&cross; Linux only</td>
+          <td>&cross; No CI</td>
+          <td>&cross; None</td>
+        </tr>
+      </tbody>
+    </table>
+    <h2>Frequently Asked Questions</h2>
+    <div class="faq-item">
+      <h4>How to use pstack without Cursor?</h4>
+      <p>Install <code>potetos-for-everyone</code> via Claude Code plugin (<code>/plugin install pstack@potetos-for-everyone</code>), Pi CLI (<code>pi install npm:potetos-for-everyone</code>), or the zero-setup runner (<code>npx potetos</code>). It exposes the full Poteto Mode engineering system across all terminal agents.</p>
+    </div>
+    <div class="faq-item">
+      <h4>What is the difference between potetos-for-everyone, pstack-claude, and pi-pstack?</h4>
+      <p><code>pstack-claude</code> and <code>pi-pstack</code> are fragmented single-platform ports pinned to older upstream releases. <code>potetos-for-everyone</code> is the unified, multi-platform superset tracking upstream v0.15.0+ that natively supports Claude Code, Pi, Codex, Cursor, Gemini, and terminal agents in a single zero-dependency package.</p>
+    </div>
+    <div class="faq-item">
+      <h4>What is Poteto Mode?</h4>
+      <p>Poteto Mode is an engineering operating system created by Lauren Tan. Instead of speculative code generation, it enforces structured playbooks, strict Red-Green TDD, blast-radius boundary tracing, and runtime verification.</p>
+    </div>
+    <footer>
+      <p>Original pstack and Poteto Mode by <strong>Lauren Tan (<a href="https://github.com/poteto">@poteto</a>)</strong>. MIT License.</p>
+      <p>Independent multi-platform distribution maintained by <a href="https://github.com/TheOnlyFusionCube">TheOnlyFusionCube</a>.</p>
+    </footer>
+  </div>
+</body>
+</html>

package/hooks/hooks.json ADDED Viewed

@@ -0,0 +1,17 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat \"${CLAUDE_PLUGIN_ROOT}/hooks/session-start-context.md\"",
+            "shell": "bash",
+            "async": false
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/session-start-context.md ADDED Viewed

@@ -0,0 +1,11 @@
+<EXTREMELY_IMPORTANT>
+You have pstack and poteto-mode.
+Before responding to any non-trivial engineering task — a feature, bug fix, refactor, debugging, performance work, or any multi-step code change — invoke the `poteto-mode` skill (or `pstack:poteto-mode`) with the Skill tool and follow it. It is the default entry point and routes to the specific pstack skills from there. Pure questions and trivial one-line edits don't need it.
+When the intent is already specific, enter directly: `tdd` (or `pstack:tdd` - bug with a reproducible failure), `architect` (`pstack:architect` - types and module shape before code that crosses a function boundary), `how` (`pstack:how` - how a subsystem works), `why` (`pstack:why` - why it was built this way), `arena` (`pstack:arena` - N parallel attempts at one task), `interrogate` (`pstack:interrogate` - multi-model diff review), `unslop` (`pstack:unslop` - remove AI-tell commentary and boilerplate).
+If you were dispatched as a subagent to execute a specific task, ignore this block — poteto-mode governs the orchestrating session, and it already shaped your dispatch.
+User instructions (CLAUDE.md, AGENTS.md, direct requests) take precedence over this mandate. Other session-start mandates (such as superpowers) compose with it: their skill-check discipline stands, and poteto-mode is the implementation entry point they route to for non-trivial code work.
+</EXTREMELY_IMPORTANT>