Forge Skills 2 State

Tasks

§1: Requirements

• 1a: Create Forge_Skills_2_Requirements.md capturing all 8 requirement areas (R1–R8)

§2: Research

• 2a: Create Forge_Skills_2_Research.md with options analysis and decision points
• 2b: Conduct web research on AgentSpec, Alpine vs Debian-slim, MCP security, knowledge management
• 2c: Record Erik’s decisions on all 9 requirement areas (R1–R9)

§3: Spec

• 3a: Create Forge_Skills_2_Spec.md with implementation specification organized into 5 phases

§4: Knowledge & Rule Fixes

• 4a: Satisfy R1 — add deferred tools list to FORGE.md (general tools only); update Uvilo/AGENTS.md with Uvilo-specific tools
• 4b: Satisfy R2 — add “Before You Install” section to Forge_Infrastructure.md (Alpine constraints section updated with quick-reference table)
• 4c: Satisfy R3 — Vercel: full docs to Forge_Infrastructure.md, procedure to new Vercel_MCP skill
• 4d: Satisfy R4 — create Secrets inventory (with .secrets not-in-source warning); update Railway knowledge with env var access
• 4e: Satisfy R6 — add hard escalation rule to FORGE.md
• 4f: Satisfy R7 — fix end-of-session protocol (truncate not rm); add permission rule
• 4g: Satisfy R9 — add SUMMARIZE rule to FORGE.md; move POST-ACTION CHECKLIST to Create_Page skill
• 4h: Move COMMANDS table out of FORGE.md (with slash-command identification guidance)

§5: Content Inclusion & SKILL.md Frontmatter (R10, R11)

• 5a: Simplify content.config.ts glob pattern to **/*.md + !.internal/** + .generated/**/*.view.md
• 5b: Add name and description to Starlight extend schema in content.config.ts
• 5c: Remove SKILL.md wrapper generation from page generator (generate_view_pages.ts)
• 5d: Update all SKILL.md files with combined frontmatter (name, description, title, visibility, status, owner)
• 5e: Add sidebar entries for SKILL.md pages in astro.config.mjs
• 5f: Update AI_Guide.md and Update_Sidebar/SKILL.md to reflect simplified pattern

§6: Knowledge File Audit & Restructuring

• 6a: Rename Prompts → Assets; move FORGE.md to Configs/
• 6b: Create consolidated root-level documentation files (Forge_Content_System.md, Forge_Agent_Architecture.md, Forge_Document_Structure.md, Forge_Infrastructure.md)
• 6c: Handle Knowledge/Tools/ content (condense key points into Infrastructure doc, fold procedures into skills including new Vercel_MCP skill)
• 6d: Eliminate Lessons.md — redistribute entries to consolidated docs
• 6e: Update Skills vs Knowledge definition in FORGE.md (declarative vs procedural)
• 6f: Update Typesense chunking strategy: heading-based instead of arbitrary word-count splits
• 6g: Update all cross-references, sidebar, content.config.ts, build

§7: Forge Optimizer Skill

• 7a: Create Forge/Skills/Forge_Optimizer/SKILL.md — procedure for analyzing conversations from MongoDB (R8)
• 7b: Create extraction prompt template and example report in references/
• 7c: Add /optimize command with optional conversation title argument

§8: Alpine → Debian-slim Investigation (New Project)

• 8a: Create Forge/Projects/Container_Base_Image/ project
• 8b: Research feasibility of switching from Alpine to Debian-slim base image

Verification

• V1: Build succeeds after all changes
• V2: All sidebar links resolve
• V3: /update-agents skill works with new FORGE.md path
• V4: SKILL.md pages render correctly with combined frontmatter
• V5: No .generated/ SKILL.md wrappers remain after generator update