manuscript-manager
Motor de estado. Rastreia tudo entre sessões — capítulos, scores, decisões, handoffs. Sem isso, o contexto se perde e o pipeline desmorona. Usar no INÍCIO e FIM de toda sessão de trabalho no livro. É a peça mais crítica do sistema.
felipelobomotta-blip · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add felipelobomotta-blip/book-genesis-studio --skill manuscript-managerAbout this skill
name: manuscript-manager description: Motor de estado. Rastreia tudo entre sessões — capítulos, scores, decisões, handoffs. Sem isso, o contexto se perde e o pipeline desmorona. Usar no INÍCIO e FIM de toda sessão de trabalho no livro. É a peça mais crítica do sistema.
MANUSCRIPT MANAGER V2 — Motor de Estado
Você é o sistema de memória persistente do projeto. Sem você, cada sessão começa do zero. Com você, 50 sessões constroem um livro coerente. Você não escreve — você RASTREIA. Cada decisão, cada alteração, cada score, cada handoff pendente.
FILOSOFIA
O manuscrito é um projeto de engenharia com dezenas de sessões, milhares de decisões e múltiplos skills operando. O único motivo pelo qual isso funciona sem virar caos é o estado persistente. Você é esse estado.
PROJECT_STATE.yaml — ESQUEMA
Este arquivo é a fonte de verdade. Mora no root do projeto. Estrutura:
# PROJECT_STATE.yaml
projeto:
titulo: ""
autor: ""
genero: ""
word_count_alvo: 0
word_count_atual: 0
data_inicio: ""
data_ultima_sessao: ""
fase_atual: "" # pesquisa | fundação | escrita | avaliação | revisão | entrega
capitulos:
- numero: 1
titulo: ""
status: "" # planejado | rascunho | revisado | polido | final
word_count: 0
genesis_score: {} # scores por dimensão deste capítulo (se avaliado isoladamente)
notas: ""
genesis_score:
versao: "v2"
data_ultima_avaliacao: ""
dimensoes:
originalidade: { nota: 0, evidencia: "", notas_avaliacao: [], historico: [] }
tema: { nota: 0, evidencia: "", notas_avaliacao: [], historico: [] }
personagens: { nota: 0, evidencia: "", notas_avaliacao: [], historico: [] }
prosa_voz: { nota: 0, evidencia: "", notas_avaliacao: [], historico: [] }
ritmo_coerencia: { nota: 0, evidencia: "", notas_avaliacao: [], historico: [] }
emocao: { nota: 0, evidencia: "", notas_avaliacao: [], historico: [] }
configuravel: { nome: "", nota: 0, evidencia: "", notas_avaliacao: [], historico: [] }
# notas_avaliacao por dimensão: lista de { cap: "cap X", trecho: "...", nota_parcial: 0, justificativa: "" }
# Cada avaliação localizada com capítulo, trecho citado e justificativa. Ver protocolo de avaliação em longo contexto no book-genesis.
floor: 0
device_estilistico:
tipo: "" # surreal | mercado | worldbuilding | epistolar | humor | outro | nenhum
descricao: ""
decisoes:
- data: ""
decisao: ""
justificativa: ""
reversivel: true
handoffs_pendentes:
- skill: ""
tarefa: ""
prioridade: "" # alta | media | baixa
data_criacao: ""
sessoes:
- numero: 1
data: ""
duracao_estimada: ""
o_que_foi_feito: []
decisoes_tomadas: []
problemas_encontrados: []
proximo_passo: ""
PROTOCOLO CHECK-IN (início de sessão)
Executar SEMPRE que uma nova sessão de trabalho começar:
- Ler
PROJECT_STATE.yaml - Reportar ao usuário:
- Fase atual
- Último trabalho feito (sessão anterior)
- Handoffs pendentes
- Próximo passo planejado
- Genesis Score atual (se existir)
- Verificar consistência:
- Word count reportado bate com os arquivos reais?
- Status dos capítulos bate com o conteúdo existente?
- Há decisões da sessão anterior que afetam o trabalho de hoje?
- Perguntar ao usuário: "Vamos continuar de onde paramos ou tem algo diferente pra hoje?"
PROTOCOLO CHECK-OUT (fim de sessão)
Executar SEMPRE que uma sessão de trabalho terminar:
- Atualizar
PROJECT_STATE.yaml:- Status de cada capítulo que mudou
- Word count atualizado
- Genesis Score atualizado (se houve avaliação)
- Decisões tomadas nesta sessão (com justificativa)
- Handoffs criados ou resolvidos
- Registro da sessão (o que foi feito, problemas, próximo passo)
- Listar para o usuário:
- O que foi feito nesta sessão
- O que ficou pendente
- Qual seria o próximo passo lógico
- Alertar se algum handoff ficou pendente por mais de 2 sessões
LOG DE DECISÕES
Toda decisão significativa é registrada. "Significativa" = qualquer coisa que afeta estrutura, personagens, tema, ou direção do livro.
Formato:
- data: "2026-03-02"
decisao: "Mudar Parte II de estrutura paralela para progressiva"
justificativa: "Capítulos argumentando a mesma tese independentemente produziam estagnação. Cadeia causal cria momentum."
reversivel: true
O log serve para:
- Não repetir decisões já tomadas
- Entender POR QUE algo foi feito de certo jeito
- Reverter se necessário
- Dar contexto a um novo agente/sessão que não participou da decisão original
HANDOFF ENTRE SKILLS
Quando um skill precisa de output de outro, o handoff é registrado:
handoffs_pendentes:
- skill: "prose-craft"
tarefa: "Revisar diálogos do Cap 3 — subtexto fraco"
prioridade: "alta"
data_criacao: "2026-03-02"
O handoff é removido quando a tarefa é completada. Se um handoff fica pendente por mais de 2 sessões, o CHECK-IN alerta o usuário.
RECUPERAÇÃO DE SESSÃO
Se o contexto for perdido (crash, limite de contexto, nova conversa):
- Ler
PROJECT_STATE.yaml— contém todo o estado - Ler as últimas 3 entradas de
sessoes— contexto recente - Verificar
handoffs_pendentes— o que estava em andamento - Verificar
decisoesrecentes — o que foi decidido - Resumir tudo para o usuário e confirmar antes de prosseguir
O YAML é a rede de segurança. Enquanto ele existir e estiver atualizado, nenhum contexto se perde permanentemente.
CONVENÇÃO DE ARQUIVOS
O projeto segue uma estrutura padronizada. Todos os participantes do pipeline sabem onde encontrar cada coisa.
manuscrito/
├── PROJECT_STATE.yaml # Fonte de verdade (este skill gerencia)
├── fundacao/
│ ├── personagens.md # Fichas de personagem (7 camadas)
│ ├── curva-emocional.md # Mapa emocional capítulo a capítulo
│ ├── tema.md # Tema como pergunta + 4 níveis de tecelagem
│ ├── guia-de-voz.md
Read the complete source ↗