---
name: macro-engine-onboarding
description: A rapid context-recovery sequence to align the AI with the current session state and active projects.
tags: [onboarding, context, recovery, macro]
category: system
---

# Macro Engine Onboarding

## 🎯 Objective
Efficiently recover state and context at the start of a session to avoid redundant queries and minimize hallucinations.

## 🛠️ Execution Steps
1. **Session Review:** Call `session_recent(3)` to identify the last active tasks and their outcomes.
2. **VFS Snapshot:** Call `list_files('')` to examine the root directory for new project files or configuration changes.
3. **Procedure Retrieval:** Call `load_skills('current-task')` to see if any stored procedures are applicable to the immediate goal.
4. **User Preferences:** Call `user_list` to check for project-specific flags or persistent preferences (e.g., preferred models, project paths).

## 🔄 Workflow
`session_recent` ➔ `list_files` ➔ `load_skills` ➔ `user_list`