Information architecture

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

Information architecture — Creative Direction skill highlight diagram. Navy header card reads 'Impactful Creative Direction' with the subtitle… (from the rampstackco/claude-skills README)

From the rampstackco/claude-skills README — shows the whole collection, not only this skill. · view on GitHub

How to use it

Claude Code
  1. Run the line below. It pulls the whole folder into ~/.claude/skills/information-architecture, including the files SKILL.md points to.
  2. Describe your job in plain words. Claude Code follows the skill from there.
Claude Code — installs the whole folder, not just SKILL.md
npx degit rampstackco/claude-skills/skills/information-architecture#main ~/.claude/skills/information-architecture

For one project only, change the path to .claude/skills/information-architecture. This skill also uses information-architecture.md — copying SKILL.md alone won't be enough. See the folder on GitHub.

Claude (web or desktop app)
  1. On this page open ⋯ → Download .md.
  2. Save it as SKILL.md in a folder, zip the folder, then Customize → Skills → + → Create skill → Upload a skill.
  3. Pick the file and Save. Claude shows the name and description and runs a security scan.
  4. Check the skill is switched on.
  5. Start a new chat and describe your job in plain words. The AI follows the skill from there.
ChatGPT or another app
  1. ChatGPT: make a Project and paste it into Instructions.
  2. Neither? Paste it at the top of a new chat — it works for that chat.
Not working?
  • Check which app you pasted it into — the steps above name the right one.
  • Some skills need the paid tier of Claude or ChatGPT.
Step-by-step guide with screenshots · Ask in the forum

Paste into Claude, ChatGPT or Cursor.

Source of Information architecture

Show the full text261 lines
namedescriptioncategorycatalog_summarydisplay_order
information-architectureDesign 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.strategy-and-discoverySitemap, navigation, URL structure, content types, taxonomy4

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, or state the gap per the data-availability rule.
  8. Document. Use the template in 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

If required data is unavailable

This skill's output depends on data, measurements, or tool results it cannot generate on its own. When a required input, tool, or data source is unavailable or unverifiable, the sanctioned output is the deliverable with the gap stated: what was needed, what was actually obtained or verified, and which parts of the output are affected. Fabricating, estimating, or interpolating a required number to complete the deliverable is never sanctioned. A stated gap is a complete answer.


Reference files

1---
2name: information-architecture
3description: "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."
4category: strategy-and-discovery
5catalog_summary: "Sitemap, navigation, URL structure, content types, taxonomy"
6display_order: 4
7---
8 
9# Information Architecture
10 
11Design the structure that holds the content. Stack-agnostic. Applies to marketing sites, product surfaces, knowledge bases, e-commerce, and editorial content.
12 
13A well-designed IA makes the rest of the project easier. A poorly-designed IA forces every downstream decision to fight the structure.
14 
15---
16 
17## When to use
18 
19- Designing a new site or major section from scratch
20- Restructuring an existing site
21- Adding a new content type or category
22- Designing site navigation or menu systems
23- Defining URL structure and slug patterns
24- Building taxonomies or tag systems
25- Auditing an existing IA for problems
26 
27## When NOT to use
28 
29- Single-page design (use `design-standards`)
30- Content production (use `content-and-copy`)
31- SEO-driven content planning (use `seo-keyword`)
32- Initial brand and audience discovery (use `brand-discovery`)
33 
34---
35 
36## Required inputs
37 
38- The site or product scope
39- The audience and what they're trying to do
40- The content that exists or is planned
41- Any constraints (parent IA, regulatory, technical)
42 
43If audience is unclear, run `brand-discovery` first. If content scope is unclear, run `content-strategy` first.
44 
45---
46 
47## The framework: 6 layers
48 
49Information architecture has six layers. Each builds on the one below.
50 
51### 1. Mental models
52 
53Before structure, understand how the audience thinks about the domain.
54 
55- What concepts do they group together naturally?
56- What words do they use? (Often different from what the company uses.)
57- What is the dominant frame of reference? (By task? By role? By topic? By time?)
58- What do they expect to find where, based on conventions in similar products?
59 
60**Methods:**
61 
62- **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.
63- **Tree testing:** Give a proposed structure, ask users to find specific items. Surfaces where the structure breaks down.
64- **First-click testing:** Given a goal, where do users click first? If first clicks are wrong, the labels and structure are wrong.
65 
66### 2. Sitemap
67 
68The map of all pages and how they relate.
69 
70**Sitemap deliverables:**
71 
72- A hierarchy diagram showing parent-child relationships
73- Indication of page types (static, dynamic, listing, detail)
74- Cross-references showing how pages relate beyond the hierarchy
75- Sometimes a separate user-flow overlay for key journeys
76 
77**Sitemap types:**
78 
79- **Hub-and-spoke** (cornerstone content + supporting content): Common for content marketing
80- **Tree** (strict hierarchy, every page has one parent): Common for product documentation
81- **Faceted** (content lives in many overlapping categories): Common for e-commerce
82- **Flat** (everything reachable from the home): Common for small sites
83 
84Most sites blend types. Pick the dominant pattern and document the exceptions.
85 
86### 3. URL structure
87 
88URLs are part of the IA. They are user-facing, indexed by search engines, and shape how content is referenced.
89 
90**URL principles:**
91 
92- Reflect the content hierarchy
93- Lowercase, hyphen-separated
94- Predictable (same pattern across same content type)
95- Stable (URLs don't change without redirects)
96- Short (under 60 characters where possible)
97- Descriptive (slug indicates the content)
98- Free of dates unless time-bound
99- Free of session IDs and tracking parameters in canonical form
100 
101**Common patterns:**
102 
103```
104/ home
105/[section] section landing
106/[section]/[subsection] subsection landing
107/[section]/[subsection]/[item] detail page
108/blog blog index
109/blog/[slug] blog post
110/blog/category/[category] category index
111/blog/tag/[tag] tag index
112/products product catalog
113/products/[category] category page
114/products/[category]/[product] product detail
115```
116 
117Pick a pattern and stick to it. Inconsistent URL patterns confuse users, crawlers, and analytics.
118 
119### 4. Navigation
120 
121The chrome that gets users where they need to go.
122 
123**Primary navigation:**
124 
125- The top-level structure of the site
126- Should reflect what the audience cares about, not what the org chart looks like
127- 5 to 7 items maximum (more becomes cognitively heavy)
128- Each label is recognizable in 2 to 3 words
129- Order matters (left/first gets the most attention)
130 
131**Secondary navigation:**
132 
133- Within-section navigation
134- Often shown as sidebars, sub-menus, or in-page tabs
135- Supports the primary nav, doesn't duplicate it
136 
137**Utility navigation:**
138 
139- Account, search, login, support
140- Visually subordinate to primary nav
141- Often top-right (LTR languages)
142 
143**Breadcrumbs:**
144 
145- For nested hierarchies (3+ levels deep)
146- Always linked except the current page
147- Match the URL hierarchy or the conceptual hierarchy
148- Marked up with BreadcrumbList schema
149 
150**Footer navigation:**
151 
152- Comprehensive; sometimes includes everything
153- Organized by category for findability
154- Includes secondary content (privacy, terms, contact)
155 
156### 5. Taxonomy and metadata
157 
158The classification system applied to content.
159 
160**Categories:**
161 
162- A small, controlled list (typically 5 to 15)
163- Mutually exclusive ideal (one item, one category)
164- Used for structural navigation
165 
166**Tags:**
167 
168- A larger, often growing list (50+)
169- Multi-assignment (one item, many tags)
170- Used for cross-cutting connections, related-content, and long-tail discovery
171 
172**Metadata fields:**
173 
174- Author, date, content type, audience segment
175- Whatever is useful for filtering, sorting, and surfacing
176 
177**Common failures:**
178 
179- Categories that overlap (item could go in 3 different categories)
180- Tags that are unmaintained (sprawl into thousands, become useless)
181- Metadata fields that get filled inconsistently
182- Different content types using different taxonomies for the same thing (chaos)
183 
184### 6. Labeling
185 
186What you call things.
187 
188**Label principles:**
189 
190- Audience language, not internal language
191- Specific enough to be useful, short enough to scan
192- Consistent across the site (call it "Product" or "Solutions" but not both)
193- Tested with real users (closed card sort or tree test surfaces label problems)
194 
195**Common label problems:**
196 
197- "Solutions" (vague; usually means "products with marketing copy")
198- "Resources" (catch-all; everything ends up there)
199- Internal jargon ("PRD," "OKRs") that doesn't match user vocabulary
200- Labels that change meaning across the site
201 
202---
203 
204## Workflow
205 
2061. **Understand the audience and content.** Use existing discovery and content strategy if available.
2072. **Card sort or interview** to surface mental models.
2083. **Draft the sitemap.** Hierarchy, page types, cross-references.
2094. **Define URL patterns.** One pattern per content type.
2105. **Design navigation.** Primary, secondary, utility, footer, breadcrumbs.
2116. **Build taxonomy.** Categories (controlled, small) and tags (open, large).
2127. **Validate labels.** Tree test or closed card sort with target users, or state the gap per the data-availability rule.
2138. **Document.** Use the template in [`references/ia-document-template.md`](references/ia-document-template.md).
2149. **Hand off to design and development.** IA decisions inform navigation components, URL routing, and taxonomy implementation.
215 
216---
217 
218## Failure patterns
219 
220- **IA designed by org chart.** "Engineering" and "Marketing" sections make sense to the company, not to the audience.
221- **Categories that proliferate.** Every team adds a category for their thing. Becomes unscannable. Hold the line at 5 to 15.
222- **Tags that sprawl.** No tag governance. Tags become a junk drawer.
223- **Inconsistent URL patterns.** Some posts at /blog/[slug], some at /[slug], some at /articles/[slug]. Pick one.
224- **Navigation that hides primary content.** The most important pages should be one click from home.
225- **Search as a substitute for IA.** "Just use search" is not a structure. Search supports IA, doesn't replace it.
226- **No validation.** Card sorts, tree tests, and first-click tests are cheap and surface huge problems early.
227- **Treating IA as a one-time deliverable.** IA evolves with content. Plan for evolution.
228 
229---
230 
231## Output format
232 
233Default output is an IA document at `information-architecture.md` plus visual assets:
234 
2351. Executive summary
2362. Audience and mental models (synthesized)
2373. Sitemap (hierarchical diagram)
2384. URL structure (per content type)
2395. Navigation specification (primary, secondary, utility, footer, breadcrumbs)
2406. Taxonomy (categories and tag governance)
2417. Labels (validated wording for navigation, categories, content types)
2428. Implementation notes for design and development
243 
244Visual deliverables:
245- Sitemap diagram (Whimsical, Figma, OmniGraffle, etc.)
246- Navigation wireframes for primary surfaces
247- Optional: card sort and tree test results
248 
249---
250 
251## If required data is unavailable
252 
253This skill's output depends on data, measurements, or tool results it cannot generate on its own. When a required input, tool, or data source is unavailable or unverifiable, the sanctioned output is the deliverable with the gap stated: what was needed, what was actually obtained or verified, and which parts of the output are affected. Fabricating, estimating, or interpolating a required number to complete the deliverable is never sanctioned. A stated gap is a complete answer.
254 
255---
256 
257## Reference files
258 
259- [`references/ia-document-template.md`](references/ia-document-template.md) - Template for the IA deliverable.
260- [`references/url-pattern-library.md`](references/url-pattern-library.md) - URL pattern conventions for common content types.
261 

Discussion

Alternatives

Also in SEO & keywordsSee all 364 in Marketing →