katib (كاتب)

Katib — compétence de rédaction de copy pour site web

Adapté du « AI Market Research Sprint » (écrit pour un chat ChatGPT) en un workflow d'agent. Règle fondamentale pour chaque étape : l'argument d'abord, les mots ensuite — lisez references/argument-first.md avant l'étape 1.

Ordre fixe (ne jamais sauter, ne jamais réordonner)

0 Accueil → 1 Analyse de référence → 2 Recherche → 3 Avatar → 4 Brief d'offre → 5 Croyances → 6 Copy du site → 7 Vérification finale

Chemins

• Fichiers de la compétence : relatifs au répertoire de base de cette compétence (affiché au chargement de la compétence). L'outil Reddit est tools/reddit_fetch.py là-bas — donnez aux chercheurs son chemin absolu.
• Dossier client : <racine du projet actuel>/katib-clients/<slug-client>/ avec : 00-input.md · 01-reference-review.md · 02-research.md · research-raw/ · 03-avatar.md · 04-offer-brief.md · 05-beliefs.md · 06-website-copy.md

Chaque étape lit les fichiers précédents. Si le dossier existe déjà, lisez-le et reprenez à partir du premier fichier manquant (ou refaites uniquement l'étape nommée par l'utilisateur).

Étapes

Configuration (première exécution, et à chaque échec) — vérifiez PinchTab : pinchtab --version et pinchtab health. Manquant ou non connecté → guidez l'utilisateur à travers references/setup-pinchtab.md étape par étape avant la recherche. Déjà fonctionnel → ne dites rien, continuez.

0. Accueil — Demandez tout ce qui manque, en un seul message : produit (ce que c'est, prix si connu), public, marché/pays, langue de sortie (arabe du Golfe / arabe MSA / anglais / les deux), capture d'écran de la page de référence (ou URL), tout ce que la marque possède déjà (avis, preuve, garantie, histoire). Écrivez 00-input.md.

1. Analyse de référence — suivez references/sales-page-review.md. Écrivez 01-reference-review.md. ⏸ Contrôle : affichez le verdict + la carte des sections + ce qu'il faut emprunter. Attendez l'accord.

2. Recherche — suivez references/research-method.md et references/research-agents.md. Lancez les 5 chercheurs en parallèle (R1–R4 + R5 Reddit), fusionnez dans templates/research-doc.md → 02-research.md. Instagram, TikTok et Reddit connecté sont lus via le profil research de PinchTab (lecture seule) ; solution de repli : le Chrome connecté de l'utilisateur (son propre onglet), puis Scrapling. Si le marché local est mince, R1 et R5 élargissent au même type d'entreprise dans le monde et taguent ces citations avec le pays. Ensuite écrivez 02-research-summary.md pour l'utilisateur : dans la langue de l'utilisateur, sections courtes avec en-têtes emoji (qui / rêves / douleur / blâme / croyances / meilleure histoire / concurrents / candidats mécanismes / avertissements / lacunes), 1 à 3 citations clés chacune avec [S#]. ⏸ Contrôle : affichez le bloc résumé et les sections minces. Attendez l'accord (l'utilisateur peut demander plus de recherches).

3. Avatar — remplissez templates/avatar.md à partir de 02-research.md uniquement → 03-avatar.md. Acheteur professionnel → « Revenu mensuel » ; consommateur → « Revenu / pouvoir d'achat ». Pas de contrôle ; montrez-le avec l'étape 4. Plusieurs segments → un fichier avatar par segment (03-avatar-<segment>.md) ; l'utilisateur dit lequel mène le copy.

Options de positionnement (optionnelles, quand l'utilisateur le demande) — exécutez la compétence creator-toolkit:personal-brand-expert sur la marque (elle fonctionne aussi pour les entreprises), en utilisant 02-research.md et les avatars. Écrivez 03b-positioning.md avec plusieurs options ; le choix de l'utilisateur alimente la grande idée à l'étape 4.

4. Brief d'offre — suivez references/offer-brief-guide.md, remplissez templates/offer-brief.md dans l'ordre → 04-offer-brief.md. ⏸ Contrôle après le champ 6 : 3 options chacune pour UMP, UMS, grande idée. L'utilisateur choisit. Ensuite terminez les champs 7 à 20.

5. Croyances — suivez references/beliefs.md → 05-beliefs.md. ⏸ Contrôle : l'utilisateur approuve les croyances avant tout copy.

6. Copy du site — suivez references/website-copy.md, remplissez templates/website-copy.md → 06-website-copy.md.

7. Vérification finale — exécutez le test 4 de references/website-copy.md, puis montrez le copy, la liste « preuves à obtenir de la marque » et les questions ouvertes. ⏸ L'utilisateur approuve ou demande des modifications.

Règles strictes

• N'inventez jamais de citations, avis, chiffres, études, personnes, prix ou garanties. Manquant → demandez ou signalez.
• Chaque citation de recherche est textuelle avec une URL qui a été ouverte. Les citations d'avatar citent [S#] du document de recherche.
• Ne copiez jamais de phrases de la page de référence ; empruntez uniquement la structure.
• Écrivez le copy dans la langue demandée par l'utilisateur. Mots simples, phrases courtes.
• Signalez les allégations de santé, financières et juridiques pour conformité.
• Parlez à l'utilisateur dans sa langue (généralement arabe du Golfe), court et simple. Les fichiers de la compétence restent en anglais.

Plus tard : publicités

Pas encore construit. Quand on vous le demande, réutilisez 04-offer-brief.md et 05-beliefs.md (une croyance ou la grande idée par annonce). Pas de nouvelle recherche.