Repository navigation
feat(pstack): refresh workflows and guide without model changes - #27
Conversation
There was a problem hiding this comment.
🔵 Needs a closer look
It is a large, high-volume upstream port touching many skill files and a new guide whose prose fidelity to the pinned PStack 0.15.17 snapshot cannot be fully verified automatically, warranting human review.
0 open findings
What changed in this PR
This PR ports PStack 0.15.17 into the Codex skill set while deliberately preserving the repository's existing model policy (slugs, efforts, panel sizes, three-runner Architect, local deslop routing). It adds two explicit-invocation skills (poteto-help, ketchup), a new ten-page docs/pstack guide with six upstream images, and applies upstream prose distillation across many skill files, removing the PStack-derived per-skill LICENSE copies and _Source: banners.
Changes:
- Add
poteto-helpandketchupskills (bothallow_implicit_invocation: false) plus a newdocs/pstackguide (README + 01–10) with six images. - Distill skill prose (why, how, interrogate, arena, architect, reflect, setup-pstack, principle-*, etc.) and adapt invocation/agent/transcript wording for Codex, without changing model names or efforts.
- Remove PStack-derived per-skill LICENSE files and source banners; update
CHANGELOG.mdanddocs/upstream-mined.md.
| File | Description |
|---|---|
| skills/why/SKILL.md | Condensed step prose; preserved why investigators low / why synthesizer high defaults and no-write posture. |
| skills/why/references/synthesizer-prompt.md | Tightened synthesizer template; epistemics/tiers and output structure unchanged. |
| skills/how/*, skills/interrogate/*, skills/arena/*, skills/architect/*, skills/reflect/* | Prose distillation; model/effort defaults and runner counts preserved. |
| skills/poteto-help/** (new) | Explicit-invocation routing skill with verified skill/guide cross-links and references. |
| skills/ketchup/** (new) | Explicit-invocation catch-up skill; valid frontmatter. |
| skills/principle-*/SKILL.md | Wording refresh; 24 principles consistent with the guide. |
| docs/pstack/** (new) | Ten-page guide + 6 images; internal links, anchors, and counts (23 playbooks, 24 principles) verified. |
| skills/**/LICENSE (deleted) | Removed PStack (Lauren Tan) per-skill license copies; root license retained. |
| CHANGELOG.md, docs/upstream-mined.md | Record the 0.15.17 port at pinned upstream SHA. |
🧠 Review effort: Balanced
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Why
PStack 0.15.17 adds help and catch-up skills and refreshes its workflows. This ports those updates to Codex while preserving the existing model policy and three Architect runners.
What changed
Scope
Blast Radius
The changes affect PStack instruction loading, task routing, and its documentation. The poteto-mode slug matches Codex's literal invocation rules, and the new help/catch-up skills require explicit invocation.
Verification