Entenda o projeto

1. Leia AGENTS.md/CLAUDE.md, o status do repositório, o código-fonte relevante, os testes e a documentação existente do produto na integração ou na árvore de trabalho da funcionalidade atribuída.
2. Leia as tarefas relacionadas do Kanban e as especificações duráveis através do controlador de metadados canônico. Não presuma que .juno_task/plan.md existe e não materialize metadados privados do controlador em uma árvore de trabalho do produto.
3. Rastreie apenas as dependências e os caminhos de tempo de execução necessários para o objetivo solicitado. Use investigação paralela limitada quando questões independentes justificarem.
4. Relate o comportamento atual, as fontes da verdade, os componentes afetados, os riscos, os desconhecidos e o menor loop de validação útil.
5. Se o usuário solicitou planejamento, entregue as descobertas para plan-ledger-tasks-yylo. Se a implementação foi solicitada, trabalhe apenas na árvore de trabalho da tarefa retornada por yy task start TASK_ID.
6. Escreva uma especificação operacional durável apenas quando solicitado ou materialmente útil. Elabore-a externamente, pré-valide a API yy ledger artifact instalada, capture-a como um Registro de Artefato report imutável com proveniência/retenção e verifique a recuperação, o resumo e o histórico. Se essa API não estiver disponível, pare com o rascunho externo intacto; nunca recorra a docs/ do produto, corpos/respostas de tarefas, novos .juno_task/specs ou edições diretas do controlador-armazenamento. docs/ do produto permanece reservado para a documentação enviada com o produto. Não atualize as instruções raiz com status transitório.

Contrato de Invocação

As visualizações estruturadas abaixo apelidam intencionalmente partes da solicitação completa; elas não são argumentos adicionais do usuário.

Tarefa principal

$1

Restrições e contexto

$2

Solicitação bruta completa

$ARGUMENTS

Quando Usar

• Antes de planejar ou implementar uma alteração solicitada, quando você precisar da arquitetura atual, dependências e loops de validação.
• Para entregar descobertas fundamentadas para plan-ledger-tasks-yylo (planejamento) ou uma árvore de trabalho de tarefa (implementação).

Limitações

• Somente leitura: relata o comportamento atual, as fontes da verdade, os componentes afetados, os riscos, os desconhecidos e o menor loop de validação - não implementa.
• Investigação limitada apenas; não materialize metadados privados do controlador em uma árvore de trabalho do produto.
• Especificações duráveis são capturadas como Registros de Artefato imutáveis apenas quando a API yy ledger artifact instalada suporta isso; caso contrário, pare com o rascunho externo intacto.

Exemplo

yy ledger search --status todo --limit 5
yy ledger get TASK_ID

Adaptado de yylo-dev/yylo-skills (MIT) - v2.0.1; frontmatter, Quando Usar/Limitações e limites de segurança adicionados para conformidade upstream.