Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions .github/scripts/extract-data.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
#!/usr/bin/env node
const fs = require('fs');
const path = require('path');

const repoRoot = path.resolve(__dirname, '..', '..');
const indexPath = process.argv[2] || path.join(repoRoot, 'index.html');

const html = fs.readFileSync(indexPath, 'utf8');
const scriptMatch = html.match(/<script>([\s\S]*?)<\/script>/);
if (!scriptMatch) {
console.error('No <script> block found in index.html');
process.exit(1);
}

const script = scriptMatch[1];
// Data declarations are at the top, before the DOM helpers begin.
const splitMarker = script.match(/\nconst\s+\$\s*=/)?.index;
const dataCode = splitMarker ? script.slice(0, splitMarker) : script;

const code = `${dataCode.trim()}\nreturn {PLAYBOOKS, SKILLS, GROUPS, PRINCIPLES, MODELS, KEYWORDS, EXAMPLES, EXAMPLE_CHIPS};`;
const fn = new Function(code);
console.log(JSON.stringify(fn(), null, 2));
363 changes: 363 additions & 0 deletions .github/scripts/generate.py

Large diffs are not rendered by default.

14 changes: 11 additions & 3 deletions .github/workflows/sync-pstack.yml
Original file line number Diff line number Diff line change
Expand Up @@ -29,12 +29,20 @@ jobs:
with:
python-version: '3.12'

- name: Set up Node
uses: actions/setup-node@v4
with:
node-version: '20'

- name: Poll upstream pstack changes
id: sync
run: python3 .github/scripts/sync-pstack.py 2>&1 | tee sync.log
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

- name: Generate AI-friendly site files
run: python3 .github/scripts/generate.py

- name: Sync summary
if: always()
run: |
Expand All @@ -56,13 +64,13 @@ jobs:
echo "changed=true" >> "$GITHUB_OUTPUT"
fi

- name: Commit and push changelog
- name: Commit and push generated files
if: steps.changes.outputs.changed == 'true'
run: |
git config user.name "github-actions[bot]"
git config user.email "github-actions[bot]@users.noreply.github.com"
git add changelog.json
git commit -m "chore: sync pstack changelog"
git add changelog.json changelog.html changelog.md llms-full.txt
git commit -m "chore: sync pstack changelog and regenerate AI files"
git push

- name: Setup Pages
Expand Down
8 changes: 6 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,13 @@ Open `index.html` or `changelog.html` in any browser, or run `python3 -m http.se

`changelog.json` is the upstream pstack digest, generated by `.github/scripts/sync-pstack.py`.

`changelog.html` is the standalone page that renders `changelog.json`.
`changelog.html` is the standalone, pre-rendered changelog page.

`.github/workflows/sync-pstack.yml` runs weekly and fetches any new commits from `cursor/plugins/pstack`. If it finds changes, it commits an updated `changelog.json` and redeploys the site.
`changelog.md` is a plain Markdown version of the changelog for AI agents.

`llms.txt` and `llms-full.txt` provide LLM-readable context about the whole site.

`.github/workflows/sync-pstack.yml` runs weekly and fetches any new commits from `cursor/plugins/pstack`. If it finds changes, it commits an updated `changelog.json`, then runs `.github/scripts/generate.py` to regenerate `changelog.html`, `changelog.md`, and `llms-full.txt` before redeploying the site.

`og.png` and the `favicon.*` / `apple-touch-icon.png` files are the social preview and icon assets.

Expand Down
432 changes: 363 additions & 69 deletions changelog.html

Large diffs are not rendered by default.

59 changes: 59 additions & 0 deletions changelog.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
# pstack upstream changelog

Source: https://github.com/cursor/plugins/tree/main/pstack
Last synced: 2026-07-13T11:10:51+00:00
Last commit: a29f5a8ca161b1de4ffc5484454958bebc04eaa5

## Recent changes

- [2026-07-12] [pstack: bump version to 0.11.2 (#154)](https://github.com/cursor/plugins/commit/a29f5a8ca161b1de4ffc5484454958bebc04eaa5) (a29f5a8) by poteto
- [2026-07-12] [pstack: add the teach skill (compose how + why into one explanation) (#153)](https://github.com/cursor/plugins/commit/8f008c41981dca484d5beaf688d3aa2ea4ecf89b) (8f008c4) by poteto
- [2026-07-12] [pstack: bump version to 0.11.1 (#152)](https://github.com/cursor/plugins/commit/20bdb6cdfdd8ffa683befe62d76104e5654c861d) (20bdb6c) by poteto
- [2026-07-12] [maintain-verification-skill: cleanup granularity, re-doctor, evidence checks (#151)](https://github.com/cursor/plugins/commit/6714489fa233263f00e419f6cfc4759b07c81056) (6714489) by poteto
- [2026-07-12] [pstack: add create-verification-skill and maintain-verification-skill (#150)](https://github.com/cursor/plugins/commit/e42d29fd5c8fe4f13e3bee7f53b35f410f65aee8) (e42d29f) by poteto
- [2026-07-11] [pstack: give poteto-mode a human display name (#149)](https://github.com/cursor/plugins/commit/9d2a3f2d12bbe0dca3e61bbc0e9dbfe2df09fb56) (9d2a3f2) by poteto
- [2026-07-11] [pstack: lead the README with the two-step quickstart (#148)](https://github.com/cursor/plugins/commit/9251b2666bc9876396825c1f0df5685dbdaaddb5) (9251b26) by poteto
- [2026-07-11] [pstack: add model-the-domain principle; true up README (#147)](https://github.com/cursor/plugins/commit/a8145426e541afa424a403e3866496216c1b8142) (a814542) by poteto
- [2026-07-09] [pstack: make poteto-mode a sticky mode with a conditional reminder (#144)](https://github.com/cursor/plugins/commit/0dda29e839d15464a137af9935665a5a47ee09b8) (0dda29e) by poteto
- [2026-07-08] [pstack: route hardest tasks to claude-fable-5-thinking-max (#143)](https://github.com/cursor/plugins/commit/9b80b5349872b2a3404be58bd9236cc9b83833bb) (9b80b53) by poteto
- [2026-07-08] [pstack: route composer slots to grok-4.5-fast-xhigh (#142)](https://github.com/cursor/plugins/commit/dc2fae6625a268361243ca044eb5af141c124704) (dc2fae6) by poteto
- [2026-06-24] [pstack: add Benny issue automation pack (#137)](https://github.com/cursor/plugins/commit/0452e08a314c03621ec5ac1324f1ad1dd824f1a4) (0452e08) by poteto
- [2026-06-17] [pstack: add recall and blast-radius skills (#135)](https://github.com/cursor/plugins/commit/e46364b8be46000b7df0f260550cd712afbb8d36) (e46364b) by poteto
- [2026-06-14] [pstack: bump to 0.9.1, list the hillclimb playbook in the README (#133)](https://github.com/cursor/plugins/commit/cfd81b3961ef5fddc90e9f2994fa1c87cd454e61) (cfd81b3) by poteto
- [2026-06-14] [poteto-mode: add the Hillclimb playbook and tighten Autonomous run stop semantics (#132)](https://github.com/cursor/plugins/commit/b64f02a456924867d0d293cdb2f94eaecd25b50a) (b64f02a) by poteto
- [2026-06-07] [pstack: sync README with shipped principles and playbooks (#126)](https://github.com/cursor/plugins/commit/74dd2291e8e37b12fd6dc49b2acbd655c6bdaf12) (74dd229) by poteto
- [2026-06-07] [pstack: bump version to 0.9.0 (#125)](https://github.com/cursor/plugins/commit/a5cda8b561bb6536e880481734199a568cb647f4) (a5cda8b) by poteto
- [2026-06-06] [poteto-mode: shape refactoring commits before opening the PR (#124)](https://github.com/cursor/plugins/commit/91707573f17bde34e376f772ef4dd8f504747cb6) (9170757) by poteto
- [2026-06-06] [pstack: self-unblock empirical forks with a sketch instead of asking (#122)](https://github.com/cursor/plugins/commit/318e8f74ccc316b5f53e058de03fd1978ba5e041) (318e8f7) by poteto
- [2026-06-06] [pstack: add 'sequence work into verifiable units' principle (#123)](https://github.com/cursor/plugins/commit/27daaa309189aabce2dcaa2554cc940d65749a25) (27daaa3) by poteto
- [2026-06-06] [pstack: per-role model configuration via /setup-pstack (#121)](https://github.com/cursor/plugins/commit/6605d7adc3d4733b87273158c4cc49ae184409ab) (6605d7a) by poteto
- [2026-06-06] [pstack: bump version to 0.7.0 (#117)](https://github.com/cursor/plugins/commit/881e794248cd8d3855807abd7e48f2083809d175) (881e794) by poteto
- [2026-06-06] [pstack: add skeptical-reviewer trigger and arena routing for multi-shape work (#116)](https://github.com/cursor/plugins/commit/97d645a601330acf0257e51ce646aa497855c35f) (97d645a) by poteto
- [2026-06-06] [pstack: add pause-safely playbook (clean checkpoint for suspending work) (#115)](https://github.com/cursor/plugins/commit/2f3a47e6c404daa4bd24e8a0686751be39ed889b) (2f3a47e) by poteto
- [2026-06-05] [pstack: fold enforcement-strength rung into encode-lessons-in-structure (#114)](https://github.com/cursor/plugins/commit/64fe0147d32e0c05d2953501ddf9ff65ebcadc54) (64fe014) by poteto
- [2026-05-30] [pstack: concision pass on how, interrogate, architect, reflect (#106)](https://github.com/cursor/plugins/commit/c8402bc8e3673b973719fe3acc2c4837fef34f86) (c8402bc) by poteto
- [2026-05-30] [pstack: concision pass on why and poteto-mode (#105)](https://github.com/cursor/plugins/commit/f7e01457bba4499be1ce302484e4225f9a3c9eca) (f7e0145) by poteto
- [2026-05-29] [pstack: bump to 0.6.0 and refresh README (#104)](https://github.com/cursor/plugins/commit/683cdbda983ea8be4b766ac3fe94b7b88e7f75ad) (683cdbd) by poteto
- [2026-05-29] [pstack: frame reply impact for the consumer and the maintainer (#103)](https://github.com/cursor/plugins/commit/c532aa167cdbceb3440706ceacea2361e4d395df) (c532aa1) by poteto
- [2026-05-29] [pstack: build-the-lever defaults to building the tool for any non-trivial work (#102)](https://github.com/cursor/plugins/commit/ba7781cce69f65bf3edc0e789d28233d9e967f96) (ba7781c) by poteto
- [2026-05-29] [pstack: bump version to 0.5.0 (#101)](https://github.com/cursor/plugins/commit/bb3e1656658b12f0b1f2f1aa868449b678779487) (bb3e165) by poteto
- [2026-05-29] [pstack: interrogate gains a multi-model code-quality lens (#100)](https://github.com/cursor/plugins/commit/939812915e8a1c2359b0ea8d93fee7c29c41f60e) (9398129) by poteto
- [2026-05-29] [pstack: update Opus 4.7 references to 4.8 (#98)](https://github.com/cursor/plugins/commit/ec44aed93cda65227954d46c75be3a2f218144a3) (ec44aed) by poteto
- [2026-05-28] [pstack: architect usage-first design (caller's usage as the spec) (#99)](https://github.com/cursor/plugins/commit/0fe5b8a0952fd8888f9068f0693099ae74d25902) (0fe5b8a) by poteto
- [2026-05-28] [pstack: bump version to 0.4.0 (#93)](https://github.com/cursor/plugins/commit/9da4009e1278994a5623f23c262f8bde55830598) (9da4009) by poteto
- [2026-05-28] [pstack: build-the-lever can be a skill your subagents follow (#91)](https://github.com/cursor/plugins/commit/65f4dacee2ed677a295de8d295b889bbfe2ad27c) (65f4dac) by poteto
- [2026-05-27] [pstack: bump version to 0.3.0 (#90)](https://github.com/cursor/plugins/commit/6f2e0c63189ce3b661040153d82a32a2038560ba) (6f2e0c6) by poteto
- [2026-05-27] [show-me-your-work: add cross-model review of the trail (#89)](https://github.com/cursor/plugins/commit/47f3df82728f0df2233ed9d773ba0fba74cd79e3) (47f3df8) by poteto
- [2026-05-26] [pstack: bug-fix binary-search hypothesis loop, synthetic repro, /loop (#88)](https://github.com/cursor/plugins/commit/8d7ca2653dfe8632f02a33c426df28c064ca41be) (8d7ca26) by poteto
- [2026-05-26] [pstack: bump version to 0.2.0 (#86)](https://github.com/cursor/plugins/commit/21327bee99f30a73758c99f6c6459571bc9f6e98) (21327be) by poteto
- [2026-05-26] [pstack: refresh README playbooks (full list as a table) (#85)](https://github.com/cursor/plugins/commit/7dddd9bcfe5f53136ee4d9a8377da96a4860ef4a) (7dddd9b) by poteto
- [2026-05-26] [pstack: add build-the-lever principle (#84)](https://github.com/cursor/plugins/commit/7b1c32e4c3427c30ad2595630ed74815c52fe4e9) (7b1c32e) by poteto
- [2026-05-26] [pstack: add session-pickup and trace-forensics playbooks (#83)](https://github.com/cursor/plugins/commit/bbc0d75eb2f115124f6fbe9e5c8f27f579779345) (bbc0d75) by poteto
- [2026-05-26] [pstack: add refactoring playbook (#81)](https://github.com/cursor/plugins/commit/f18ffc1bd6b41a017ab97c53debcf140a8f754fd) (f18ffc1) by poteto
- [2026-05-25] [pstack: add figure-it-out and show-me-your-work to README examples (#80)](https://github.com/cursor/plugins/commit/a9e675642ea4297553a4d8c23f5d8a5b004f6626) (a9e6756) by poteto
- [2026-05-25] [pstack: harden show-me-your-work log.sh (formula-injection + mkdir -p) and shorten skill descriptions (#79)](https://github.com/cursor/plugins/commit/11ecc12a3ffc037b4ef3b64de2be449668e8afc7) (11ecc12) by poteto
- [2026-05-24] [pstack: add figure-it-out and show-me-your-work skills (#78)](https://github.com/cursor/plugins/commit/35f33923cde39e9c27d68d95517e4e4e83719c7c) (35f3392) by poteto
- [2026-05-24] [pstack: simplify the feature README example (#77)](https://github.com/cursor/plugins/commit/b8f2564c2e8da66b331c1dd63c2a2925d6739961) (b8f2564) by poteto
- [2026-05-23] [pstack: add usage examples to README (#76)](https://github.com/cursor/plugins/commit/3dd382f4dbf3753ea5c5fac0935bb5a8a0789021) (3dd382f) by poteto
- [2026-05-23] [pstack: add typescript-best-practices to README skills table](https://github.com/cursor/plugins/commit/6754d3c09e5ea95de453ac1330f8648a82bbe00a) (6754d3c) by poteto
- [2026-05-23] [Add pstack plugin](https://github.com/cursor/plugins/commit/24bd6eb895d63a6e76fabfea2cb344384d177d79) (24bd6eb) by poteto
1 change: 1 addition & 0 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:image" content="https://hustlecoding.github.io/pstack-explained/og.png">
<link rel="canonical" href="https://hustlecoding.github.io/pstack-explained/">
<link rel="alternate" type="text/plain" href="llms.txt" title="LLM context for this site">
<link rel="icon" type="image/svg+xml" href="favicon.svg">
<link rel="icon" type="image/png" sizes="32x32" href="favicon-32x32.png">
<link rel="apple-touch-icon" sizes="180x180" href="apple-touch-icon.png">
Expand Down
Loading