← ClaudeAtlas

redacteurlisted

Le rédacteur : rédiger un document du dépôt lu par des humains. À charger avant d'écrire ou de réécrire : l'architecture du projet ou d'un composant, son cadre, son interface ; une spécification ; un guide ; tout document de référence. Pour un document lu par un agent (compétence, charte, consigne), `grillhouse:writing-for-agents`.
roomi-fields/roomis-grillhouse · ★ 2 · Code & Development · score 75
Install: claude install-skill roomi-fields/roomis-grillhouse
# Rédacteur — rédiger un document Chaque document a un public, un modèle que ce public connaît déjà, et un squelette de section. Les règles ci-dessous valent pour tous ; la référence du type donne le reste. ## Ce qui vaut pour tout document Le lecteur est un ingénieur. Chaque phrase lui apprend ce qu'est une chose ou ce qu'elle fait, avec les mots qu'il emploie lui-même. La langue du document est celle de la charte. ### Le fond - **Une phrase dit ce qui est** : elle décrit ce qu'une chose est ou fait ; une limite s'énonce par ce que fait l'autre composant. Ainsi le document se lit comme l'architecture que le code suit. - **Le principe avant le nom** : le lecteur apprend à quoi sert une chose avant d'en lire le nom. Une notion se définit une fois, juste avant son premier usage. Ainsi chaque nom du document désigne une chose comprise. - **Une information, une adresse** : elle vit à une seule place, dans le document et entre les documents ; ce qu'un autre document dit se cite par un renvoi, en fin de section. Ainsi chaque décision de l'architecture a une seule version, celle que le code suit. - **Deux choses parallèles se décrivent de la même manière** : si les entrées passent par un bus, les sorties aussi, ou aucune des deux n'en parle. Ainsi le lecteur compare ce qui se compare. - **Le document parle de son sujet** : une architecture décrit le produit ; l'organisation du dépôt et la façon de travailler vivent dans la charte. Ainsi chaque document répond à un