---
description: "Homunculus self-evolving AI assistant. Use when user asks about evolution cycles, goal trees, system status, instincts, or skills. Provides routing to detailed evolution workflows."
globs: ["homunculus/**", "architecture.yaml", "evolution-config.yaml"]
alwaysApply: false
---

# Homunculus — Self-Evolving AI Assistant

## When to use

Use this when the user asks about:
- Running an evolution cycle ("run evolution", "nightly cycle", "evolve the system")
- Defining or viewing project goals ("define goals", "goal tree")
- Checking system status ("show status", "how many instincts")
- Evolving, evaluating, or improving skills

## Commands

| User says | Detailed workflow |
|-----------|------------------|
| "run evolution" / "nightly cycle" / "hm-night" | Read `homunculus/commands/hm-night.md` |
| "define goals" / "goal tree" / "hm-goal" | Read `homunculus/commands/hm-goal.md` |
| "system status" / "hm-status" | Read `homunculus/commands/hm-status.md` |
| "evolve skill" | Read `homunculus/commands/evolve.md` |
| "eval skill" | Read `homunculus/commands/eval-skill.md` |
| "improve skill" | Read `homunculus/commands/improve-skill.md` |

## Key Paths

- `architecture.yaml` — goal tree (read to understand project goals)
- `evolution-config.yaml` — tier: minimal/standard/full
- `homunculus/instincts/personal/` — behavioral patterns
- `homunculus/evolved/skills/` — tested knowledge
- `homunculus/commands/` — detailed workflow instructions