Use YYLO wiki Records

Trate o Ledger como a fonte da verdade. Use yy ledger em um controlador YYLO e yylo-ledger em um projeto Ledger independente. Inspecione COMMAND wiki --help antes de agir; se wiki estiver ausente, a versão instalada do Ledger não expõe comandos nativos de Record e não deve ser contornada com edições diretas de arquivo.

Escolha o record certo

Antes de escrever, decida onde a informação pertence:

• Wiki: conhecimento explicativo durável do projeto ou domínio que trabalhos futuros devem descobrir.
• Tarefa: trabalho solicitado com escopo, status, dependências, critérios de aceitação e evidências de conclusão.
• Fluxo de trabalho: passos estruturados validados, não orientação em prosa.
• Artefato: evidências geradas, relatórios, recibos, logs, saída de modelo ou cargas úteis binárias.
• Documentação de origem: documentação lançada e versionada com o código do produto.

Não coloque segredos, caches, transcrições de sessão, status temporário, evidências geradas volumosas ou recibos operacionais apenas para o proprietário em uma wiki.

Descubra antes de criar

Use primeiro buscas resumidas delimitadas. Resolva records por ID imutável sempre que um for conhecido; slugs e aliases são conveniências de descoberta, não identidade de substituição.

yy ledger wiki search --text "deployment policy" --projection summary --limit 20 -f json
yy ledger wiki get RECORD_ID -f json
yy ledger wiki get RECORD_ID --raw

Use --scope archive|all apenas quando a solicitação exigir records frios. Solicite projeção full apenas quando os bytes da carga útil forem necessários.

Crie Markdown durável

Use um arquivo ou stdin para conteúdo substancial ou sensível ao shell:

yy ledger wiki create --title "Service ownership" --file ownership.md
yy ledger wiki create --title "Incident notes" --file - < incident-notes.md

Escolha um título, namespace, slug, aliases e relações estáveis deliberadamente. Mantenha um tópico por Record e vincule IDs de Record imutáveis relacionados em vez de duplicar a verdade.

Atualize com segurança

1. Leia o Record e a revisão atuais.
2. Preserve seu ID imutável e inspecione o histórico quando a intenção não for clara.
3. Siga wiki update --help para os controles de comparação e substituição instalados.
4. Forneça a revisão esperada e as evidências de preimage/digest necessárias.
5. Use transporte de arquivo; não reescreva os arquivos do Ledger você mesmo.
6. Leia a revisão e o recibo resultantes.

Uma incompatibilidade de revisão ou preimage significa que a origem mudou: releia e reconcilie. Nunca force edições concorrentes passadas. Arquivar é uma transição de ciclo de vida, não exclusão.

Use --front-matter apenas para intercâmbio canônico de front-matter e --rendered para renderização inerte e com escape HTML. Use history RECORD_ID para entender as revisões; não infira o histórico apenas do payload mais recente.

Limite da wiki do projeto

A orientação portátil do controlador pode residir sob a wiki do controlador, enquanto as páginas do projeto e de domínio mantêm caminhos de propriedade do projeto. Páginas gerenciadas por pacote e de propriedade do projeto podem coexistir. Migração, substituição em tempo de execução, recuperação de merge excepcional, lançamento, implantação e manutenção de arquivo frio permanecem runbooks autoritativos, não conteúdo para resumir em uma habilidade global do dia a dia.

Solicitação completa

$ARGUMENTS

Quando Usar

• Você precisa de conhecimento durável do projeto ou domínio como YYLO Ledger wiki Records (pesquisar, criar, atualizar com segurança de revisão).
• Você deve primeiro decidir se o record pertence à wiki em vez de uma tarefa, fluxo de trabalho, artefato ou documentação do produto.

Limitações

• Pesquise antes de criar; um tópico por Record, vinculado por IDs de Record imutáveis.
• Nunca armazene segredos, caches, transcrições de sessão, status temporário, evidências geradas volumosas ou recibos apenas para o proprietário em uma wiki.
• As atualizações se vinculam à revisão/preimage esperada; em caso de incompatibilidade, releia e reconcilie - nunca force edições concorrentes passadas. Arquivar é uma transição de ciclo de vida, não exclusão.
• Se o grupo wiki estiver ausente, falhe fechado e solicite uma atualização do Ledger.

Exemplo

yy ledger wiki search --text "deployment policy" --projection summary --limit 20 -f json
yy ledger wiki get RECORD_ID -f json

Adaptado de yylo-dev/yylo-skills (MIT) - v2.0.1; frontmatter, When to Use/Limitations, e limites de segurança adicionados para conformidade upstream.