site-architecture

Présentation de la skill site-architecture

À quoi sert la skill site-architecture

La skill site-architecture vous aide à planifier ou réorganiser la hiérarchie des pages d’un site, sa navigation, sa structure d’URL et son maillage interne. Elle est conçue pour des travaux d’architecture de l’information, pas pour générer des fichiers sitemap XML techniques. Si votre vraie question est : « de quelles pages ce site a-t-il besoin, comment doivent-elles s’articuler, et comment les utilisateurs doivent-ils y circuler ? », c’est la bonne skill.

À qui s’adresse site-architecture

Cette skill site-architecture est particulièrement adaptée à :

• des équipes marketing qui préparent un nouveau site ou une refonte importante
• des fondateurs qui définissent le site marketing d’un SaaS
• des équipes UI/UX qui travaillent sur la navigation et l’architecture de l’information
• des équipes contenu sensibles au SEO qui doivent décider des hubs, sections et relations entre pages
• des agences qui ont besoin rapidement d’une première version de sitemap, de plan d’URL et de spécification de navigation

Elle est particulièrement utile quand un site a grossi de façon organique et devient difficile à parcourir, incohérent, ou trop profond dans sa structure.

Cas d’usage où elle est la plus pertinente

Utilisez site-architecture quand vous devez :

• transformer une liste approximative de pages en plan de site cohérent
• trancher entre une structure plate ou plus profonde
• définir la navigation du header, du footer et des sections
• créer des conventions d’URL pour des sections comme /features, /compare ou /integrations
• améliorer le maillage interne entre pages hub et pages de détail
• produire un sitemap visuel en ASCII ou Mermaid pour relecture

Ce qui distingue cette skill d’un prompt générique

Un prompt générique peut lister des pages. La skill site-architecture va plus loin, car elle pousse vers un livrable plus complet :

• contexte business et audience en premier
• conception explicite de la hiérarchie
• recommandations de navigation
• modèles de structure d’URL
• recommandations de maillage interne
• sorties visuelles de type sitemap
• templates réutilisables pour les types de sites courants

Le repo inclut aussi des références pratiques pour les diagrammes Mermaid, les modèles de navigation et les templates par type de site, ce qui rend les sorties plus homogènes qu’un travail lancé de zéro.

Limites de périmètre importantes

Cette skill ne couvre pas principalement :

• les fichiers sitemap XML
• les audits SEO complets
• le balisage schema
• les wireframes finaux ou des maquettes UI abouties

Pour site-architecture for UI/UX Design, elle est surtout utile au niveau structurel : regroupement des pages, repérage dans le site, zones de navigation et découvrabilité du contenu avant la conception détaillée de l’interface.

Comment utiliser la skill site-architecture

Contexte d’installation et mode d’accès

Installez la skill depuis le repository avec :

npx skills add https://github.com/coreyhaines31/marketingskills --skill site-architecture

En pratique, les utilisateurs déclenchent site-architecture en demandant de l’aide sur les sitemaps, la navigation, la hiérarchie des pages ou la planification des URL. Elle fonctionne le mieux dans une configuration d’agent compatible Skills, où le modèle peut lire les fichiers de la skill et suivre son workflow.

À lire en priorité avant d’utiliser site-architecture

Si vous voulez évaluer rapidement la skill, commencez ici :

1. skills/site-architecture/SKILL.md
2. skills/site-architecture/references/site-type-templates.md
3. skills/site-architecture/references/navigation-patterns.md
4. skills/site-architecture/references/mermaid-templates.md
5. skills/site-architecture/evals/evals.json

Cet ordre de lecture vous donne le workflow, les sorties les plus courantes, les options de navigation concrètes, les formats de diagramme et ce à quoi ressemble une “bonne” sortie dans les évaluations.

Les informations les plus importantes à fournir à la skill

La skill site-architecture devient nettement meilleure si vous précisez :

• ce que fait l’entreprise
• les audiences principales
• les objectifs prioritaires du site, en général 2 à 3 maximum
• s’il s’agit d’un nouveau site ou d’une restructuration
• l’inventaire des pages existantes, si vous en avez un
• les points de friction, comme les doublons, une arborescence trop profonde ou une faible trouvabilité
• le type de site, par exemple SaaS, ecommerce, services, marketplace ou site riche en contenu

Si vous omettez ces éléments, le modèle peut quand même proposer une structure, mais elle restera générique et risque de retenir le mauvais schéma de navigation.

Vérifiez d’abord le contexte product marketing

Un comportement utile propre au repo : la skill indique explicitement à l’agent de vérifier .agents/product-marketing-context.md ou l’ancien .claude/product-marketing-context.md avant de poser des questions. C’est important, car beaucoup de décisions d’architecture dépendent du positionnement, des audiences et de la structure de l’offre.

Si votre contexte product marketing est déjà documenté, indiquez-le au modèle. Cela réduit les allers-retours répétitifs et améliore les choix de regroupement des pages.

Transformer un objectif vague en prompt site-architecture solide

Prompt faible :

Help me make a sitemap.

Prompt plus solide :

Use the site-architecture skill to plan a SaaS marketing site for an analytics product aimed at ecommerce teams. Our goals are demo requests, SEO traffic, and partner integrations. We need a homepage, pricing, feature pages, docs, blog, integrations, and competitor comparison pages. Keep top nav to 5-6 primary items. Propose page hierarchy, URL structure, header/footer nav, and internal linking model.

Pourquoi cela fonctionne :

• l’audience et le type d’activité sont définis
• les objectifs de conversion et de contenu sont précisés
• les types de contenus nécessaires sont listés
• une contrainte de navigation est ajoutée
• la demande porte sur des livrables concrets que la skill est conçue pour produire

À quoi ressemble une bonne utilisation de site-architecture

Demandez la sortie dans cet ordre :

1. hypothèses et informations manquantes
2. hiérarchie proposée
3. plan d’URL
4. spécification de navigation
5. recommandations de maillage interne
6. arborescence ASCII ou diagramme Mermaid
7. arbitrages ou questions ouvertes

Cela reflète les points forts pratiques de la skill. Vous pouvez ainsi valider la structure avant de débattre des libellés ou des détails de design.

Utilisez les templates de référence au lieu de partir d’une page blanche

Le plus grand raccourci d’adoption, c’est le jeu de références :

• site-type-templates.md fournit des modèles de hiérarchie prêts à l’emploi
• navigation-patterns.md aide à choisir entre header simple, mega menu ou autres modèles de navigation
• mermaid-templates.md accélère la création de sitemaps visuels

Pour beaucoup d’équipes, le meilleur workflow est le suivant : choisir le template de site le plus proche, adapter les sections, puis affiner la navigation et les URL. C’est plus rapide et, en général, plus efficace qu’un prompting entièrement libre.

Workflow recommandé pour un nouveau site

Pour une nouvelle création :

1. définir les objectifs business et les audiences
2. choisir le template de type de site le plus proche
3. ajuster les sections principales
4. fixer les conventions d’URL
5. limiter la navigation du header aux éléments prioritaires
6. affecter les pages secondaires au footer ou à une navigation de section
7. ajouter un maillage interne de type hub-and-spoke lorsque c’est pertinent
8. exporter une arborescence ASCII ou un diagramme Mermaid pour revue par les parties prenantes

Cela fonctionne particulièrement bien pour les SaaS, où des sections comme /features, /customers, /resources, /integrations et /compare doivent souvent être nettement séparées.

Workflow recommandé pour une restructuration

Pour un site existant désordonné, donnez au modèle :

• la navigation actuelle
• le nombre de pages ou un inventaire
• les sections dupliquées
• les pages avec peu de trafic ou une responsabilité éditoriale floue
• les retours utilisateurs du type « on ne trouve pas la doc » ou « il y a trop de menus déroulants »

Puis demandez-lui de :

• consolider les sections
• supprimer les points d’entrée redondants
• réduire la profondeur inutile
• séparer la navigation principale des éléments utilitaires ou du footer
• préserver autant que possible les anciennes URL à forte valeur

C’est là que la skill site-architecture est plus utile qu’un simple prompt de brainstorming, car elle cadre le travail comme une réorganisation, pas seulement comme une liste de pages.

site-architecture pour les équipes UI/UX Design

Pour l’UI/UX Design, utilisez la skill avant les wireframes quand vous devez clarifier :

• ce qui relève de la navigation globale
• où des pages d’atterrissage de section sont nécessaires
• comment le fil d’Ariane doit refléter la hiérarchie
• quelles pages méritent un accès direct plutôt qu’indirect
• à quel moment un mega menu se justifie

Elle ne remplace pas le design d’interaction, mais elle donne aux équipes UI/UX une base d’architecture de l’information plus défendable avant de concevoir les composants.

Formats de sortie pratiques à demander

La skill est la plus performante quand vous demandez un ou plusieurs de ces formats :

• arborescence ASCII pour une revue rapide
• sitemap Mermaid pour la documentation
• tableau de plan d’URL avec priorités
• spécification de navigation header/footer
• modèle de maillage interne par section

Tous ces formats sont appuyés par les éléments du repository ; vous alignez donc votre demande avec ce que la skill gère déjà bien.

FAQ sur la skill site-architecture

site-architecture convient-elle aux débutants ?

Oui, si vous connaissez déjà les objectifs du site et ses grands types de contenus. La skill apporte une structure plus vite que de devoir inventer toute l’architecture de l’information à partir de zéro. Les débutants rencontrent surtout des difficultés lorsqu’ils fournissent trop peu de contexte, pas parce que la skill serait trop avancée.

Quand utiliser site-architecture plutôt qu’un prompt classique ?

Utilisez la skill site-architecture quand la sortie doit être directement exploitable : hiérarchie, navigation, règles d’URL et stratégie de liens internes. Un prompt classique peut faire émerger des idées de pages, mais cette skill est meilleure quand vous avez besoin d’un artefact d’architecture révisable.

Est-ce que site-architecture crée des sitemaps XML ?

Non. Cette skill sert à l’architecture de l’information et à la planification de la navigation. Ce n’est pas le bon outil pour générer des sitemaps XML ni pour faire un diagnostic technique de crawl.

site-architecture est-elle utile pour des sites existants, pas seulement pour des nouveaux ?

Oui. Elle est très adaptée aux restructurations, surtout lorsqu’un site compte trop de pages, présente des regroupements incohérents ou une navigation confuse. Donnez-lui l’état actuel et les points de douleur, pas seulement l’état futur souhaité.

Comment se compare-t-elle à un travail d’IA manuel ?

Le travail manuel d’architecture de l’information garde toute sa valeur, mais cette skill accélère une première proposition de structure et fournit des templates réutilisables. Elle est surtout utile pour générer des options, mettre au jour les arbitrages et produire des artefacts à revoir en équipe. Le jugement humain reste nécessaire pour les sujets de politique interne, de responsabilité et de contraintes de mise en œuvre.

Est-ce un bon choix pour site-architecture for UI/UX Design ?

Oui, comme outil de cadrage amont. Elle aide les équipes UI/UX Design à définir les relations entre pages, la profondeur de navigation et la logique de repérage avant les layouts détaillés. Elle est moins adaptée aux décisions de design au niveau des composants.

Dans quels cas site-architecture n’est-elle pas la bonne skill ?

Évitez-la si votre besoin réel concerne :

• un audit SEO technique
• la planification du schema
• la rédaction de contenu
• le wireframing de pages en haute fidélité
• l’architecture de l’information d’une application bien au-delà des schémas de site marketing

Elle est également peu adaptée si vous n’êtes pas en mesure de fournir un minimum de contexte business.

Comment améliorer la skill site-architecture

Donnez des contraintes business plus nettes

Le moyen le plus rapide d’améliorer la sortie de site-architecture est d’énoncer clairement les contraintes :

• action de conversion principale
• segments d’audience prioritaires
• nombre maximal d’éléments dans la navigation du header
• sections indispensables
• sections à exclure de la navigation principale
• priorité ou non donnée aux pages d’atterrissage SEO

Sans contraintes, le modèle a tendance à inclure trop de pages et à ne pas assez prioriser la navigation.

Fournissez un inventaire de pages pour les restructurations

Pour les sites existants, collez un inventaire approximatif des pages ou la navigation actuelle. Même une liste désordonnée suffit. Cela aide la skill site-architecture à repérer des opportunités de consolidation, des structures dupliquées et des sections orphelines qui passeraient sinon inaperçues.

Demandez des arbitrages, pas une seule réponse

Un bon schéma d’amélioration est :

Give me a recommended architecture plus one simpler option and one SEO-expansion option.

Cela fait ressortir de vraies décisions, par exemple :

• navigation simple vs navigation extensible
• moins de sections de premier niveau vs hubs de pages d’atterrissage dédiés
• hiérarchie plus plate vs catégorisation plus explicite

La skill devient ainsi plus utile pour aligner les parties prenantes.

Exigez des livrables précis pour obtenir une sortie plus claire

Si la première sortie vous semble vague, demandez :

• une arborescence ASCII complète
• des modèles d’URL exacts
• des libellés de navigation avec le nombre d’éléments
• des exemples de fil d’Ariane
• des liens internes au niveau des sections

Des formats précis réduisent les recommandations floues et rendent le guide site-architecture plus prêt pour l’implémentation.

Modes d’échec fréquents à surveiller

Surveillez ces problèmes dans les premières versions :

• trop d’éléments au premier niveau de navigation
• des noms de catégories qui se recoupent
• des hubs de contenu mélangés à des pages de conversion sans priorité claire
• une profondeur excessive avec peu de bénéfice utilisateur
• un regroupement incohérent de blog/resources/docs
• des pages d’atterrissage SEO ajoutées sans plan de maillage

Ce sont des problèmes classiques d’architecture de l’information que la skill peut introduire si votre prompt est trop large ou ambigu.

Améliorez les recommandations de maillage interne

Ne vous contentez pas d’un simple “add internal links”. Demandez au modèle de préciser :

• quelles pages hub renvoient vers quelles pages de détail
• quelles pages de détail renvoient vers les hubs
• où des liens croisés sont pertinents, par exemple de features vers integrations ou de comparisons vers pricing
• quelles pages doivent être exclues d’un maillage croisé trop dense

C’est ce qui fait passer l’usage de site-architecture d’un niveau conceptuel à un niveau réellement actionnable.

Appuyez-vous sur les références du repo pour renforcer les brouillons faibles

Si la sortie vous paraît générique, demandez au modèle d’appliquer :

• references/navigation-patterns.md pour les décisions de navigation
• references/site-type-templates.md pour la couverture des sections
• references/mermaid-templates.md pour des diagrammes plus clairs

C’est l’un des moyens les plus simples d’améliorer la skill site-architecture sans modifier la skill elle-même.

Itérez après la première passe d’architecture

La bonne pratique consiste à faire un second prompt du type :

Revise this site architecture to reduce header nav to 5 items, move low-priority pages to footer, preserve our existing /blog structure, and create a clearer hub model for integrations and comparison pages.

C’est généralement avec ce type de révision ciblée que la skill devient vraiment utile en production.

Validez la structure face à de vrais parcours utilisateurs

Avant d’adopter la sortie, vérifiez que les parcours clés sont fluides :

• visiteur découvrant le produit pour la première fois
• acheteur en phase de comparaison allant vers une page de décision
• visiteur SEO passant d’un article à une intention produit
• client existant cherchant la documentation ou le support
• partenaire potentiel cherchant des détails sur les integrations

Si ces parcours paraissent maladroits, la site-architecture a besoin d’une nouvelle itération, même si le sitemap semble propre.

Améliorez site-architecture en resserrant l’audience ciblée

Des audiences trop larges produisent une architecture brouillonne. Si la première sortie essaie de parler à tout le monde, séparez les priorités :

• acheteur vs utilisateur
• SMB vs enterprise
• prospect vs client
• contenu éducatif vs contenu de conversion

La skill site-architecture s’améliore nettement quand la priorité d’audience est claire, car la navigation et le regroupement des pages deviennent plus faciles à justifier.