정보
이 스킬은 개발자들이 사이트맵, 네비게이션, 콘텐츠 분류 체계를 포함한 웹사이트와 제품의 구조적 청사진을 설계하는 데 도움을 줍니다. URL 설계나 카테고리화와 같은 시스템 수준의 조직을 계획, 감사 또는 재구성할 때 활성화됩니다. 구현 전에 기초적인 콘텐츠 구조를 수립하기 위해 사용하세요.
빠른 설치
Claude Code
추천npx skills add rampstackco/claude-skills -a claude-code/plugin add https://github.com/rampstackco/claude-skillsgit clone https://github.com/rampstackco/claude-skills.git ~/.claude/skills/information-architectureClaude 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
- Understand the audience and content. Use existing discovery and content strategy if available.
- Card sort or interview to surface mental models.
- Draft the sitemap. Hierarchy, page types, cross-references.
- Define URL patterns. One pattern per content type.
- Design navigation. Primary, secondary, utility, footer, breadcrumbs.
- Build taxonomy. Categories (controlled, small) and tags (open, large).
- Validate labels. Tree test or closed card sort with target users, or state the gap per the data-availability rule.
- Document. Use the template in
references/ia-document-template.md. - 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:
- Executive summary
- Audience and mental models (synthesized)
- Sitemap (hierarchical diagram)
- URL structure (per content type)
- Navigation specification (primary, secondary, utility, footer, breadcrumbs)
- Taxonomy (categories and tag governance)
- Labels (validated wording for navigation, categories, content types)
- 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
references/ia-document-template.md- Template for the IA deliverable.references/url-pattern-library.md- URL pattern conventions for common content types.
GitHub 저장소
자주 묻는 질문
information-architecture Skill이란 무엇인가요?
information-architecture은(는) rampstackco이(가) 만든 Claude Skill입니다. Skill은 Claude가 필요할 때 불러오는 지침과 리소스를 묶어 추가 프롬프트 없이 information-architecture 관련 작업을 수행할 수 있게 합니다.
information-architecture은(는) 어떻게 설치하나요?
이 페이지의 설치 명령을 사용하세요. information-architecture을(를) Claude Code 플러그인으로 추가하거나 저장소를 skills 디렉터리에 복제한 다음 Claude를 다시 시작해 Skill을 불러옵니다.
information-architecture은(는) 어떤 카테고리에 속하나요?
information-architecture은(는) 메타 카테고리에 속합니다.
information-architecture은(는) 무료로 사용할 수 있나요?
네. information-architecture은(는) AIMCP에 등록되어 있으며 무료로 설치할 수 있습니다.
연관 스킬
이 스킬은 콘텐츠 콜렉션(Content Collections)을 위한 프로덕션 검증된 설정을 제공합니다. 콘텐츠 콜렉션은 Markdown/MDX 파일을 Zod 검증이 포함된 타입 안전한 데이터 콜렉션으로 변환해주는 TypeScript 최우선 도구입니다. 블로그, 문서 사이트 또는 콘텐츠 중심의 Vite + React 애플리케이션을 구축할 때 타입 안전성과 자동 콘텐츠 검증을 보장하기 위해 사용하세요. Vite 플러그인 구성과 MDX 컴파일부터 배포 최적화 및 스키마 검증에 이르기까지 모든 것을 다룹니다.
이 스킬은 개발자들이 Polymarket 예측 시장 플랫폼을 활용한 애플리케이션을 구축할 수 있도록 지원하며, 거래 및 시장 데이터를 위한 API 통합 기능을 포함합니다. 또한 WebSocket을 통한 실시간 데이터 스트리밍을 제공하여 실시간 거래와 시장 활동을 모니터링할 수 있습니다. 이를 통해 거래 전략을 구현하거나 실시간 시장 업데이트를 처리하는 도구를 생성하는 데 활용할 수 있습니다.
이 스킬은 개발자들이 명령어, 파일, LSP 작업 등 25개 이상의 이벤트 유형에 연결되는 OpenCode 플러그인을 만들 수 있도록 돕습니다. JavaScript/TypeScript 모듈을 위한 플러그인 구조, 이벤트 API 명세, 구현 패턴을 제공합니다. OpenCode AI 어시스턴트의 라이프사이클을 사용자 정의 이벤트 기반 로직으로 가로채거나, 모니터링하거나, 확장해야 할 때 사용하세요.
SGLang은 RadixAttention 프리픽스 캐싱을 활용하여 JSON, 정규식, 에이전트 워크플로우를 위한 고속 구조화 생성에 특화된 고성능 LLM 서빙 프레임워크입니다. 특히 반복되는 프리픽스가 있는 작업에서 상당히 빠른 추론 속도를 제공하여 복잡한 구조화 출력 및 다중 턴 대화에 이상적입니다. 제약 디코딩이 필요하거나 광범위한 프리픽스 공유가 있는 애플리케이션을 구축할 때는 vLLM과 같은 대안보다 SGLang을 선택하십시오.
