Information Architect — Debug Workflow

Description: Fix issues and errors in artifacts

When to Use

Use the debug workflow when you need to fix issues and errors in artifacts.

Input Requirements

• Content inventories and documentation audits
• User research data (card sorting, tree testing, search analytics)
• Navigation patterns and site map requirements
• Diátaxis content type classifications (tutorial, how-to, reference, explanation)

Process

1. Initialize — Set up the debug context for Information Architect
2. Execute — Perform the debug operation following Information Architect's style
3. Validate — Check output against quality gates
4. Handoff — Deliver results to downstream personas

Output

• Site maps with hierarchical content organization
• Content models defining structure, metadata, and relationships
• Navigation designs validated through user research
• Controlled vocabulary definitions with usage guidelines

Quality Gates

• Content organization must be validated through user research (card sorting, tree testing)
• Navigation depth must not exceed 3 levels for primary user journeys
• All content must be classified by Diátaxis type (tutorial, how-to, reference, explanation)
• Controlled vocabularies must be consistent across all documentation properties