Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

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

Aberta Para iniciantes
  • Algo errado?
#726 1 comentário 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
65/100
Tipo de issue
Bug
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
typescript
Domínio
developer-experience

Direção de pesquisa

Comece pelas instruções de poteto-mode SKILL.md descritas na issue, especialmente as seções Non-negotiables e Principles, e compare-as com a redação proposta. Atualize as instruções para exigir explicitamente a leitura do adaptador e do leaf skill relevante antes da primeira resposta. Confira se a leitura do adaptador continua restrita ao Claude Code e se a leitura do leaf skill se aplica ao Cursor; o trabalho estará concluído quando as instruções exigirem essas etapas e preservarem a regra de citação.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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/.
Linguagem predominante
TypeScript
Estrelas
12.5k
Forks
1.2k
Merge médio
10h 48min
PRs com merge (30d)
128

Preparar o ambiente

Este projeto não oferece contêiner de desenvolvimento, Dockerfile nem guia de contribuição, então a configuração fica por sua conta: comece pelo README e veja nosso guia da primeira contribuição para os passos gerais.

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de cursor/plugins

Todas as issues de cursor/plugins

Issues semelhantes

Mais issues de TypeScript

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.