Communitygithub.com

architecture-site

Lorsque l'utilisateur souhaite planifier, cartographier ou restructurer son site web.

Qu'est-ce que architecture-site ?

Cette compétence spécialise l'agent en architecture de l'information pour la planification et la restructuration de sites web. Elle guide l'agent dans la collecte du contexte métier, l'évaluation de l'état actuel du site, et le choix d'une structure de navigation adaptée (plate, modérée ou profonde) selon le type de site (SaaS, e-commerce, documentation, etc.). L'agent produit des livrables concrets : hiérarchie de pages au format ASCII, sitemap visuel en Mermaid, tableau de correspondance URL, spécifications de navigation et stratégie de maillage interne. Elle inclut aussi des règles pratiques comme la règle des 3 clics, les bonnes pratiques d'URL (lisibles, avec traits d'union, reflétant la hiérarchie) et un checklist d'audit de liens. Cette compétence est utile pour tout projet de refonte ou de création de site nécessitant une structure claire, intuitive et optimisée pour le référencement.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coreyhaines31/marketingskills/tree/main/skills/site-architecture

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Architecture de Site

Vous êtes un expert en architecture de l'information. Votre objectif est d'aider à planifier la structure d'un site web — hiérarchie des pages, navigation, modèles d'URL et maillage interne — afin que le site soit intuitif pour les utilisateurs et optimisé pour les moteurs de recherche.

Avant de Planifier

Vérifiez d'abord le contexte marketing produit : Si .agents/product-marketing.md existe (ou .claude/product-marketing.md, ou l'ancien fichier product-marketing-context.md, dans des configurations plus anciennes), lisez-le avant de poser des questions. Utilisez ce contexte et ne demandez que les informations non encore couvertes ou spécifiques à cette tâche.

Rassemblez ce contexte (demandez s'il n'est pas fourni) :

1. Contexte Métier

  • Que fait l'entreprise ?
  • Quels sont les publics principaux ?
  • Quels sont les 3 objectifs principaux du site ? (conversions, trafic SEO, éducation, support)

2. État Actuel

  • Nouveau site ou restructuration d'un site existant ?
  • Si restructuration : qu'est-ce qui ne va pas ? (taux de rebond élevé, mauvais SEO, les utilisateurs ne trouvent pas les choses)
  • Y a-t-il des URL existantes qui doivent être conservées (pour les redirections) ?

3. Type de Site

  • Site marketing SaaS
  • Site de contenu / blog
  • E-commerce
  • Documentation
  • Hybride (SaaS + contenu)
  • Petite entreprise / locale

4. Inventaire de Contenu

  • Combien de pages existent ou sont prévues ?
  • Quelles sont les pages les plus importantes ? (par trafic, conversions ou valeur métier)
  • Y a-t-il des sections ou extensions prévues ?

Types de Sites et Points de Départ

Type de SiteProfondeur TypiqueSections ClésModèle d'URL
Marketing SaaS2-3 niveauxAccueil, Fonctionnalités, Tarifs, Blog, Docs/fonctionnalites/nom, /blog/slug
Contenu / blog2-3 niveauxAccueil, Blog, Catégories, À propos/blog/slug, /categorie/slug
E-commerce3-4 niveauxAccueil, Catégories, Produits, Panier/categorie/sous-categorie/produit
Documentation3-4 niveauxAccueil, Guides, Référence API/docs/section/page
Hybride SaaS+contenu3-4 niveauxAccueil, Produit, Blog, Ressources, Docs/produit/fonctionnalite, /blog/slug
Petite entreprise1-2 niveauxAccueil, Services, À propos, Contact/services/nom

Pour les modèles complets de hiérarchie de pages : Voir references/site-type-templates.md


Conception de la Hiérarchie des Pages

La Règle des 3 Clics

Les utilisateurs devraient pouvoir atteindre n'importe quelle page importante en 3 clics ou moins depuis la page d'accueil. Ce n'est pas absolu, mais si les pages critiques sont enterrées à 4 niveaux ou plus, quelque chose ne va pas.

Hiérarchie Plate vs Profonde

ApprocheMeilleur PourCompromis
Plate (2 niveaux)Petits sites, portfoliosSimple mais ne passe pas à l'échelle
Modérée (3 niveaux)La plupart des SaaS, sites de contenuBon équilibre entre profondeur et trouvabilité
Profonde (4+ niveaux)E-commerce, grandes documentationsPasse à l'échelle mais risque d'enterrer le contenu

Règle générale : Allez aussi plat que possible tout en gardant la navigation propre. Si un menu déroulant a 20+ éléments, ajoutez un niveau de hiérarchie.

Niveaux de Hiérarchie

NiveauCe que c'estExemple
N0Page d'accueil/
N1Sections principales/fonctionnalites, /blog, /tarifs
N2Pages de section/fonctionnalites/analytique, /blog/guide-seo
N3+Pages de détail/docs/api/authentification

Format ASCII en Arbre

Utilisez ce format pour les hiérarchies de pages :

Page d'accueil (/)
├── Fonctionnalités (/fonctionnalites)
│   ├── Analytique (/fonctionnalites/analytique)
│   ├── Automatisation (/fonctionnalites/automatisation)
│   └── Intégrations (/fonctionnalites/integrations)
├── Tarifs (/tarifs)
├── Blog (/blog)
│   ├── [Catégorie : SEO] (/blog/categorie/seo)
│   └── [Catégorie : CRO] (/blog/categorie/cro)
├── Ressources (/ressources)
│   ├── Études de Cas (/ressources/etudes-de-cas)
│   └── Modèles (/ressources/modeles)
├── Docs (/docs)
│   ├── Démarrage (/docs/demarrage)
│   └── Référence API (/docs/api)
├── À propos (/a-propos)
│   └── Carrières (/a-propos/carrieres)
└── Contact (/contact)

Quand utiliser ASCII vs Mermaid :

  • ASCII : brouillons rapides de hiérarchie, contextes textuels uniquement, structures simples
  • Mermaid : présentations visuelles, relations complexes, zones de navigation ou modèles de liaison

Conception de la Navigation

Types de Navigation

Type de NavigationObjectifEmplacement
En-têteNavigation principale, toujours visibleHaut de chaque page
Menus déroulantsOrganiser les sous-pages sous la page parentSe déploie depuis les éléments de l'en-tête
Pied de pageLiens secondaires, légaux, plan du siteBas de chaque page
Barre latéraleNavigation de section (docs, blog)À gauche dans une section
Fil d'ArianeAfficher la position actuelle dans la hiérarchieSous l'en-tête, au-dessus du contenu
Liens contextuelsContenu connexe, étapes suivantesDans le contenu de la page

Règles de Navigation en En-tête

  • 4-7 éléments maximum dans la navigation principale (plus provoque une paralysie décisionnelle)
  • Bouton CTA tout à droite (par exemple, "Essai gratuit", "Commencer")
  • Logo lié à la page d'accueil (à gauche)
  • Ordre par priorité : pages les plus importantes/visitées en premier
  • Si vous avez un méga-menu, limitez-le à 3-4 colonnes

Organisation du Pied de Page

Regroupez les liens du pied de page en colonnes :

  • Produit : Fonctionnalités, Tarifs, Intégrations, Journal des modifications
  • Ressources : Blog, Études de Cas, Modèles, Docs
  • Entreprise : À propos, Carrières, Contact, Presse
  • Légal : Confidentialité, Conditions, Sécurité

Format du Fil d'Ariane

Accueil > Fonctionnalités > Analytique
Accueil > Blog > Catégorie SEO > Titre de l'article

Les fils d'Ariane doivent refléter la hiérarchie des URL. Chaque segment du fil d'Ariane doit être un lien cliquable, sauf la page actuelle.

Pour des modèles de navigation détaillés : Voir references/navigation-patterns.md


Structure des URL

Principes de Conception

  1. Lisibles par les humains — /fonctionnalites/analytique pas /f/a123
  2. Tirets, pas de tirets bas — /blog/guide-seo pas /blog/guide_seo
  3. Reflètent la hiérarchie — Le chemin d'URL doit correspondre à la structure du site
  4. Politique de slash final cohérente — choisissez-en une (avec ou sans) et appliquez-la
  5. Toujours en minuscules — /A-propos doit rediriger vers /a-propos
  6. Court mais descriptif — /blog/comment-ameliorer-taux-conversion-page-datterrissage est trop long ; /blog/taux-conversion-page-datterrissage est mieux

Modèles d'URL par Type de Page

Type de PageModèleExemple
Page d'accueil/exemple.fr
Page de fonctionnalité/fonctionnalites/{nom}/fonctionnalites/analytique
Tarifs/tarifs/tarifs
Article de blog/blog/{slug}/blog/guide-seo
Catégorie de blog/blog/categorie/{slug}/blog/categorie/seo
Étude de cas/clients/{slug}/clients/acme-corp
Documentation/docs/{section}/{page}/docs/api/authentification
Légal/{page}/confidentialite, /conditions
Page d'atterrissage/{slug} ou /lp/{slug}/essai-gratuit, /lp/webinaire
Comparaison/comparer/{concurrent} ou /vs/{concurrent}/comparer/nom-concurrent
Intégration/integrations/{nom}/integrations/slack
Modèle/modeles/{slug}/modeles/plan-marketing

Erreurs Courantes

  • Dates dans les URL de blog — /blog/2024/01/15/titre-article n'ajoute aucune valeur et rend les URL longues. Utilisez /blog/titre-article.
  • Sur-nichage — /produits/categorie/sous-categorie/article/detail est trop profond. Aplatissez si possible.
  • Modifier les URL sans redirections — Chaque ancienne URL a besoin d'une redirection 301 vers sa nouvelle URL. Sans elles, vous perdez la valeur des backlinks et créez des pages cassées pour quiconque a l'ancienne URL en favori ou liée.
  • Identifiants dans les URL — /produit/12345 n'est pas lisible par les humains. Utilisez des slugs.
  • Paramètres de requête pour le contenu — /blog?id=123 devrait être /blog/titre-article.
  • Modèles incohérents — Ne mélangez pas /fonctionnalites/analytique et /produit/automatisation. Choisissez un parent.

Alignement Fil d'Ariane-URL

Le fil d'Ariane doit refléter le chemin d'URL :

URLFil d'Ariane
/fonctionnalites/analytiqueAccueil > Fonctionnalités > Analytique
/blog/guide-seoAccueil > Blog > Guide SEO
/docs/api/authAccueil > Docs > API > Authentification

Sortie de Sitemap Visuel (Mermaid)

Utilisez graph TD de Mermaid pour les sitemaps visuels. Cela rend les relations hiérarchiques claires et peut annoter les zones de navigation.

Hiérarchie de Base

graph TD
    ACC[Page d'accueil] --> FONC[Fonctionnalités]
    ACC --> TARIF[Tarifs]
    ACC --> BLOG[Blog]
    ACC --> APROPOS[À propos]

    FONC --> F1[Analytique]
    FONC --> F2[Automatisation]
    FONC --> F3[Intégrations]

    BLOG --> B1[Article 1]
    BLOG --> B2[Article 2]

Avec Zones de Navigation

graph TD
    subgraph Navigation En-tête
        ACC[Page d'accueil]
        FONC[Fonctionnalités]
        TARIF[Tarifs]
        BLOG[Blog]
        CTA[Commencer]
    end

    subgraph Navigation Pied de page
        APROPOS[À propos]
        CARRIERES[Carrières]
        CONTACT[Contact]
        CONFIDENTIALITE[Confidentialité]
    end

    ACC --> FONC
    ACC --> TARIF
    ACC --> BLOG
    ACC --> APROPOS

    FONC --> F1[Analytique]
    FONC --> F2[Automatisation]

Pour plus de modèles Mermaid : Voir references/mermaid-templates.md


Stratégie de Maillage Interne

Types de Liens

TypeObjectifExemple
NavigationSe déplacer entre les sectionsLiens d'en-tête, pied de page, barre latérale
ContextuelContenu connexe dans le texte"En savoir plus sur l'analytique"
Hub-and-spokeConnecter le contenu d'un cluster à son hubArticles de blog liés à la page pilier
Inter-sectionConnecter des pages connexes entre sectionsPage de fonctionnalité liée à une étude de cas connexe

Règles de Maillage Interne

  1. Pas de pages orphelines — chaque page doit avoir au moins un lien interne pointant vers elle
  2. Texte d'ancrage descriptif — "nos fonctionnalités d'analytique" pas "cliquez ici"
  3. 5-10 liens internes par 1000 mots de contenu (directive approximative)
  4. Liez plus souvent les pages importantes — page d'accueil, pages de fonctionnalités clés, tarifs
  5. Utilisez les fils d'Ariane — liens internes gratuits sur chaque page
  6. Sections de contenu connexe — "Articles connexes" ou "Vous pourriez aussi aimer" en bas de page

Modèle Hub-and-Spoke

Pour les sites riches en contenu, organisez autour de pages hubs :

Hub : /blog/guide-seo (aperçu complet)
├── Spoke : /blog/recherche-mots-cles (liens vers le hub)
├── Spoke : /blog/seo-on-page (liens vers le hub)
├── Spoke : /blog/seo-technique (liens vers le hub)
└── Spoke : /blog/netlinking (liens vers le hub)

Chaque spoke renvoie vers le hub. Le hub renvoie vers tous les spokes. Les spokes renvoient entre eux le cas échéant.

Checklist d'Audit de Liens

  • Chaque page a au moins un lien interne entrant
  • Aucun lien interne cassé (404)
  • Le texte d'ancrage est descriptif (pas "cliquez ici" ou "lire plus")
  • Les pages importantes ont le plus de liens internes entrants
  • Les fils d'Ariane sont implémentés sur toutes les pages
  • Des liens vers du contenu connexe existent sur les articles de blog
  • Les liens inter-sections connectent les fonctionnalités aux études de cas, le blog aux pages produit

Format de Sortie

Lors de la création d'un plan d'architecture de site, fournissez ces livrables :

1. Hiérarchie des Pages (Arbre ASCII)

Structure complète du site avec URL à chaque nœud. Utilisez le format d'arbre ASCII de la section Conception de la Hiérarchie des Pages.

2. Sitemap Visuel (Mermaid)

Diagramme Mermaid montrant les relations entre les pages et les zones de navigation. Utilisez graph TD avec des sous-graphes pour les zones de navigation si utile.

3. Tableau de Correspondance des URL

PageURLParentEmplacement dans la Nav.Priorité
Page d'accueil/—En-têteHaute
Fonctionnalités/fonctionnalitesPage d'accueilEn-têteHaute
Analytique/fonctionnalites/analytiqueFonctionnalitésMenu déroulant en-têteMoyenne
Tarifs/tarifsPage d'accueilEn-têteHaute
Blog/blogPage d'accueilEn-têteMoyenne

4. Spécifications de Navigation

  • Éléments de la navigation en en-tête (ordonnés, avec CTA)
  • Sections et liens du pied de page
  • Navigation en barre latérale (si applicable)
  • Notes sur l'implémentation du fil d'Ariane

5. Plan de Maillage Interne

  • Pages hubs et leurs spokes
  • Opportunités de liens inter-sections
  • Audit des pages orphelines (si restructuration)
  • Liens recommandés par page clé

Questions Spécifiques à la Tâche

  1. S'agit-il d'un nouveau site ou restructurez-vous un site existant ?
  2. De quel type de site s'agit-il ? (SaaS, contenu, e-commerce, docs, hybride, petite entreprise)
  3. Combien de pages existent ou sont prévues ?
  4. Quelles sont les 5 pages les plus importantes du site ?
  5. Y a-t-il des URL existantes qui doivent être conservées ou redirigées ?
  6. Quels sont les publics principaux, et qu'essayent-ils d'accomplir sur le site ?

Compétences Connexes

  • strategie-de-contenu : Pour planifier le contenu à créer et les clusters thématiques
  • seo-programmatique : Pour créer des pages SEO à grande échelle avec des modèles et des données
  • audit-seo : Pour le SEO technique, l'optimisation on-page et les problèmes d'indexation
  • cro : Pour optimiser les pages individuelles pour la conversion
  • schema : Pour implémenter les données structurées de fil d'Ariane et de navigation de site
  • concurrents : Pour les frameworks de pages de comparaison et les modèles d'URL

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ab-testing

When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions

ads

When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions

ai-seo

When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers. Also use when the user mentions

analytics

When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions

aso

When the user wants to audit or optimize an App Store or Google Play listing. Also use when the user mentions

attribution

When the user wants to figure out which marketing actually drives conversions and revenue, choose or interpret an attribution model, or reconcile conflicting numbers across tools. Also use when the user mentions

churn-prevention

When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies. Also use when the user mentions

cold-email

Write B2B cold emails and follow-up sequences that get replies. Use when the user wants to write cold outreach emails, prospecting emails, cold email campaigns, sales development emails, or SDR emails. Also use when the user mentions

co-marketing

When the user wants to find co-marketing partners, plan joint campaigns, or brainstorm partnership opportunities. Use when the user says

community-marketing

Build and leverage online communities to drive product growth and brand loyalty. Use when the user wants to create a community strategy, grow a Discord or Slack community, manage a forum or subreddit, build brand advocates, increase word-of-mouth, drive community-led growth, engage users post-signup, or turn customers into evangelists. Trigger phrases: \

competitor-profiling

When the user wants to research, profile, or analyze competitors from their URLs. Also use when the user mentions

competitors

When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions

content-strategy

When the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions

copy-editing

When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions

copywriting

When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says

coreyhaines31/ab-test-setup

When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "should I test this," "which version is better," "test two versions," "statistical significance," "how long should I run this test," "growth experiments," "experiment velocity," "experiment backlog," "ICE score," "experimentation program," or "experiment playbook." Use this whenever someone is comparing two approaches and wants to measure which performs better, or when they want to build a systematic experimentation practice. For tracking implementation, see analytics-tracking. For page-level conversion optimization, see page-cro.

coreyhaines31/analytics-tracking

When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions "set up tracking," "GA4," "Google Analytics," "conversion tracking," "event tracking," "UTM parameters," "tag manager," "GTM," "analytics implementation," "tracking plan," "how do I measure this," "track conversions," "attribution," "Mixpanel," "Segment," "are my events firing," or "analytics isn't working." Use this whenever someone asks how to know if something is working or wants to measure marketing results. For A/B test measurement, see ab-test-setup.

coreyhaines31/aso-audit

When the user wants to audit or optimize an App Store or Google Play listing. Also use when the user mentions 'ASO audit,' 'app store optimization,' 'optimize my app listing,' 'improve app visibility,' 'app store ranking,' 'audit my listing,' 'why aren't people downloading my app,' 'improve my app conversion,' 'keyword optimization for app,' or 'compare my app to competitors.' Use when the user shares an App Store or Google Play URL and wants to improve it.

coreyhaines31/competitor-alternatives

When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'battle card,' or 'competitor teardown.' Use this for any content that positions your product against competitors. Covers four formats: singular alternative, plural alternatives, you vs competitor, and competitor vs competitor. For sales-specific competitor docs, see sales-enablement.

coreyhaines31/email-sequence

When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," "lifecycle emails," "trigger-based emails," "email funnel," "email workflow," "what emails should I send," "welcome series," or "email cadence." Use this for any multi-email automated flow. For cold outreach emails, see cold-email. For in-app onboarding, see onboarding-cro.

Skills associés