# 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. - Skill: `felipelobomotta-blip/manuscript-manager` (Agent Skill) - Install (CLI): `npx skillmds@latest add felipelobomotta-blip/manuscript-manager` - Raw SKILL.md: https://api.skillmd.com/api/skills/felipelobomotta-blip/manuscript-manager/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: DevOps & Infra - Author: felipelobomotta-blip (https://skillmd.com/u/felipelobomotta-blip) - Updated: 2026-09-22 - Page: https://skillmd.com/skills/felipelobomotta-blip/manuscript-manager --- # 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: ```yaml # 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: 1. **Ler** `PROJECT_STATE.yaml` 2. **Reportar ao usuário:** - Fase atual - Último trabalho feito (sessão anterior) - Handoffs pendentes - Próximo passo planejado - Genesis Score atual (se existir) 3. **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? 4. **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: 1. **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) 2. **Listar para o usuário:** - O que foi feito nesta sessão - O que ficou pendente - Qual seria o próximo passo lógico 3. **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: ```yaml - 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: ```yaml 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): 1. Ler `PROJECT_STATE.yaml` — contém todo o estado 2. Ler as últimas 3 entradas de `sessoes` — contexto recente 3. Verificar `handoffs_pendentes` — o que estava em andamento 4. Verificar `decisoes` recentes — o que foi decidido 5. 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 # Vocabulário, ritmo, tiques, referências │ └── outline.md # Outline capítulo a capítulo ├── capitulos/ │ ├── cap-01.md │ ├── cap-02.md │ └── ... ├── pesquisa/ │ ├── comp-titles.md # Livros comparáveis + análise │ ├── dados-por-capitulo.md # Fontes, dados, estatísticas organizados │ └── mercado.md # Análise de nicho, espaço vazio ├── avaliacoes/ │ ├── genesis-score-v1.md # Primeira avaliação completa │ ├── genesis-score-v2.md # Re-avaliação após revisão │ ├── beta-reader-v1.md # Primeira leitura beta │ └── ... ├── editorial/ │ ├── logline.md │ ├── sinopse-capa.md │ ├── sinopse-editorial.md │ ├── query-letter.md │ └── cover-brief.md └── export/ ├── manuscrito-final.md # Texto completo em ordem └── ... ``` **Regras:** - Nomes de arquivo: kebab-case, sem acentos, sem espaços - Capítulos: sempre `cap-XX.md` (com zero à esquerda) - Avaliações: sempre versionadas (`-v1`, `-v2`) - O `PROJECT_STATE.yaml` referencia caminhos relativos a esta estrutura - Se o projeto não segue esta estrutura, o CHECK-IN cria as pastas faltantes --- ## COMANDOS - `/estado` — Mostra estado atual do projeto (fase, scores, pendências) - `/checkin` — Executa protocolo de CHECK-IN - `/checkout` — Executa protocolo de CHECK-OUT - `/decisoes` — Lista todas as decisões registradas - `/handoffs` — Lista handoffs pendentes - `/historico [cap X]` — Mostra histórico de alterações de um capítulo