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

Knowledge Consistency Plan 3

Plan 3 — Manage_Pages to Page Manager Routing in Skill Files

Scope: Update all 14 skill files that currently direct agents to “use the Manage_Pages skill” for sidebar entries, page creation, or page operations. Replace these instructions with the canonical Page Manager spawn pattern: spawnAgent with { botGroup: "forge", botHandle: "page-manager" }.

Spec sections covered: S1.10 (skills only — 14 affected skill files).

Prerequisite: None.

Task 1 — Replace Manage_Pages Skill References with Page Manager Spawn Pattern

Spec S1.10: “No skill or prompt directs an agent to read or invoke the Manage_Pages skill for sidebar entries, page creation, or page operations. Instead, skills and prompts instruct agents to add sidebar entries and perform page operations by spawning the Page Manager bot via spawnAgent with { botGroup: "forge", botHandle: "page-manager" }. The Manage_Pages skill remains on disk as procedural guidance composed into the Page Manager bot’s prompt via include directive. It is not read directly by agents at runtime.”

Affected Files (14 total — complete list)

  1. Forge/Skills/Create_Skill/SKILL.md
  2. Forge/Forge_Project/Skills/Project_Vision/SKILL.md
  3. Forge/Forge_Project/Skills/Project_Research/SKILL.md
  4. Forge/Forge_Project/Skills/Project_Spec/SKILL.md
  5. Forge/Forge_Project/Skills/Project_Plan/SKILL.md
  6. Forge/Forge_Project/Skills/Project_Execute/SKILL.md
  7. Forge/Forge_Project/Skills/Project_Execute_Eval/SKILL.md
  8. Forge/Forge_Project/Skills/Project_Vision_Eval/SKILL.md
  9. Forge/Forge_Project/Skills/Project_Spec_Eval/SKILL.md
  10. Forge/Forge_Project/Skills/Project_Plan_Eval/SKILL.md
  11. Forge/Forge_Project/Skills/Project_Extract/SKILL.md
  12. Forge/Forge_Project/Skills/Project_Archive/SKILL.md
  13. Forge/Forge_Project/Skills/Project_Complete/SKILL.md
  14. Forge/Forge_Project/Skills/Project_Rename/SKILL.md

Steps

  1. For each of the 14 affected skill files listed above, search for instructions that direct agents to “use the Manage_Pages skill” (or variants like “use the manage-pages skill”, “use Manage_Pages”, “read the Manage_Pages skill”) for sidebar entries, page creation, page moving, page deletion, frontmatter updates, or sidebar updates.
  2. Replace each such instruction with: “Spawn the Page Manager bot via spawnAgent with { botGroup: 'forge', botHandle: 'page-manager' } to [perform the specific page operation].”
  3. Do NOT modify Forge/Skills/Manage_Pages/SKILL.md or SKILL.raw.md — the skill itself remains on disk as procedural guidance for the Page Manager bot.
  4. Do NOT modify the Page Manager bot prompt, Forge Environment prompt, or Task Runner prompt — these are handled in Plan 7 or are already correct per the Spec’s “Not affected” list.

Verify

  • grep -ri 'manage.pages skill\|Manage_Pages skill\|manage-pages skill' Forge/Skills/Create_Skill/SKILL.md Forge/Forge_Project/Skills/Project_Vision/SKILL.md Forge/Forge_Project/Skills/Project_Research/SKILL.md Forge/Forge_Project/Skills/Project_Spec/SKILL.md Forge/Forge_Project/Skills/Project_Plan/SKILL.md Forge/Forge_Project/Skills/Project_Execute/SKILL.md Forge/Forge_Project/Skills/Project_Execute_Eval/SKILL.md Forge/Forge_Project/Skills/Project_Vision_Eval/SKILL.md Forge/Forge_Project/Skills/Project_Spec_Eval/SKILL.md Forge/Forge_Project/Skills/Project_Plan_Eval/SKILL.md Forge/Forge_Project/Skills/Project_Extract/SKILL.md Forge/Forge_Project/Skills/Project_Archive/SKILL.md Forge/Forge_Project/Skills/Project_Complete/SKILL.md Forge/Forge_Project/Skills/Project_Rename/SKILL.md returns no matches
  • Each affected skill file contains the Page Manager spawn pattern: spawnAgent with { botGroup: 'forge', botHandle: 'page-manager' }
  • Forge/Skills/Manage_Pages/SKILL.md is NOT modified

Task 2 — Build, Commit, and Push

Spec S1.10: This Plan implements the Manage_Pages to Page Manager routing correction in 14 skill files. After all tasks are complete, commit and push the changes. Per Known Infrastructure Context, npm run build is expected to fail; proceed with git operations regardless.

Steps

  1. Run npm run build from the repo root. This is known to fail. Proceed regardless.
  2. git add all 14 modified skill files listed in Task 1.
  3. git commit -m "Plan 3: Route page operations via Page Manager bot in 14 skill files (S1.10)"
  4. git push origin dev

Verify

  • All modified files are committed and pushed to dev
  • git log --oneline -1 shows the commit

Plan 3 Completion Criteria

  • All 14 skill files listed in Task 1 no longer direct agents to read or invoke the Manage_Pages skill
  • All 14 skill files instruct agents to spawn the Page Manager bot via spawnAgent with { botGroup: 'forge', botHandle: 'page-manager' }
  • Forge/Skills/Manage_Pages/SKILL.md is not modified
  • Changes committed and pushed to dev

Dependencies

  • Requires: None
  • Blocks: None