user-thoughts.SKILL

Visão Geral

Ao longo de sessões e entre agentes, decisões de projeto e restrições do usuário podem ser facilmente perdidas. user-thoughts persiste essas decisões em um mdbase local do projeto, para que qualquer agente futuro possa recuperar a intenção do usuário sem ter que derivá-la do zero.

A skill registra a intenção do usuário. Ela não substitui a execução normal de tarefas. Se o usuário disser "faça o botão vermelho", o agente deve fazer a alteração e registrar a preferência quando a memória persistente do projeto for útil.

Quando Usar

Use esta skill quando o usuário declarar ou revisar:

• Regras, restrições, preferências ou requisitos do projeto.
• Decisões de arquitetura, stack de tecnologia, modelo de dados, implantação ou fluxo de trabalho.
• Direção de UI/UX, padrões de cópia, preferências visuais ou justificativa de design.
• Itens de backlog, trabalho planejado, opções rejeitadas ou decisões que agentes futuros devem herdar.
• Um comando direto começando com /user-thoughts ou /ustht.

Não a use para bate-papos aleatórios não relacionados, conversas transitórias ou conteúdo que o usuário explicitamente pede para ignorar.

Política de Idioma

• Todos os arquivos de skill, scripts, templates e documentos de referência empacotados são escritos em inglês.
• A saída de comando voltada para o agente deve seguir o idioma da conversa atual do usuário quando o agente puder fazer isso razoavelmente.
• Pensamentos brutos do usuário devem preservar a redação original do usuário. Não traduza, resuma ou limpe a intenção do usuário, a menos que o usuário peça isso.

Fluxo de Trabalho Principal

User message -> Agent identifies persistent project intent -> write to #raw/
             -> /ustht sortin groups raw entries into #mdbase/
             -> /ustht mdbase show exposes the organized memory base

Modos de Execução

• Modo passivo: INSTANT_STATUS=off; apenas comandos explícitos da skill são executados.
• Modo instantâneo: INSTANT_STATUS=on e SKILL_STATUS=on; pensamentos do usuário relevantes para o projeto são escritos em #raw/ conforme aparecem.
• Modo de ignorar: ignore start e ignore end marcam um intervalo temporário que não deve ser gravado.
• Modo somente leitura: se as ferramentas necessárias de leitura/escrita/bash estiverem indisponíveis, os comandos show ainda podem funcionar, mas os comandos de escrita devem explicar que o ambiente não pode persistir dados.

SKILL_STATUS=off pausa a captura instantânea mesmo quando INSTANT_STATUS=on. Intervalos de ignorar são locais ao contexto e não persistem entre sessões.

Definições de Caminho

• @/: o diretório da skill user-thoughts/ instalada.
• ~/: o diretório de trabalho do projeto atual.
• #ustht/: ~/.ustht/.
• #mdbase/: ~/.ustht/mdbase/.
• #ignored/: ~/.ustht/ignored/.
• #raw/: ~/.ustht/raw/.
• #export/: ~/.ustht/export/.

Layout do Diretório de Execução

.ustht/
├── define.ini
├── README.ai.md
├── raw/
│   └── yyyy-mm-dd.md
├── ignored/
│   └── yyyy-mm-dd.md
├── mdbase/
│   ├── backlog.md
│   ├── README.ai.md
│   └── details/
│       ├── rules.md
│       ├── plans.md
│       ├── ui/
│       │   ├── outline.md
│       │   └── details.md
│       ├── dev-stack.md
│       └── general.md
└── export/

Ferramentas e Ambiente

Ferramentas necessárias:

• read/write: ler e atualizar arquivos sob #ustht/.
• bash: criar diretórios e executar scripts empacotados.

Ferramenta opcional:

• SubAgent: quando disponível, use-o para manutenção semântica de sortin ou resort que abrange muitos arquivos. Use o agente principal diretamente apenas quando subagentes não estiverem disponíveis.

Scripts Empacotados

O diretório scripts/ fornece pequenos utilitários Python para operações mecânicas:

resort não tem um script autônomo porque requer revisão semântica, desduplicação e reestruturação por um agente.

define.ini

define.ini armazena estado de execução simples de chave/valor: