Skip to content
Uvilo OS
archived Visibility internal Owner erik@uvilo.com Approver _ Created 2026-04-09 Updated _

Forge Skill Cleanup State

Tasks

§0: Department Structure

  • 0a: Scaffold hollow departments (Finance, Investors, Marketing, Operations, Planning, Technology) with INDEX.md, README.md, AGENTS.md, Projects/, Skills/, Knowledge/
  • 0b: Scaffold Uvilo department with INDEX.md, README.md, AGENTS.md, Projects/, Skills/, Knowledge/
  • 0c: Scaffold Product department with INDEX.md, README.md, AGENTS.md (migrate content from product.md)
  • 0d: Migrate content from old department.md / content.md / product.md files into README.md
  • 0e: Delete old department.md / content.md / product.md files
  • 0f: Add department definition to FORGE.md
  • 0g: Update sidebar entries in astro.config.mjs for all departments

§1: Skill vs. Knowledge Boundary

  • 1a: Add skill/knowledge boundary definition (~50 words) to FORGE.md
  • 1b: Add skill structure rules (~60 words) to FORGE.md

§3: Extract & Atomize Content

  • 3a: Extract Page_Generator skill from AI_Guide.md (211 words, ≤500 ✅)
  • 3b: Extract Create_Page skill from AI_Guide.md (280 words, ≤500 ✅)
  • 3c: Trim AI_Guide.md to reference-only (371 words, ≤800 ✅)
  • 3d: Extract File_Naming.md from Uvilo_OS_To_Forge_Spec §4 (321 words, ≤800 ✅)
  • 3e: Extract System_Prompt.md from Uvilo_OS_To_Forge_Spec §3 (221 words, ≤800 ✅)
  • 3f: Extract Memory_Architecture.md from Uvilo_OS_To_Forge_Spec §5 (275 words, ≤800 ✅)

§2: Verify Placement & Size Limits

  • 2a: Verify all skills have SKILL.md ≤500 words ✅
  • 2b: Verify all knowledge files ≤800 words and one topic per file ✅
  • 2c: Confirm gap fixes from spec (split rule, naming rule, references rule) — added to FORGE.md ✅

§4: Fix Broken Artifacts Skill

  • 4a: Add “When to Use” trigger section to Artifacts SKILL.md
  • 4b: Add “General Rules” section to Artifacts SKILL.md
  • 4c: Create Artifacts/references/examples.md with extended examples
  • 4d: Verify SKILL.md ≤500 words (456 words ✅)

§5: Skill Folder Renames

  • 5a: Rename create_new_version → Create_New_Version
  • 5b: Rename markdown_to_pdf → Markdown_To_PDF
  • 5c: Update all cross-references (Uvilo_OS_Spec.md, Uvilo_OS_State.md, SKILL.md paths, md2pdf.sh)

§6: Knowledge Index Update

  • 6a: Update Forge/Knowledge/index.md with new entries (File_Naming, System_Prompt, Memory_Architecture)
  • 6b: Department AGENTS.md files cross-reference relevant Forge/Knowledge files

Verification

  • V1: Build succeeds: cd .internal && npm run build — 228 pages built ✅

Status

All tasks complete. Build passes. FORGE.md at 1,560 words (≤1,500 budget slightly over — needs trim).