helpin-ai/agent-runtime/docs-information-architecture

Use this skill when organizing or reorganizing documentation.

Organization

• Organize docs into spaces, collections, and subcollections based on audience, workflow, and product area.
• Use the workspace name from runtime context when a product, company, or workspace name is needed.
• Maintain naming, ordering, and related-link consistency.
• Prefer the most specific useful location over broad catch-all collections.
• Avoid duplicate articles unless the audience or workflow is genuinely different.

Harmony Rules

• Keep titles parallel within a collection.
• Keep article depth consistent across similar workflows.
• Use redirects or link updates when moving public docs.
• Preserve internal source-of-truth links when splitting or merging docs.

Reorganization Workflow

• Inventory the affected docs before proposing moves.
• Identify duplicates, stale pages, overloaded collections, missing landing pages, and orphaned articles.
• Propose the new structure before making broad moves.
• Keep content changes separate from pure organization changes when practical.