Initialize an Engineering Journey System (EJS) session by creating a Session Journey file, refreshing the ADR/journey database index, and setting up metadata for continuous recording throughout the session.
Use this skill when a session is starting — for example when the user says "initialize session", "start session", "create session journey", or begins work on a new task, feature, or bug fix.
Refresh the EJS database index
python scripts/adr-db.py sync
Determine the session ID
ejs-session-YYYY-MM-DD-<seq> (2-digit daily sequence)ejs-docs/journey/YYYY/ for existing sessions today and increment the sequence number.Create the Session Journey file
ejs-docs/journey/_templates/journey-template.mdejs-docs/journey/YYYY/ejs-session-YYYY-MM-DD-<seq>.mdPopulate initial metadata Fill in the frontmatter fields:
session_id — the generated session IDauthor — the human user (if known)date — today's date (YYYY-MM-DD)repo — current repository namebranch — current git branchagents_involved — list the active agents (e.g., [copilot])decision_detected: false — initial value; updated at session endadr_links: [] — populated if an ADR is created laterCapture initial Problem / Intent
Confirm initialization
"Session initialized: ejs-session-YYYY-MM-DD-<seq>"ejs-docs/journey/_templates/journey-template.mdejs-docs/adr/0000-adr-template.mdejs-docs/session-lifecycle-patterns.mdscripts/adr-db.pyInitialize early, capture context while it's fresh. A well-initialized session reduces the burden at session end and produces higher-quality documentation.