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
- Throughline before prose. Without a throughline of ≤20 words and without a destination for the volume, no chapter is written.
- 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. - 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.
- 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).
- 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.
- 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.mdand eachturnos/*.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:
- 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.
- 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. - 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.mdand without compilation
Checklist
- Initial interview (theme, input, reader, thread, destination, structure, language, destination, authorization)
-
raw/pesquisa.mdwith 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
-
asciidoctorcompiles; cross-references resolve -
raw/curadoria.mdPASS or PASS with WARN