返回技能列表

information-architecture

rampstackco
更新于 2 days ago
4 次查看
239
27
239
在 GitHub 上查看
其他apidesign

关于

This skill helps developers design the structural foundation of a website or product, including sitemaps, navigation, URL schemes, and content taxonomies. It activates when planning, auditing, or restructuring system-level organization without a preset tech stack. Use it to establish a clear content framework before implementation begins.

快速安装

Claude Code

推荐
主要方式
npx skills add rampstackco/claude-skills -a claude-code
插件命令备选方式
/plugin add https://github.com/rampstackco/claude-skills
Git 克隆备选方式
git clone https://github.com/rampstackco/claude-skills.git ~/.claude/skills/information-architecture

在 Claude Code 中复制并粘贴此命令以安装该技能

技能文档

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.
  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

GitHub 仓库

rampstackco/claude-skills
路径: skills/information-architecture
0
agent-skillsai-agentsanthropicclaudeclaude-aiclaude-code

相关推荐技能

creative-direction

其他

该Skill通过引导用户定义四个美学轴向(语气、美学理念、受众关系、感官目标),生成一份结构化的美学指导简报。它专用于在项目需要跨多个细节决策保持美学一致性、而用户仅有模糊感觉时,为其确立明确的美学方向。生成的简报将作为下游所有内容、设计和文案生成Skill的统一输入与对齐基准,确保产出协调一致。

查看技能

creative-brief

其他

该Skill帮助开发者将模糊的项目想法转化为结构化的创意简报,用于在启动网站、品牌设计或团队协作前明确方向。它能识别“项目启动”、“设计方向”等多种触发词,自动生成包含目标、受众和需求等要素的简报框架。特别适合在团队对齐、交付设计开发任务前,快速将概念转化为可执行方案。

查看技能

brand-discovery

其他

该Skill用于品牌或网站项目初期的上游探索,涵盖受众研究、竞争格局和定位分析。它在用户需要明确目标受众、竞争对手及品牌定位时触发,尤其适用于创意简报所需输入尚未清晰的情况。通过系统性的市场研究,帮助开发者奠定项目策略基础。

查看技能

content-strategy

其他

该Skill用于制定全面的内容策略,涵盖编辑定位、内容支柱、格式规划、日历排期、治理规范和主题权威构建。它适用于规划内容项目、定义内容支柱、建立编辑日历、构建主题集群,以及将内容生产与品牌及SEO目标对齐。当开发者需要系统化内容规划或避免无策略的内容生产时,可触发此Skill进行结构化指导。

查看技能