Que fait Starter Harness Designer — Workspace v1 ?
"Un bon modèle vaut mieux qu'un guide de 100 pages."
Ce skill est destiné à qui ?
- Les personnes qui créent un harness pour la première fois
- Les non-développeurs (chefs de projet, marketeurs, écrivains, avocats, enseignants, responsables opérationnels, etc.)
- Les personnes qui souhaitent démarrer rapidement avec une structure éprouvée
Il conserve la même philosophie en 3 étapes (Planner → Generator → Evaluator) que la version experte harness-designer-workspace, mais la complexité des entrées et la précision des sorties sont adaptées à un niveau débutant.
| Étape | Expert | Starter (ce skill) |
|---|---|---|
| Planner | 4 étapes Discovery, questions ouvertes | 3 questions à choix multiples → correspondance avec un numéro d'exemplar |
| Generator | Conception → création de fichiers/structure | Duplication d'exemplar + remplacement |
| Evaluator | Vérification indépendante des 8 piliers | Checklist légère — uniquement les substitutions manquantes et les références cassées |
Relation avec les autres skills de harness
│ Expert (conception libre) │ Débutant (duplication d'exemplar)
──────────────┼─────────────────────────────────────┼────────────────────────────────────
Workspace │ harness-designer-workspace │ harness-starter-workspace ★ (ce skill)
──────────────┼─────────────────────────────────────┼────────────────────────────────────
Codage │ harness-designer-coding │ harness-starter-coding
Cas où ne PAS utiliser ce skill :
- Développement d'applications, services web, API → utiliser
harness-starter-coding - Utilisateurs avancés ayant besoin de liberté de conception → utiliser
harness-designer-workspace - Questions simples ou tâches ponctuelles → pas besoin de skill
Flux d'exécution (5 minutes au total)
1. [Planner] 3 questions à choix multiples
2. [Planner] Correspondance avec un numéro d'exemplar + recommandation d'un préréglage
3. [Generator] Duplication de l'exemplar de harness-100
4. [Generator] Remplacement du nom du projet et des termes du domaine
5. [Evaluator] Checklist légère (5 secondes)
6. Notification de fin ("Et maintenant, utilisez-le ainsi")
Phase 0 : Correspondance de modèle (Planner)
Question 1 — Que voulez-vous accomplir ? (une phrase en langage naturel)
Recevez une phrase de l'utilisateur. Exemples :
- "Je veux une équipe qui planifie, écrit le script et crée la miniature pour une vidéo YouTube"
- "Une équipe qui extrait les clauses à risque d'un contrat"
- "Automatiser l'envoi d'une newsletter mensuelle"
Question 2 — Quelle est la catégorie la plus proche ? (8 choix multiples)
Consultez references/exemplar-index.md. Choisissez parmi les 8 catégories suivantes :
| Numéro | Catégorie | Exemple |
|---|---|---|
| 1 | 🎬 Création de contenu | YouTube, podcast, newsletter, bande dessinée, traduction |
| 4 | 📊 Business & Stratégie | Startup, étude de marché, tarification, modèle financier |
| 5 | 🎓 Éducation & Apprentissage | Tuteur de langue, préparation aux examens, conception de cursus |
| 6 | ⚖️ Droit & Conformité | Contrats, brevets, RGPD/données personnelles |
| 7 | 🏃 Style de vie | Régime alimentaire, fitness, fiscalité, voyage |
| 8 | 📝 Communication & Documentation | Rédaction technique, SOP, propositions |
| 9 | 🏢 Opérations & Processus | Recrutement, intégration, audit, achats |
| 10 | 🌐 Domaines spécialisés | Immobilier, ESG, portefeuille de PI |
À partir des mots-clés de la question 1, proposez automatiquement 1 à 3 recommandations et demandez à l'utilisateur de confirmer.
Gestion de l'échec de correspondance (similarité < 0,5) :
- Proposez les 3 candidats les plus proches et demandez "Lequel est le plus proche ?"
- Si aucun, orientez vers
harness-designer-workspace(version experte)
Question 3 — Quel est le nom du projet ?
Court et utilisable comme nom de dossier/fichier (ex. : production-youtube, examen-contrat, newsletter-mensuelle).
Question 4 — Souhaitez-vous garder un historique des modifications ? (facultatif, oui/non)
"Voulez-vous créer un espace pour enregistrer ce qui a changé et pourquoi lorsque vous améliorerez cette équipe plus tard ?"
- oui → Créez automatiquement un wiki
05-flow-history/+flow-change-protocol.md(la version initiale est enregistrée comme change 0001) - non → Ne créez rien (vous pourrez l'ajouter manuellement plus tard)
Utilité : rétrospective d'amélioration d'équipe, vérification des raisons en cas de rollback, référence pour créer des équipes similaires. Aucun impact sur l'utilisation quotidienne.
Principe de gestion : Cet historique enregistre uniquement les changements du système de workflow (règles, procédures, outils, CLAUDE.md). Les artefacts produits par le système (résultats de recherche, rapports, analyses, enregistrement d'ordre du jour) ne sont pas enregistrés.
Critère de distinction : "Si ce changement n'avait pas eu lieu, le résultat de la prochaine exécution serait-il différent ?"
→ Oui = changement système = enregistrer / Non = artefact = pas d'enregistrement
Détails : 00-system/protocols/flow-change-protocol.md
Question 3.5 (conditionnelle — uniquement pour les catégories de recherche)
📊 Business & Stratégie, 🎓 Éducation & Apprentissage, 🌐 Domaines spécialisés — affiché uniquement pour ces catégories. Ignoré pour les catégories non-recherche comme la création de contenu.
"Avez-vous besoin de référencer des recherches existantes tout en menant plusieurs ordres du jour ?"
- Oui → Inclure un wiki :
- Vérifier l'installation du skill /graphify (auto : ~/.claude/skills/graphify/ ou .claude/skills/graphify/)
- En cas de non-installation : explication + choix d'installation (globale/projet/non)
- ⚠️ Si non installé : "La fonction wiki est désactivée. Vous pourrez créer un wiki plus tard avec /wiki-update après avoir installé /graphify."
- Non → Ne pas inclure de wiki
Phase 1 : Sélection du préréglage (pondération d'évaluation)
Après la correspondance, recommandez et confirmez parmi 3 préréglages :
| Préréglage | Description | Critère de recommandation automatique |
|---|---|---|
| [Équilibré] (par défaut) | Tous les critères de qualité égaux | Valeur par défaut |
| [Qualité d'abord] | Pondération x2 pour Reviewer, scénarios de test, NOT-trigger | Catégories Droit, Médical, Finance, PI |
| [Vitesse d'abord] | Mode d'échelle = Single, checklist légère uniquement | Prototype unique, travail individuel |
Le préréglage sélectionné est enregistré dans _workspace/00_input.md.
Phase 2 : Générateur — duplication et remplacement d'exemplar
Étapes de duplication (avec repli automatique)
Détectez automatiquement la présence de gh (GitHub CLI) pour télécharger de manière optimale. Le fonctionnement est identique avec git seul.
EXEMPLAR="{NN}-{nom-exemplar}" # Résultat de la correspondance du Planner (ex. : 01-production-youtube)
BASE="ko/$EXEMPLAR/.claude"
if command -v gh &>/dev/null && gh auth status &>/dev/null 2>&1; then
# ── Méthode A : GitHub CLI (gh) ──────────────────────────────
echo "📡 Téléchargement via l'API gh..."
FILES=$(gh api "repos/revfactory/harness-100/git/trees/main?recursive=1" \
--jq ".tree[] | select(.path | startswith(\"$BASE/\")) | select(.type==\"blob\") | .path")
mkdir -p .claude/agents .claude/skills
while IFS= read -r filepath; do
rel="${filepath#$BASE/}"
dest=".claude/$rel"
mkdir -p "$(dirname "$dest")"
gh api "repos/revfactory/harness-100/contents/$filepath" \
--jq '.content' | base64 -d > "$dest"
echo " ✅ $dest"
done <<< "$FILES"
else
# ── Méthode B : git sparse checkout (sans gh) ─────────────
echo "📡 Téléchargement via git sparse checkout..."
TMP=$(mktemp -d)
git clone --depth 1 --filter=blob:none --sparse \
https://github.com/revfactory/harness-100.git "$TMP"
git -C "$TMP" sparse-checkout set "$BASE"
mkdir -p .claude
cp -r "$TMP/$BASE/." .claude/
rm -rf "$TMP"
echo " ✅ sparse checkout terminé"
fi
| Condition | Méthode utilisée | Outil nécessaire |
|---|---|---|
gh installé + connecté | Méthode A (gh api) | gh |
git seulement | Méthode B (sparse checkout) | git |
| Aucun des deux ou échec | Méthode C (création directe par Claude après confirmation utilisateur) | Aucun |
Si les méthodes A et B échouent, Claude informe directement l'utilisateur :
⚠️ Impossible de récupérer le modèle depuis GitHub.
Cause :
ghetgitsont indisponibles ou aucune connexion Internet.Dans ce cas, Claude peut écrire directement les fichiers du harness en se basant sur la description de l'index des exemplars. Attention : il ne s'agit pas d'un modèle réellement vérifié, mais d'une reproduction de la structure par Claude ; la qualité peut donc différer.
Voulez-vous continuer ?
- Oui → Claude crée directement les fichiers
.claude/(basé sur exemplar-index.md)- Non → Arrêt ici. Veuillez réessayer après avoir établi une connexion Internet ou installé git.
Si l'utilisateur choisit Oui : lisez la description de l'exemplar correspondant dans references/exemplar-index.md et créez directement les fichiers CLAUDE.md, agents/, skills/.
Si l'utilisateur choisit Non : arrêtez immédiatement, expliquez comment réessayer, puis terminez.
Structure après achèvement :
.claude/
├── CLAUDE.md
├── agents/
│ ├── {spécialiste-1}.md
│ ├── {spécialiste-2}.md
│ ├── {spécialiste-3}.md
│ ├── {spécialiste-4}.md
│ └── {reviewer}.md
└── skills/
├── {orchestrateur}/skill.md
└── {agent-extension}/skill.md
- Créez le dossier
_workspace/(pour les artefacts, convention de numérotation :00_input.md,01_*.md, ...)
Règles de remplacement
| Élément d'origine | Contenu à remplacer | Exemple |
|---|---|---|
| Nom du harness | Nom du projet utilisateur | 01-production-youtube → mon-emission-youtube |
| Termes du domaine (globaux) | Termes du domaine utilisateur | "Vidéo YouTube" → "Épisode de podcast" |
| Mots-clés de déclencheur | Mots-clés du domaine utilisateur | Lié à YouTube → Lié au podcast |
| Noms des rôles des agents | Remplacer uniquement si nécessaire | scriptwriter → conserver recommandé |
| Cadres du domaine | Ne jamais modifier | Porter's·IRAC·Bloom's sont une expertise essentielle |
_workspace/NN_*.md | Conserver (convention de numérotation) | Ne jamais changer les numéros |
Structure de dossiers supplémentaire (v2) :
50-reports/[nom-ordre-du-jour]/v[N]/report.md— Rapports isolés par ordre du jour60-exports/[nom-ordre-du-jour]/— Artefacts dérivés (diapositives, partage externe, etc.)- Frontmatter CARL : inclure les YAML frontmatter
agenda:,type:,tags:dans les modèles 70-playbook/ - (si wiki sélectionné)
45-wiki/— Dépôt du graphe de connaissances - (si wiki sélectionné) Skill
research-wiki— Référence wiki protégée par l'indépendance - (si wiki sélectionné) Commande
/wiki-update— Création et mise à jour du wiki - (si question 4 = oui)
05-flow-history/+00-system/protocols/flow-change-protocol.md— Wiki d'historique des modifications du flux. Référez-vous à~/.claude/skills/harness-designer-workspace/references/flow-history-template.mdpour créer 5+1 fichiers.
Liste d'interdiction de remplacement automatique :
- Noms de cadres intégrés (AIDA, IRAC, Bloom's, ADDIE, Porter's, DCF, Van Westendorp, SMART, etc.)
- Noms de répertoire
_workspace/et numéros d'artefacts - Termes de protocole comme
SendMessage,TaskCreate, etc. - Définitions des modes d'échelle
- Nom du répertoire
45-wiki/ - Nom du skill
research-wiki - Texte des règles de référence wiki du protocole d'indépendance
- Correction automatique par bkit : Les cadres du domaine (AIDA·IRAC·Bloom's etc.), le protocole d'indépendance, le protocole SendMessage, le système de numérotation
_workspace/ne doivent pas être modifiés sur proposition des agents bkit (code-analyzer, pm-lead, etc.) - Éléments de boucle : critères d'achèvement (condition de fin), ordre de révision du Reviewer (Reviewer en dernier), format de jugement du review_report — ne pas remplacer ni supprimer (une boucle nécessite un Objectif + Vérification + condition de fin pour exister)
Simplification des termes (pour expliquer à l'utilisateur, la structure interne reste en anglais)
Les fichiers internes restent en anglais. Ne simplifiez que lorsque vous expliquez à l'utilisateur :
| Terme technique | Explication simple |
|---|---|
| Orchestrator | Chef d'équipe |
| Agent-Extending Skill | Cahier de connaissances spécialisées |
| Dependency DAG | Tableau des tâches dans l'ordre |
| Scale Modes | Modes de taille d'équipe |
| Trigger Boundaries | Conditions d'appel |
| Cross-validation | Révision croisée |
Phase 3 : Évaluateur — Checklist légère
Au lieu de la vérification des 8 piliers de la version experte, vérifiez uniquement l'intégrité des remplacements.
Vérifications automatiques (5 secondes)
- Fichier
.claude/CLAUDE.mdprésent - Dossier
agents/contient 4 à 5 fichiers.md(Reviewer inclus) - Fichier
skills/<orchestrateur>/skill.mdprésent - Au moins 1 skill d'extension d'agent dans
skills/ - Dossier
_workspace/créé - Aucune occurrence restante du nom du harness d'origine (ex. :
01-production-youtube) dans les fichiers (grep 0 résultat) - Noms des cadres intégrés préservés (IRAC/Bloom's etc. identiques à l'original)
- Section
should-NOTdans les Trigger Boundaries présente - Tableau des modes d'échelle présent (Full / Reduced / Single)
- Section des 3 scénarios de test présente (Normal / Existing / Error)
- Structure de dossiers par ordre du jour dans 50-reports/ présente
- Dossier 60-exports/ présent (séparation des artefacts dérivés)
- Frontmatter CARL présent dans les modèles 70-playbook/
- Commande /synthesize inclut une porte obligatoire pour les tâches restantes
- Le skill.md de l'orchestrateur contient des critères d'achèvement vérifiables (conditions de fin)
- L'artefact du Reviewer (review_report) est formaté pour inclure un verdict (réussi/modifications nécessaires)
- (si wiki sélectionné) Dossier 45-wiki/ présent
- (si wiki sélectionné) Skill research-wiki présent
- (si wiki sélectionné) Règle de référence wiki dans le protocole d'indépendance
En cas d'échec
- Substitution manquante détectée → Re-demander au Planner ("Par quel terme voulez-vous remplacer ?")
- Défaut structurel → Re-dupliquer l'exemplar correspondant, puis remplacer à nouveau
- 3 échecs → Suggérer le passage à
harness-designer-workspace
Phase 4 : Notification d'achèvement (rapport simplifié pour non-développeurs)
✅ Le harness est prêt !
📁 Emplacement : /votre-projet/.claude/
👥 Composition de l'équipe (5 personnes) :
- Stratège : Recherche de sujets, analyse de la concurrence
- Scénariste : Rédaction du script
- Designer miniature : Conception d'images
- Responsable SEO : Optimisation pour les moteurs de recherche
- Relecteur : Validation de la qualité globale
🚀 Utilisation :
1. Dans Claude Code, tapez "/mon-emission-youtube planifie la prochaine vidéo"
2. L'équipe travaille dans l'ordre, les artefacts sont enregistrés dans le dossier _workspace/
3. Les résultats sont numérotés de 00_input.md à 05_review_report.md
🔄 Fonctionnement de l'équipe (boucle) :
L'équipe fonctionne en boucle "Objectif → Travail → Vérification → Terminé si validé".
Le rapport du dernier relecteur (0X_review_report.md) est le résultat de la validation.
Si le résultat ne vous satisfait pas, demandez à nouveau en précisant ce qui ne va pas —
ce jugement final est votre rôle (boucle externe).
📘 Prochaines étapes :
- Si quelque chose ne vous plaît pas, modifiez .claude/agents/{rôle}.md
- Pour plus de complexité, utilisez le skill harness-designer-workspace
Références
- exemplar-index.md — Index des 73 exemplars de workspace
- Original : https://github.com/revfactory/harness-100 (Apache-2.0)
- Variante experte :
harness-designer-workspace - Variante pour le codage :
harness-starter-coding