SuperAPI AI Directory

teo-livro

Writing & research

View repository

Updated 10-15 21:10

About this skill

Book

Write a book. Not a report, not a condensed summary, not the minutes of a debate.

The debate, if there is one, is optional input. This skill does not replace it and does not reopen it. If the user does not yet have a dispute between schools and wants one, stop and point to teo-debate. Then, if you want the volume, come back here.

Do not be lazy with the input. Without a full reading of the named sources, there is no chapter plan.

When to use

  • Request for a book, digital book, volume, "write a book about"
  • Extract a book from an already closed debate (Debate - …/)
  • Extract a book from notes, article (teo-transcricao), thesis, or question
  • Four views in literary format (one reading, then whoever responds to that reading)

When NOT to use

  • Mediate three schools (teo-debate) — here debaters are not introduced
  • Preachable sermon (teo-sermao)
  • Transcribe video (teo-transcricao)
  • Condensed summary, summary, or "single chapter that covers everything"

Principles

  1. Throughline before prose. Without a throughline of ≤20 words and without a destination for the volume, no chapter is written.
  2. Read the input for real. Debate: protocol, synthesis, verdict and all turns. Notes: every named file. Bare topic: research recorded in raw/pesquisa.md. Do not make the chapter plan from memory or from the map alone.
  3. Each unit has a job. Chapter: begins, moves, settles. Paragraph: a local thesis, evidence, a close that prepares the next one. Between units: therefore or but, never and then.
  4. The one who wrote it is not the only eye. Developmental editor and source checker are isolated subagents (or, at minimum, one pass after the draft, against the text, not against the intention).
  5. Do not invent. If the input is a debate, do not add a thesis that the turn did not support. If the input is something else, do not invent a quotation, datum, or doctrine.
  6. Destination ≠ school winner. A book of views settles on the questions that carry the rest and on what that does in the church, unless the user asks for doctrinal judgment.

Prose detail: references/prosa.md. Structures: references/estruturas.md. Workbench: references/bancada.md.

Initial interview (before creating a folder or drafting)

Run references/intake.md with a structured question. Without the answers, stop.

Field Required? Default
Topic (one sentence) yes —
Input yes bare topic (then research is the first job)
Reader yes intelligent believer, without a diploma
Thread (≤20 words) + volume destination yes —
Structure yes (confirm) quatro-pontos if the input is a debate; otherwise propose
Language yes Brazilian Portuguese
Destination folder yes Livro - <tema>/ in the cwd
Authorization to write yes —

Do not mix the debate folder with the book folder. The debate stays where it is. The volume is another folder.

Artifacts

<destino>/
├── indice.md              # porta: pergunta, fio, leitor; aponta livro/_index.adoc
├── livro/                 # AsciiDoc: _index.adoc + um .adoc por capítulo
└── raw/
    ├── 00-brief.md        # fio, leitor, destino, insumo, estrutura
    ├── pesquisa.md        # o que foi lido, o que falta, fontes
    ├── outline.md         # emprego e destino de cada capítulo
    ├── reverse-outline.md
    ├── edicao.md          # desenvolvimento + linha
    └── curadoria.md

Copy the skeleton from templates/. Fill it in; do not leave a placeholder. Destination = what the user asked for, otherwise cwd. No absolute machine paths.

Included chapters start at ==. Subsections at === (do not skip a level). [[id]] unique, starting with a letter. Glossary at the end, before the index. Title = Tema: subtítulo (the second line of the header becomes author — do not use it). Title page: the question and, if it fits, voices, in a [abstract]. No [dedication], no author page, no «how to read this file».

Cycle

entrevista inicial → pesquisa (ler o insumo) → orientação + plano de capítulos
  → rascunho (um capítulo-piloto, depois o resto)
  → editor de desenvolvimento (esboço reverso)
  → revisor de linha
  → checagem de fontes
  → copidesque (idioma, glossário, notas)
  → compilação + curadoria

Do not skip research. Do not skip the reverse outline. Do not declare the volume ready just because AsciiDoc compiles.

1. Research

Record raw/pesquisa.md (templates/pesquisa.md).

  • Debate: read 00-protocolo.md, sintese.md, veredito.md and each turnos/*.md. Note theses, concessions, dangers, load-bearing texts. The synthesis does not replace the turns.
  • Notes / articles: read each file that the initial interview named, in full.
  • Bare topic: research (Scripture on the thread; secondary sources with references). Record what was opened. A gap becomes a question, not a guess.

Without this record, the chapter plan is a shot in the dark.

2. Orientation and chapter plan

raw/00-brief.md: thread, reader, destination («after these pages the reader can…»), structure, what the volume is not .

raw/outline.md: for each chapter, job (what it exists to do) and destination (what the reader should be able to say at the end). The sequence of chapters must be therefore / but. A chapter that merely «also deals with» is cut or changes job.

If the chapter plan does not sit on the thread, redo the plan. Do not write on top of a crooked map.

3. Draft

Start with a pilot chapter (not the preface: a middle chapter). Do the reverse outline of that pilot (references/prosa.md). Only then write the rest.

One .adoc per chapter, long enough to sit and read. Language of the orientation (default pt-BR). Inevitable technical term: note at the first occurrence and glossary entry.

Paragraph and chapter contract: references/prosa.md. Do not stack theses. Do not circle.

4. Bench (mandatory)

Follow references/bancada.md. At minimum:

  1. Developmental editor — subagent who did not draft the chapter. Reverse outline of the volume. RETRY if the chapter does not sit, if the sequence is and then, if the thread disappears.
  2. Source checker — every loaded biblical statement: does the text say what the sentence claims? não → RETRY of the chapter. Allusion without book-chapter-verse → complete.
  3. Line editor — old→new, one thesis per paragraph, real connective (not just «in addition»).

Record the editing stage in raw/edicao.md and raw/reverse-outline.md.

5. Copyediting and production

  • Use Brazilian Portuguese when pt-BR is requested (avoid European Portuguese vocabulary such as “ficheiro”, “ecrã” and “de facto”).
  • Glossary + first-occurrence notes
  • asciidoctor livro/_index.adoc
  • [[id]] unique; cross-references resolve

6. Curation

raw/curadoria.md (templates/curadoria.md). Without that the volume did not close. PASS / PASS with WARN / RETRY. Whoever drafted is not the only eye.

Writing

Every biblical statement cites the source in the thread (Jo 12.31; Jz 11.12). Naming the book or the episode is not enough. Do not invent a reference.

What does not go into the volume

Guidance, research, chapter plan, reverse outline, editing, curation, panel names, Herdr, T01, presentation of the strongest version of the argument. That stays in raw/. The book's reader does not watch the process.

If the input is a debate: no «at this table», «the essay just read», «we were hearing him», courtroom jargon. The order of the four viewpoints is pedagogy, not binding.

Anti-patterns

  • Compiling the book inside teo-debate
  • Chapter plan without having read the turns / notes
  • Chapter that lists topics instead of going up a step
  • Paragraph without a local thesis (block of loose sentences)
  • Sequence and then between sections
  • The same agent as sole editor of its own draft
  • Inventing a thesis, quotation, or data point
  • Condensed summary, single markdown, or chapters too short to sit and read
  • Assembly instruction in the volume
  • [dedication] or author page in generated volume
  • Choosing a school's winner in a book of views without the user having asked
  • Delivering without raw/curadoria.md and without compilation

Checklist

  • Initial interview (theme, input, reader, thread, destination, structure, language, destination, authorization)
  • raw/pesquisa.md with sources read, not listed from memory
  • Guidance + chapter plan: job and destination per chapter
  • Pilot chapter with reverse outline before the rest
  • Developmental editor isolated; reverse outline of the volume
  • Load-bearing sources checked
  • Glossary + first-occurrence notes
  • asciidoctor compiles; cross-references resolve
  • raw/curadoria.md PASS or PASS with WARN