blog-taxonomy

# Blog Taxonomy Manage tags, categories, and topic clusters across CMS platforms. ## Commands | Command | Purpose | |---------|---------| | `/blog taxonomy suggest <file>` | Extract candidate tags and categories from content | | `/blog taxonomy sync <cms>` | Push taxonomy to CMS via authenticated API | | `/blog taxonomy audit [directory]` | Check for thin tags, orphan tags, taxonomy bloat | ## Tag Suggestion Workflow ### Step 1: Parse Content Structure Read the target file and extract: - All H2 and H3 headings (primary topic signals) - Bold and italic phrases (emphasis signals) - Existing frontmatter tags/categories if present ### Step 2: Frequency Analysis Scan the body text for high-frequency phrases: - 1-word terms: minimum 4 occurrences (excluding stop words) - 2-word phrases: minimum 3 occurrences - 3-word phrases: minimum 2 occurrences Exclude common non-tag words: articles, prepositions, conjunctions, pronouns. ### Step 3: Semantic Grouping Group related candidates into clusters: - Merge singular/plural variants (keep the more common form) - Merge hyphenated and non-hyphenated forms - Group synonyms under the highest-frequency term ### Step 4: Deduplicate and Rank - Fuzzy match on slugified names (Levenshtein distance <= 2) - Do not auto-merge short slugs under 5 characters using Levenshtein alone; require token overlap or manual review - Score each candidate: `(frequency * 2) + (heading_presence * 5) + (emphasis * 1)` - Return top 5-10 ranked suggestions ...