refactor: reorganize repo docs and tooling layout

Consolidate the repository into clearer apps, tools, and layered docs areas so contributors can navigate and maintain it more reliably. Align validation, metadata sync, and CI around the same canonical workflow to reduce drift across local checks and GitHub Actions.
2026-03-06 15:01:38 +01:00
parent 5d17564608
commit 45844de534
3384 changed files with 13894 additions and 586586 deletions
--- a/docs/CATEGORIZATION_IMPLEMENTATION.md
+++ b/docs/CATEGORIZATION_IMPLEMENTATION.md
@@ -1,170 +1,3 @@
-# Smart Categorization Implementation - Complete Summary
+# Categorization Implementation

-## ✅ What Was Done
-
-### 1. **Intelligent Auto-Categorization Script**
-Created [scripts/auto_categorize_skills.py](scripts/auto_categorize_skills.py) that:
- Analyzes skill names and descriptions
- Matches against keyword libraries for 13 categories
- Automatically assigns meaningful categories
- Removes "uncategorized" bulk assignment
-
-**Results:**
- ✅ 776 skills auto-categorized
- ✅ 46 already had categories preserved
- ✅ 124 remaining uncategorized (edge cases)
-
-### 2. **Category Distribution**
-
-**Before:**
-```
-uncategorized: 926 (98%)
-game-development: 10
-libreoffice: 5
-security: 4
-```
-
-**After:**
-```
-Backend: 164          ████████████████
-Web Dev: 107          ███████████
-Automation: 103       ███████████
-DevOps: 83            ████████
-AI/ML: 79             ████████
-Content: 47           █████
-Database: 44          █████
-Testing: 38           ████
-Security: 36          ████
-Cloud: 33             ███
-Mobile: 21            ██
-Game Dev: 15          ██
-Data Science: 14      ██
-Uncategorized: 126    █
-```
-
-### 3. **Updated Index Generation**
-Modified [scripts/generate_index.py](scripts/generate_index.py):
- **Frontmatter categories now take priority**
- Falls back to folder structure if needed
- Generates clean, organized skills_index.json
- Exported to web-app/public/skills.json
-
-### 4. **Improved Web App Filter**
-
-**Home Page Changes:**
- ✅ Categories sorted by skill count (most first)
- ✅ "Uncategorized" moved to bottom
- ✅ Each shows count: "Backend (164)", "Web Dev (107)"
- ✅ Much easier to navigate
-
-**Updated Code:**
- [web-app/src/pages/Home.jsx](web-app/src/pages/Home.jsx) - Smart category sorting
- Sorts categories by count using categoryStats
- Uncategorized always last
- Displays count in dropdown
-
-### 5. **Categorization Keywords** (13 Categories)
-
-| Category | Key Keywords |
-|----------|--------------|
-| **Backend** | nodejs, express, fastapi, django, server, api, database |
-| **Web Dev** | react, vue, angular, frontend, css, html, tailwind |
-| **Automation** | workflow, scripting, automation, robot, trigger |
-| **DevOps** | docker, kubernetes, ci/cd, deploy, container |
-| **AI/ML** | ai, machine learning, tensorflow, nlp, gpt, llm |
-| **Content** | markdown, documentation, content, writing |
-| **Database** | sql, postgres, mongodb, redis, orm |
-| **Testing** | test, jest, pytest, cypress, unit test |
-| **Security** | encryption, auth, oauth, jwt, vulnerability |
-| **Cloud** | aws, azure, gcp, serverless, lambda |
-| **Mobile** | react native, flutter, ios, android, swift |
-| **Game Dev** | game, unity, webgl, threejs, 3d, physics |
-| **Data Science** | pandas, numpy, analytics, statistics |
-
-### 6. **Documentation**
-Created [docs/SMART_AUTO_CATEGORIZATION.md](docs/SMART_AUTO_CATEGORIZATION.md) with:
- How the system works
- Using the script (`--dry-run` and apply modes)
- Category reference
- Customization guide
- Troubleshooting
-
-## 🎯 The Result
-
-### No More Uncategorized Chaos
- **Before**: 98% of 946 skills lumped as "uncategorized"
- **After**: 87% properly organized, only 13% needing review
-
-### Better UX
-1. **Smarter Filtering**: Categories sorted by relevance
-2. **Visual Cues**: Shows count "(164 skills)""
-3. **Uncategorized Last**: Put bad options out of sight
-4. **Meaningful Groups**: Find skills by actual function
-
-### Example Workflow
-User wants to find database skills:
-1. Opens web app
-2. Sees filter dropdown: "Backend (164) | Database (44) | Web Dev (107)..."
-3. Clicks "Database (44)"
-4. Gets 44 relevant SQL/MongoDB/Postgres skills
-5. Done! 🎉
-
-## 🚀 Usage
-
-### Run Auto-Categorization
-```bash
-# Test first
-python scripts/auto_categorize_skills.py --dry-run
-
-# Apply changes
-python scripts/auto_categorize_skills.py
-
-# Regenerate index
-python scripts/generate_index.py
-
-# Deploy to web app
-cp skills_index.json web-app/public/skills.json
-```
-
-### For New Skills
-Add to frontmatter:
-```yaml
---
-name: my-skill
-description: "..."
-category: backend
-date_added: "2025-02-26"
---
-```
-
-## 📁 Files Changed
-
-### New Files
- `scripts/auto_categorize_skills.py` - Auto-categorization engine
- `docs/SMART_AUTO_CATEGORIZATION.md` - Full documentation
-
-### Modified Files
- `scripts/generate_index.py` - Category priority logic
- `web-app/src/pages/Home.jsx` - Smart category sorting
- `web-app/public/skills.json` - Regenerated with categories
-
-## 📊 Quality Metrics
-
- **Coverage**: 87% of skills in meaningful categories
- **Accuracy**: Keyword-based matching with word boundaries
- **Performance**: ~1-2 seconds to auto-categorize all 946 skills
- **Maintainability**: Easily add keywords/categories for future growth
-
-## 🎁 Bonus Features
-
-1. **Dry-run mode**: See changes before applying
-2. **Weighted scoring**: Exact matches score 2x partial matches
-3. **Customizable keywords**: Easy to add more categories
-4. **Fallback logic**: folder → frontmatter → uncategorized
-5. **UTF-8 support**: Works on Windows/Mac/Linux
-
---
-
-**Status**: ✅ Complete and deployed to web app!
-
-The web app now has a clean, intelligent category filter instead of "uncategorized" chaos. 🚀
+This document moved to [`maintainers/categorization-implementation.md`](maintainers/categorization-implementation.md).