---
name: generate-taxonomy
description: Develop hierarchical classification systems. Creates parent-child categorical structures for content organization.
required_roles:
  scribe: roles/scribe.editor
personas: [information-architect, taxonomist, knowledge-manager]
---

# Generate Taxonomy Skill

Develop a hierarchical classification system or taxonomy for a knowledge base or content repository. This skill creates parent-child categorical structures to organize content effectively.

## Inputs

- `PATH` - The content source to analyze (e.g., "/knowledge-base")
- `FACETED` - (Optional) Boolean, whether to create a faceted classification (multiple dimensions) (default: false)
- `BUSINESS_ALIGNMENT` - (Optional) Boolean, whether to align with specific business goals/terminology (default: true)
- `USER_TESTING` - (Optional) Boolean, whether to include user validation methodologies in the output (default: false)

## Workflow

### Step 1: Content Analysis & Term Extraction

Analyze the content at `PATH` to identify key topics, subjects, and categories.
- Cluster documents by similarity.
- Extract common tags and keywords.

### Step 2: Structure Design

Organize the extracted concepts into a hierarchy.
- **Hierarchical**: Define Broader Terms (Parent) and Narrower Terms (Child).
- **Faceted** (if enabled): Define dimensions (e.g., Topic, Format, Audience, Region).

### Step 3: Business & User Alignment

- Align terms with business vocabulary (if `BUSINESS_ALIGNMENT` is true).
- If `USER_TESTING` is true, generate a plan for card sorting or tree testing to validate the structure.

### Step 4: Taxonomy Definition

Output the defined taxonomy.

## Required Outputs

A `TAXONOMY_DEFINITION` document (e.g., in markdown or YAML format) containing:
- **Taxonomy Tree**: Visual or indented list of categories.
- **Facets** (if requested): Definitions of classification dimensions.
- **Rules**: Guidelines for applying the taxonomy.
- **Testing Plan** (if requested): Methodologies for validation.

## Quick Reference

- **Purpose**: Systematically classify content for retrieval optimization.
- **Types**: Hierarchical (Tree) vs. Faceted (Matrix).