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

Uvilo OS To Forge State

Project: Forge/Projects/Uvilo_OS_To_Forge Spec: Uvilo_OS_To_Forge_Spec Plan Phase 1: Uvilo_OS_To_Forge_Plan_Phase_1 Plan Phase 2: Uvilo_OS_To_Forge_Plan_Phase_2 Plan Phase 3: Uvilo_OS_To_Forge_Plan_Phase_3

Status

✅ Project complete. All 22 tasks done across 4 phases. Build: 201 pages.

Phase 1 — Before Team Rollout (Next 1–2 Weeks)

  • Task 1 — Rename Assistant/ → Forge/ and instructions.md → FORGE.md
  • Task 2 — Merge Uvilo_OS/ into Forge/
  • Task 3 — Execute the three-way split (Architecture/ → Product/Projects/ + Forge/Projects/)
  • Task 4 — Inline FORGE.md into Agent Instructions
  • Task 5 — Create Minimal Artifact Instructions
  • Task 6 — Rename README.md → INDEX.md in the generator
  • Task 7 — Create LESSONS.md for each existing skill
  • Task 8 — Add grep to FORGE.md discovery section
  • Task 9 — Add word-count budgets to FORGE.md
  • Task 10 — Document team onboarding flow

Phase 1 Fix-up Tests (2026-04-07)

TestResult
Stale ref grep: Assistant/ in active files✅ PASS — zero hits
Stale ref grep: assistant/ (lowercase)✅ PASS — only LLM-role uses remain
Stale ref grep: Uvilo_OS/ in active guidance✅ PASS — only historical project docs
Stale ref grep: Architecture/Uvilo_OS/✅ PASS — only historical project docs
Stale ref grep: Uvilo Assistant✅ PASS — zero hits in active files
Local build (npm run build)✅ PASS — 193 pages in 20.88s
Vercel deploy✅ PASS — READY
/update-agents execution✅ PASS — 4 updated, 1 master skipped
Agent does not read FORGE.md at startup✅ PASS — instructions inlined
Inlined instructions match FORGE.md✅ PASS — 9784 chars
Artifact Instructions reconciliation✅ PASS — override + SKILL.md cover all
Skill renames (Command.md → SKILL.md)✅ PASS — 5 renamed, 5 LESSONS.md created
Internal links (no dead pre-Forge locations)✅ PASS — build passes, no broken refs
startup.sh path fix⚠️ Fixed in repo — needs /redeploy to activate
Artifact type testing (all 5 types)⚠️ HTML tested OK; SVG/React/Mermaid/MD need manual test
Onboarding human-review/share⚠️ Pending — Team_Onboarding.md exists, not shared yet

Phase 2 — Do Soon (Weeks 3–6)

Prerequisite: Phase 1 complete.

  • Task 11 — Enable LibreChat per-user memory
  • Task 12 — Create the Context Hygiene skill
  • Task 13 — Implement History compaction
  • Task 14 — Gitignore WIP files

Phase 3 — Project Documentation Standardization

Prerequisite: Phase 1 and Phase 2 structure changes complete.

  • Task 15 — Audit all projects for README and AGENTS coverage
  • Task 16 — Create or update project README files
  • Task 17 — Create or update project AGENTS files
  • Task 18 — Normalize existing plan file names
  • Task 19 — Verify sidebar compliance across all projects

Phase 4 — Agent ACL Hardening

  • Task 20 — Replace hardcoded role ObjectIds with live lookup from accessroles collection
  • Task 21 — Add --audit-acl flag for self-healing missing ACL entries
  • Task 22 — Update SKILL.md with ACL auto-creation note and --audit-acl docs
  • Task 23 — Update libre_agents.md with ACL requirement documentation

Notes

  • Tasks 1–3 are the big structural moves — do them in sequence (rename first, then merge, then split) to avoid path confusion during the move.
  • Task 4 (inline FORGE.md) depends on Task 1 (the file must exist at Forge/FORGE.md first).
  • Tasks 6–10 can be done in parallel once Task 1 is complete.
  • Task 14 (gitignore WIP) is low-risk and can be done any time in Phase 2.