information-architecture

$npx mdskill add rampstackco/claude-skills/information-architecture

Design the structure of a website or product including sitemap, navigation, URL structure, content types, taxonomy, and labeling.

  • Plan sitemaps, navigation, URL structures, content types, taxonomies, and labeling.
  • No external tools or APIs required; uses IA principles and best practices.
  • Analyzes user goals, content inventory, and existing structure to recommend optimal organization.
  • Delivers structured plans, sitemaps, navigation designs, and taxonomy definitions.

SKILL.md

.github/skills/information-architectureView on GitHub ↗
---
name: information-architecture
description: "Design the structure of a website or product including sitemap, navigation, URL structure, content types, taxonomy, and labeling. Use this skill whenever the user asks to plan a sitemap, design navigation, structure URLs, define content types, build taxonomies, design site search, or organize content at the system level. Triggers on sitemap, site structure, navigation, IA, information architecture, URL structure, content types, taxonomy, categorization, breadcrumbs, hub pages, faceted navigation, site search, labeling. Also triggers when content is being created without a structural plan, or when an existing site's structure is being audited or restructured."
category: strategy-and-discovery
catalog_summary: "Sitemap, navigation, URL structure, content types, taxonomy"
display_order: 4
---

# Information Architecture

Design the structure that holds the content. Stack-agnostic. Applies to marketing sites, product surfaces, knowledge bases, e-commerce, and editorial content.

A well-designed IA makes the rest of the project easier. A poorly-designed IA forces every downstream decision to fight the structure.

---

## When to use

- Designing a new site or major section from scratch
- Restructuring an existing site
- Adding a new content type or category
- Designing site navigation or menu systems
- Defining URL structure and slug patterns
- Building taxonomies or tag systems
- Auditing an existing IA for problems

## When NOT to use

- Single-page design (use `design-standards`)
- Content production (use `content-and-copy`)
- SEO-driven content planning (use `seo-keyword`)
- Initial brand and audience discovery (use `brand-discovery`)

---

## Required inputs

- The site or product scope
- The audience and what they're trying to do
- The content that exists or is planned
- Any constraints (parent IA, regulatory, technical)

If audience is unclear, run `brand-discovery` first. If content scope is unclear, run `content-strategy` first.

---

## The framework: 6 layers

Information architecture has six layers. Each builds on the one below.

### 1. Mental models

Before structure, understand how the audience thinks about the domain.

- What concepts do they group together naturally?
- What words do they use? (Often different from what the company uses.)
- What is the dominant frame of reference? (By task? By role? By topic? By time?)
- What do they expect to find where, based on conventions in similar products?

**Methods:**

- **Card sorting** (open or closed): Give the audience the content items, ask them to group them. Open card sorts surface natural groupings. Closed card sorts validate proposed groupings.
- **Tree testing:** Give a proposed structure, ask users to find specific items. Surfaces where the structure breaks down.
- **First-click testing:** Given a goal, where do users click first? If first clicks are wrong, the labels and structure are wrong.

### 2. Sitemap

The map of all pages and how they relate.

**Sitemap deliverables:**

- A hierarchy diagram showing parent-child relationships
- Indication of page types (static, dynamic, listing, detail)
- Cross-references showing how pages relate beyond the hierarchy
- Sometimes a separate user-flow overlay for key journeys

**Sitemap types:**

- **Hub-and-spoke** (cornerstone content + supporting content): Common for content marketing
- **Tree** (strict hierarchy, every page has one parent): Common for product documentation
- **Faceted** (content lives in many overlapping categories): Common for e-commerce
- **Flat** (everything reachable from the home): Common for small sites

Most sites blend types. Pick the dominant pattern and document the exceptions.

### 3. URL structure

URLs are part of the IA. They are user-facing, indexed by search engines, and shape how content is referenced.

**URL principles:**

- Reflect the content hierarchy
- Lowercase, hyphen-separated
- Predictable (same pattern across same content type)
- Stable (URLs don't change without redirects)
- Short (under 60 characters where possible)
- Descriptive (slug indicates the content)
- Free of dates unless time-bound
- Free of session IDs and tracking parameters in canonical form

**Common patterns:**

```
/                                   home
/[section]                          section landing
/[section]/[subsection]             subsection landing
/[section]/[subsection]/[item]      detail page
/blog                               blog index
/blog/[slug]                        blog post
/blog/category/[category]           category index
/blog/tag/[tag]                     tag index
/products                           product catalog
/products/[category]                category page
/products/[category]/[product]      product detail
```

Pick a pattern and stick to it. Inconsistent URL patterns confuse users, crawlers, and analytics.

### 4. Navigation

The chrome that gets users where they need to go.

**Primary navigation:**

- The top-level structure of the site
- Should reflect what the audience cares about, not what the org chart looks like
- 5 to 7 items maximum (more becomes cognitively heavy)
- Each label is recognizable in 2 to 3 words
- Order matters (left/first gets the most attention)

**Secondary navigation:**

- Within-section navigation
- Often shown as sidebars, sub-menus, or in-page tabs
- Supports the primary nav, doesn't duplicate it

**Utility navigation:**

- Account, search, login, support
- Visually subordinate to primary nav
- Often top-right (LTR languages)

**Breadcrumbs:**

- For nested hierarchies (3+ levels deep)
- Always linked except the current page
- Match the URL hierarchy or the conceptual hierarchy
- Marked up with BreadcrumbList schema

**Footer navigation:**

- Comprehensive; sometimes includes everything
- Organized by category for findability
- Includes secondary content (privacy, terms, contact)

### 5. Taxonomy and metadata

The classification system applied to content.

**Categories:**

- A small, controlled list (typically 5 to 15)
- Mutually exclusive ideal (one item, one category)
- Used for structural navigation

**Tags:**

- A larger, often growing list (50+)
- Multi-assignment (one item, many tags)
- Used for cross-cutting connections, related-content, and long-tail discovery

**Metadata fields:**

- Author, date, content type, audience segment
- Whatever is useful for filtering, sorting, and surfacing

**Common failures:**

- Categories that overlap (item could go in 3 different categories)
- Tags that are unmaintained (sprawl into thousands, become useless)
- Metadata fields that get filled inconsistently
- Different content types using different taxonomies for the same thing (chaos)

### 6. Labeling

What you call things.

**Label principles:**

- Audience language, not internal language
- Specific enough to be useful, short enough to scan
- Consistent across the site (call it "Product" or "Solutions" but not both)
- Tested with real users (closed card sort or tree test surfaces label problems)

**Common label problems:**

- "Solutions" (vague; usually means "products with marketing copy")
- "Resources" (catch-all; everything ends up there)
- Internal jargon ("PRD," "OKRs") that doesn't match user vocabulary
- Labels that change meaning across the site

---

## Workflow

1. **Understand the audience and content.** Use existing discovery and content strategy if available.
2. **Card sort or interview** to surface mental models.
3. **Draft the sitemap.** Hierarchy, page types, cross-references.
4. **Define URL patterns.** One pattern per content type.
5. **Design navigation.** Primary, secondary, utility, footer, breadcrumbs.
6. **Build taxonomy.** Categories (controlled, small) and tags (open, large).
7. **Validate labels.** Tree test or closed card sort with target users.
8. **Document.** Use the template in [`references/ia-document-template.md`](references/ia-document-template.md).
9. **Hand off to design and development.** IA decisions inform navigation components, URL routing, and taxonomy implementation.

---

## Failure patterns

- **IA designed by org chart.** "Engineering" and "Marketing" sections make sense to the company, not to the audience.
- **Categories that proliferate.** Every team adds a category for their thing. Becomes unscannable. Hold the line at 5 to 15.
- **Tags that sprawl.** No tag governance. Tags become a junk drawer.
- **Inconsistent URL patterns.** Some posts at /blog/[slug], some at /[slug], some at /articles/[slug]. Pick one.
- **Navigation that hides primary content.** The most important pages should be one click from home.
- **Search as a substitute for IA.** "Just use search" is not a structure. Search supports IA, doesn't replace it.
- **No validation.** Card sorts, tree tests, and first-click tests are cheap and surface huge problems early.
- **Treating IA as a one-time deliverable.** IA evolves with content. Plan for evolution.

---

## Output format

Default output is an IA document at `information-architecture.md` plus visual assets:

1. Executive summary
2. Audience and mental models (synthesized)
3. Sitemap (hierarchical diagram)
4. URL structure (per content type)
5. Navigation specification (primary, secondary, utility, footer, breadcrumbs)
6. Taxonomy (categories and tag governance)
7. Labels (validated wording for navigation, categories, content types)
8. Implementation notes for design and development

Visual deliverables:
- Sitemap diagram (Whimsical, Figma, OmniGraffle, etc.)
- Navigation wireframes for primary surfaces
- Optional: card sort and tree test results

---

## Reference files

- [`references/ia-document-template.md`](references/ia-document-template.md) - Template for the IA deliverable.
- [`references/url-pattern-library.md`](references/url-pattern-library.md) - URL pattern conventions for common content types.

More from rampstackco/claude-skills

SkillDescription
ads-creative-developmentHow to produce ad creative that converts at performance scale. Hook patterns, format selection, video pacing, variation systems, sequential testing methodology, fatigue detection, brand-voice alignment without conversion dilution, and platform-specific creative norms. Triggers on ad creative, ad design, hook patterns, ad video pacing, creative testing, ad variations, creative refresh, creative fatigue, refresh ad creative, video ads for Meta, TikTok creative, LinkedIn ad creative, ad asset library. Also triggers when a team is producing creative at scale, planning a creative test cycle, or auditing why creative is not converting.
ads-performance-analyticsHow to read paid media dashboards without fooling yourself. Attribution models, platform reporting quirks, multi-platform reconciliation, ROAS vs LTV horizon traps, statistical noise in performance metrics, incrementality testing, and the failure modes that produce expensive lessons. Triggers on read paid media dashboard, attribution analysis, ROAS vs LTV, multi-platform reconciliation, ad incrementality, geo holdout, conversion lift study, ghost bidding, paid media reporting, board-deck paid media metrics, blended CAC, MMM, MTA, last-click attribution. Also triggers when a marketer is about to scale, kill, or rebudget a campaign based on platform metrics, or when reconciling platform reports against warehouse revenue.
after-action-reportRun a structured after-action review (postmortem, retrospective) on a launch, incident, or completed project to capture timeline, root cause analysis, contributing factors, and actionable lessons. Use this skill whenever the user wants to run a postmortem, retrospective, AAR, or after-action review on any past event. Triggers on after-action report, AAR, postmortem, retrospective, retro, post-incident review, what went well what didn't, lessons learned, blameless postmortem, root cause analysis, RCA, five whys. Also triggers when the user has just shipped something or just resolved an incident and wants to capture learnings.
ai-content-collaborationHow humans and AI compose in content workflows. Where AI legitimately participates, where humans must own, hybrid workflow patterns, voice ownership preservation, the AI slop problem, disclosure and transparency, team calibration, and the ethics of intellectually honest AI-assisted content production. Triggers on AI content workflow, AI-assisted writing, hybrid content production, AI in editorial, AI slop, AI disclosure, AI usage policy, AI content ethics, voice preservation with AI, team AI calibration. Also triggers when content feels generic despite quality tools, when team AI usage has drifted into inconsistency, or when a regulated or trust-sensitive context requires explicit AI policy.
analytics-strategyDesign measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy. Use this skill whenever the user wants to plan analytics, design dashboards, build event taxonomies, define KPIs, set up tracking, or audit existing measurement. Triggers on analytics strategy, measurement plan, event taxonomy, tracking plan, KPI framework, dashboard design, north star metric, attribution model, conversion tracking, GA4 setup, Mixpanel setup, analytics audit. Also triggers when the user has data but no clear way to use it, or wants to make decisions but doesn't know what to track.
art-directionDirect visual and creative work for campaigns, photography, illustration, video, and branded experiences. Use this skill whenever the user wants to brief a photographer, direct illustrators, plan a creative campaign, develop visual concepts, write a creative direction document, or evaluate creative work for fit. Triggers on art direction, photo brief, photography brief, illustration brief, campaign concept, creative concept, visual direction, mood board, look and feel, visual treatment, video direction. Also triggers when the user has approved brand identity but needs to extend it into specific creative deliverables.
backup-and-disaster-recoveryPlan and run backups, set recovery objectives, and run disaster recovery drills. Use this skill when defining RPO/RTO targets, designing backup architecture, deciding what to back up and how often, planning for full-region or platform outages, or running a restoration drill. Triggers on backup, restore, RPO, RTO, disaster recovery, DR, business continuity, what if the database is gone, what if our hosting goes down, recovery drill, ransomware planning. Also triggers when an incident reveals a gap in restoration capability.
beta-program-managementRunning closed and open betas that produce real signal. Beta participant selection, structured feedback collection, beta-to-GA decision criteria, and the difference between soft-launch (no structure, no signal), kitchen-sink (everyone in, no actionable feedback), and structured beta (calibrated cohort, intentional feedback loops, clear graduation criteria). Triggers on beta program, alpha test, beta cohort, beta participant, beta feedback, beta to GA decision, design partner, early access program, closed beta, open beta, RC release. Also triggers when a feature is approaching launch and the team needs structured pre-GA validation, when prior betas produced noise rather than signal, or when the team has soft-launched before but wants more structured feedback this time.
brand-archetype-systemApply pre-composed aesthetic archetype defaults to jumpstart brand design work covering color, typography, layout, voice, and imagery direction. Use this skill whenever the user wants a starting point for brand visual and verbal direction, references a brand they want to design near (for example 'something like Stripe' or 'editorial like Linear'), needs to converge faster from many directions to one, or wants known-good defaults for a specific industry vertical. Triggers on archetype, design archetype, brand archetype, near to (brand), in the style of, similar aesthetic, design starting point, brand template, vertical-typical, industry-typical. Also triggers when the user has a brief and wants to map it to a known aesthetic family rather than design from first principles.
brand-discoveryRun upstream brand discovery covering audience research, competitive landscape, category dynamics, problem space, and positioning territory exploration. Use this skill at the very start of a brand or website project when the user needs to understand who they're for, who they compete with, what the audience actually needs, and where the brand could plausibly stand. Triggers on brand discovery, audience research, market research, competitive scan, category research, customer research, who is this for, who are we, positioning research, intake, kickoff. Also triggers when a creative brief is requested but the upstream inputs (audience, competitors, problem space) are not yet clear.