Fen Ecosystem

SkillDev tools

Context for the Mechanic/Fen WoW addon development ecosystem. Covers all components (Mechanic, FenCore, FenUI, MechanicLib), their relationships, and AFD principles. Load this at the start of addon work. Triggers: ecosystem, fen, fencore, fenui, mechanic, addon, context.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Fen Ecosystem skill

What this skill tells your AI

The instructions your AI receives, as published by falkicon/mechanic in .agent/skills/k-ecosystem/SKILL.md and read by ahel’s review.

The Mechanic/Fen ecosystem is a unified platform for WoW addon development.

The Reload Loop (MANDATORY)

After ANY addon code change, you MUST verify the changes in-game:

  1. Ask the user to /reload in WoW (or trigger via keybinding CTRL+SHIFT+R)
  2. Wait for the user to confirm the reload is complete
  3. Then use the addon.output MCP tool (agent_mode=true) to get errors, tests, and console logs

CRITICAL: Do NOT call addon.output immediately after changes. The timing between reload and SavedVariables sync is unpredictable. Always wait for user confirmation.

Ecosystem Components

ComponentPurposeKey Tools
MechanicDevelopment hub (CLI, MCP, Dashboard)env.status, addon.output, addon.lint, addon.test
FenCorePure logic library (no UI dependencies)fencore.catalog, fencore.search, fencore.info
FenUIUI widget library (frames, layouts)Layout, Panel, Tabs, Grid, Buttons
MechanicLibBridge library (addon ↔ Mechanic)RegisterAddon, Print, RegisterTest

Component Relationships

┌─────────────────────────────────────────────────────┐
│                    Your Addon                        │
├─────────────────────────────────────────────────────┤
│  Core Layer     │  Bridge Layer   │  View Layer     │
│  (Pure Logic)   │  (Events/Data)  │  (UI Frames)    │
│                 │                 │                 │
│  Uses: FenCore  │  Uses: Ace3     │  Uses: FenUI    │
└─────────────────────────────────────────────────────┘
         │                 │                 │
         └────────────┬────┴─────────────────┘
                      │
              ┌───────▼───────┐
              │  MechanicLib  │  (Registers addon with Mechanic)
              └───────┬───────┘
                      │
              ┌───────▼───────┐
              │   Mechanic    │  (Development hub)
              └───────────────┘

Essential MCP Tools

TaskMCP Tool
Get Addon Outputaddon.output(agent_mode=true)
Lint Codeaddon.lint(addon="MyAddon")
Run Testsaddon.test(addon="MyAddon")
Search APIsapi.search(query="*Spell*")
Search FenCorefencore.search(query="clamp")
Env Statusenv.status()

AFD Core Principles

Mechanic follows Agent-First Development (AFD)github.com/Falkicon/afd

  1. Tool-First: All functionality exists as an MCP tool before any UI
  2. Structured Results: Tools return predictable JSON with success, data, error
  3. Agent Mode: Use agent_mode=true for AI-optimized output

Related Knowledge

Signals

GitHub stars
20
Forks
5
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
k-ecosystem
Source
github.com/falkicon/mechanic