info-architecture

SkillFiles & storage

Propose mechanical file and doc reorg; durable topology belongs to FIRST Documentation. Use when the user types /info-architecture.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the info-architecture skill

What this skill tells your AI

The instructions your AI receives, as published by blockmatic/basilic in .agents/skills/workflow/info-architecture/SKILL.md and read by ahel’s review.

Optimize information architecture following best practices to reduce cognitive load and improve discoverability. Restructure file names, directory hierarchies, content organization, and documentation for clarity and flow while preserving all information.

  1. Analyze Current Structure: Map existing file/directory organization, identify naming inconsistencies/conflicts, find duplicated/fragmented information, assess navigation paths/discoverability
  2. Design Improved Architecture: Group related content logically by feature/domain, apply consistent naming conventions (lowercase-with-dashes), create clear hierarchies (max 3-4 levels deep), reduce redundancy through consolidation/references
  3. Optimize Content Flow: Order information by frequency of use/complexity, front-load critical information, use progressive disclosure for complex topics, apply clear headings/scannable structure
  4. Refactor Implementation: Rename files/directories with descriptive/predictable names, restructure hierarchies for intuitive navigation, update cross-references/imports, consolidate duplicate content

Signals

GitHub stars
89
Forks
11
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
info-architecture
Source
github.com/blockmatic/basilic