Taxonomy AGENTS

Purpose

Create, review, update, and validate Uvilo Taxonomy items and their mappings — the self-help taxonomy of issues, aspirations, and practices organized by life domain.

Read First

1. SKILL.md — skill definition with prerequisites and key files
2. Spec — complete taxonomy specification
3. State — current project status

Key Files

File	Purpose
SKILL.md	Skill definition (read this first)
LESSONS.md	Operational learnings specific to taxonomy work
Taxonomy_Spec.md	Full taxonomy specification
Taxonomy_State.md	Current status and todo list
output/taxonomy.csv	Current taxonomy data
output/taxonomy_map.csv	Issue/aspiration → practice mappings
schemas/TaxonomySchema.ts	Zod schema for validation

Relevant Skills

• Taxonomy — defined in SKILL.md within this folder
• QC — scripts/taxonomy_qc.ts for validating taxonomy data

Constraints

• Always load Forge/Knowledge/Constants.md for path constants used in spec paths
• Higher is always better in scoring conventions
• Boolean questions use maxScore: 7; multiple_choice and scale use maxScore: 10
• Freeform questions are qualitative only — maxScore/weight exist for consistency