# Source Command Audit Prose

Add descriptive prose to bare sections in whitepapers (FR + EN) using 9 parallel agents

- Repository: https://github.com/FlorianBruniaux/claude-code-ultimate-guide (6315 stars)
- Category: AI and agents
- License: CC-BY-SA-4.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add FlorianBruniaux/claude-code-ultimate-guide --skill source-command-audit-prose -g -a claude-code -y`
Codex: `npx skills add FlorianBruniaux/claude-code-ultimate-guide --skill source-command-audit-prose -g -a codex -y`
Cursor: `npx skills add FlorianBruniaux/claude-code-ultimate-guide --skill source-command-audit-prose -g -a cursor -y`
Gemini CLI: `npx skills add FlorianBruniaux/claude-code-ultimate-guide --skill source-command-audit-prose -g -a gemini-cli -y`

## Description

Add descriptive prose to bare sections in whitepapers (FR + EN) using 9 parallel agents

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# source-command-audit-prose

Use this skill when the user asks to run the migrated source command `audit-prose`.

## Command Template

# Audit Prose, Enrichissement des Sections Bare

Ajoute de la prose descriptive (2-4 phrases) devant chaque section "bare" des whitepapers.
Une section "bare" = heading suivi directement d'une table, code block, ou liste sans paragraphe d'intro.

## Usage

```
/audit-prose        # Tous les WPs (00-08), FR + EN
/audit-prose 07     # WP07 seulement (FR + EN)
/audit-prose 03 07  # WP03 et WP07 seulement
```

## Définition "Bare Section"

Section (`##` ou `###`) suivie DIRECTEMENT par :
- Une table Markdown (`|`)
- Un code block (` ``` `)
- Une liste à puces (`-`) ou numérotée

Sans paragraphe d'introduction (minimum 2 phrases).

## Règles Strictes (non négociables)

1. **NE JAMAIS** terminer un paragraphe par `:` avant une liste à puces → bug Typst qui fusionne les bullets en inline
2. **NE PAS** inventer de chiffres, métriques, ou citations
3. **NE PAS** ajouter de callouts (`:::`), Mermaid, ou scénarios persona
4. **NE PAS** dépasser +15% de lignes par fichier
5. Versions maintenues à **3.27.6**
6. Prose EN = anglais naturel, **pas** de traduction mot-à-mot du FR
7. Chaque ajout = **minimum 2 phrases, maximum 4 phrases**

## Exemple de Transformation

```
AVANT :
### Exit Codes
| Code | Signification |
|------|---------------|
| 0    | Autorisé      |

APRÈS :
### 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é      |
```

## Workflow : 9 Agents Parallèles

### Sources de contexte

- `machine-readable/reference.yaml` : mapping sujets → lignes du guide principal
- `guide/ultimate-guide.md` : guide de référence (aux lignes indiquées dans reference.yaml)
- Connaissance Codex (v3.27.6, MCP, hooks, agent teams, etc.)

The rest: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/blob/HEAD/.agents/skills/source-command-audit-prose/SKILL.md
