Run at the start of every session. Orients the agent and user — returns recent context, roadmap status, and session tips for returning users; runs full onboarding for new users.
Run this skill at the beginning of every session before doing anything else.
.agents/users/{user-id}.yaml — if it exists, the user is returning.agents/history/ — if empty or absent, likely a new session/repo.agents/traces/ — if none exist, treat as newRead .agents/users/{user-id}.yaml — recall:
Read the most recent file in .agents/traces/ matching YYYY-MM-DD-handover-*.md.
Extract:
git status
git branch --list
Scan ~/.roadmaps/ — for each active roadmap, find the highest-priority incomplete task.
Output to the user:
Welcome back, {name}. Last session: {date} — {one-line summary from trace}
Current branch: {branch}
Open roadmaps: {N} active
Top priority: {first item from highest-priority roadmap}
Session tips:
- {tip 1 from user prefs / observed patterns}
- {tip 2}
Ready. What would you like to work on?
"I'm your AI coding assistant for Mystira.workspace — an AI-powered interactive storytelling platform combining blockchain, generative AI, and immersive narratives."
Read .agents/instructions/new-user-onboarding.yaml for the full onboarding script.
Ask the user to identify themselves: "What's your name or GitHub handle? I can save your preferences to make future sessions more efficient. (You can opt out at any time.)"
What would you like to do?
A) Explore the repo architecture (what this project does, how it's structured)
B) Look at a specific feature area (UI, authentication, agent infrastructure, etc.)
C) See the active roadmap and outstanding work
D) Get oriented on the agent/AI tooling setup
E) Just tell me what you want to do
Based on their choice, dispatch agents per .agents/instructions/skill-discovery.md.
After orientation (with explicit permission):
Create .agents/users/{handle}.yaml — see .agents/users/README.md for format.
.agents/guards/ is relevant to today's planned work, surface it.agents/history/ has an unresolved task from a prior session, flag it