Audit Prose — Guia Definitivo do Claude Code

source-command-audit-prose

Use este skill quando o usuário solicitar a execução do comando migrado audit-prose.

Modelo de Comando

Audit Prose — Enriquecimento de Seções Nuas

Adiciona prosa descritiva (2-4 frases) antes de cada seção "nua" dos whitepapers. Uma seção "nua" = heading seguido diretamente de uma tabela, bloco de código ou lista sem parágrafo de introdução.

Uso

/audit-prose        # Todos os WPs (00-08), FR + EN
/audit-prose 07     # Apenas WP07 (FR + EN)
/audit-prose 03 07  # Apenas WP03 e WP07

Definição "Seção Nua"

Seção (## ou ###) seguida DIRETAMENTE por:

• Uma tabela Markdown (|)
• Um bloco de código ( ```)
• Uma lista com marcadores (-) ou numerada

Sem parágrafo de introdução (mínimo 2 frases).

Regras Estritas (não negociáveis)

1. NUNCA terminar um parágrafo com : antes de uma lista com marcadores → bug Typst que mescla os bullets em inline
2. NÃO inventar números, métricas ou citações
3. NÃO adicionar callouts (:::), Mermaid ou cenários persona
4. NÃO ultrapassar +15% de linhas por arquivo
5. Versões mantidas em 3.27.6
6. Prosa EN = inglês natural, não tradução palavra por palavra do FR
7. Cada adição = mínimo 2 frases, máximo 4 frases

Exemplo de Transformação

ANTES:
### Exit Codes
| Code | Signification |
|------|---------------|
| 0    | Autorisé      |

DEPOIS:
### Exit Codes
Les hooks communiquent avec Codex via des codes de sortie standardisés.
C'est le mécanisme qui permet de bloquer ou autoriser une action en temps réel,
sans intervention humaine.

| Code | Signification |
|------|---------------|
| 0    | Autorisé      |

Fluxo de Trabalho: 9 Agentes Paralelos

Fontes de Contexto

• machine-readable/reference.yaml : mapeamento assuntos → linhas do guia principal
• guide/ultimate-guide.md : guia de referência (nas linhas indicadas no reference.yaml)
• Conhecimento Codex (v3.27.6, MCP, hooks, agent teams, etc.)

Mapeamento dos WPs

#	FR	EN	~Seções nuas
00	whitepapers/fr/00-introduction-serie.qmd	whitepapers/en/00-series-introduction.qmd	~10
01	whitepapers/fr/01-prompts-efficaces.qmd	whitepapers/en/01-effective-prompts.qmd	~14
02	whitepapers/fr/02-personnalisation.qmd	whitepapers/en/02-customization.qmd	~18
03	whitepapers/fr/03-securite.qmd	whitepapers/en/03-security.qmd	~20
04	whitepapers/fr/04-architecture.qmd	whitepapers/en/04-architecture.qmd	~14
05	whitepapers/fr/05-equipe.qmd	whitepapers/en/05-team.qmd	~20
06	whitepapers/fr/06-privacy.qmd	whitepapers/en/06-privacy.qmd	~12
07	whitepapers/fr/07-guide-reference.qmd	whitepapers/en/07-reference-guide.qmd	~36
08	whitepapers/fr/08-agent-teams.qmd	whitepapers/en/08-agent-teams.qmd	~16

Execução

Se argumento = número WP específico: lançar 1 agente para esse par FR/EN apenas.

Se nenhum argumento (ou "all"): criar uma equipe audit-prose-{data} e lançar 9 agentes em paralelo.

Para cada WP alvo, lançar um agente com este prompt:

Você é um editor técnico sênior. Sua missão: adicionar PROSA DESCRITIVA
às seções "nuas" do whitepaper [XX - Título].

## Definição "seção nua"
Seção (## ou ###) seguida DIRETAMENTE por uma tabela, bloco de código, ou
lista com marcadores, SEM parágrafo de introdução (2+ frases).

## O que você faz
Para CADA seção nua identificada:
1. Adicionar 2-4 frases ANTES do conteúdo estruturado
2. Cada frase traz uma INFO NOVA: o porquê, quando usar,
   as implicações, a escolha de design, ou o contexto prático
3. NÃO reformular o que vem a seguir — COMPLETAR com contexto faltante

## Fontes de Contexto
- `machine-readable/reference.yaml` : mapeamento completo assuntos → guia principal
- Seu conhecimento de Codex (v3.27.6, MCP, hooks, agent teams, etc.)

## Regras estritas
- NÃO inventar números, métricas ou citações
- NÃO adicionar callouts (:::), Mermaid ou cenários persona
- NUNCA terminar um parágrafo com ":" antes de uma lista com marcadores (bug Typst)
- NÃO ultrapassar +15% de linhas
- Manter versões em 3.27.6
- Prosa EN = inglês natural, não tradução palavra por palavra
- Cada adição = mínimo 2 frases, máximo 4 frases

## Processo
1. LER reference.yaml (seções pertinentes ao WP)
2. LER o WP FR completo
3. IDENTIFICAR todas as seções nuas
4. EDITAR o arquivo FR (ferramenta Edit, seção por seção)
5. LER o WP EN completo
6. EDITAR o arquivo EN
7. VERIFICAR: nenhum parágrafo termina com ":" antes de uma lista
8. Relatar: seções tratadas, delta linhas FR/EN

Espera e Relatório

Aguardar os retornos de todos os agentes. Para cada WP concluído, exibir:

WP[XX] ✅ — [N] seções, +[X]% FR/EN

Desligamento

Quando todos os agentes tiverem terminado, enviar shutdown_request para cada um, depois TeamDelete.

Verificação Pós-Enriquecimento

# 1. Delta linhas (máx +15%)
for f in whitepapers/fr/*.qmd; do
  echo "$(wc -l < "$f") $(basename $f)"
done

# 2. Verificar bug Typst: parágrafo terminando com ":" seguido de lista
grep -n ':$' whitepapers/fr/*.qmd whitepapers/en/*.qmd | head -20

# 3. Versões intactas
grep "^version:" whitepapers/fr/*.qmd whitepapers/en/*.qmd

# 4. Reconstruir PDFs
for f in whitepapers/fr/*.qmd whitepapers/en/*.qmd; do
  quarto render "$f"
done

Orçamento de Linhas por WP

WP	Orçamento máx FR	Orçamento máx EN
00	+54 linhas	+54 linhas
01	+142 linhas	+142 linhas
02	+189 linhas	+189 linhas
03	+145 linhas	+145 linhas
04	+120 linhas	+120 linhas
05	+143 linhas	+143 linhas
06	+79 linhas	+79 linhas
07	+281 linhas	+281 linhas
08	+241 linhas	+241 linhas