Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

pstack: in Claude Code, poteto-mode cites principles without reading their SKILL.md files

Aperta Adatta ai principianti
  • Qualcosa non va?
#726 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
65/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
typescript
Ambito
developer-experience

Direzione di ricerca

Inizia dalle istruzioni di poteto-mode SKILL.md descritte nell’issue, in particolare dalle sezioni Non-negotiables e Principles, e confrontale con la formulazione proposta. Aggiorna le istruzioni affinché richiedano esplicitamente la lettura dell’adattatore e del leaf skill pertinente prima della prima risposta. Verifica che la lettura dell’adattatore resti limitata a Claude Code e che la lettura del leaf skill si applichi in Cursor; il lavoro è completato quando le istruzioni impongono questi passaggi preservando la regola di citazione.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Problem

In Claude Code, /pstack:poteto-mode runs almost never read the files that the skill tells the agent to read. SKILL.md line 11 says to read docs/harness/claude-code.md once per session. Line 17 says to cite only principles whose leaf SKILL.md the agent read this session. The agent skips both reads. It then does one of two things:

  • It names principles from the inline index without reading them. That breaks the "cite only what you read" rule.
  • It names no principles at all, so the Principles section has no visible effect.

From the user's side, poteto-mode follows its principles on some days and ignores them on others.

Evidence

I audited 18 poteto-mode runs across 4 Claude Code sessions (pstack 0.15.25 and 0.15.27, Claude Code 2.1.304, Opus 5.5):

  • Every run injected the full skill body, so the skill loaded correctly.
  • The agent read docs/harness/claude-code.md in 1 run.
  • The agent read a principle-*/SKILL.md file in 0 runs and a playbook file in 0 runs.
  • One session named principles in its replies anyway. The other three named none.
  • One run spawned general-purpose where the adapter maps delegates to pstack:poteto-agent.

poteto-mode, poteto-agent, and the principle-* skills are identical in 0.15.25 and 0.15.27, so the version change did not cause this.

All 24 principle-* skills set disable-model-invocation: true, so the Skill tool refuses them. The only way to load a principle file is to Read it by path. The current wording states the citation rule but never makes the read a step, so the agent treats the inline index as enough.

Proposed fix

Make the reads an explicit first step in the Non-negotiables:

-The Principles section below grounds every trigger. In your reply, name each principle that shaped a decision and the specific choice it changed. Cite only principles whose leaf SKILL.md you read this session.
+The Principles section below grounds every trigger. Before your first reply in a run, `Read` the adapter above if you have not this session, then `Read` `../principle-<name>/SKILL.md` for each principle you expect to shape a decision. The index below is a pointer, not a substitute. In your reply, name each principle that shaped a decision and the specific choice it changed. Cite only principles whose leaf SKILL.md you read this session.

The adapter clause applies only in Claude Code, because line 11 scopes the adapter to Claude Code. In Cursor the change adds only the leaf read, which line 17 already requires.

Test

I applied the patch locally to 0.15.27 and ran:

claude -p "/pstack:poteto-mode avg() in stats.py crashes on an empty list. Propose a fix, don't edit files."

The agent read docs/harness/claude-code.md, then principle-fix-root-causes/SKILL.md and principle-boundary-discipline/SKILL.md. Its reply named both principles and said what each one changed. That is one run, not a benchmark.

Related

  • #629 adds Claude Code support but does not change line 17.
  • I haven't tested whether poteto-agent delegates have the same gap. Their fallback search for SKILL.md looks only in ~/.cursor/plugins/.
Lingua principale
TypeScript
Stelle
12.5k
Fork
1.2k
Merge medio
10h 48m
PR unite (30g)
128

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di cursor/plugins

Tutte le issue di cursor/plugins

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.