session-start

Initialize and analyze git repository state and project readiness for engineering sessions.

50|7|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/Kanevry/session-orchestrator --skill session-start-kanevry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-start
Source: https://github.com/Kanevry/session-orchestrator/tree/main/skills/session-start
Command: npx skills add https://github.com/Kanevry/session-orchestrator --skill session-start-kanevry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a repeatable, opinionated kickoff for engineering work by autonomously analyzing repository state, VCS issues, SSOT files, environment, cross-repo status, and historical metrics so teams start sessions with clear recommendations and safety gates.

Core Features & Use Cases

  • Bootstrap gating & continuity: enforces a hard bootstrap gate, resumes or surfaces unfinished sessions, and respects persistence state for safe continuation.
  • Comprehensive analysis: runs parallel git and VCS queries, SSOT freshness checks, baseline quality probes, plugin freshness checks, cross-repo inspections, and historical metrics aggregation to surface risks and quick wins.
  • Project intelligence & recommendations: surfaces active learnings, effectiveness trends, recurring patterns, and presents structured, recommended session focuses with AskUserQuestion flows for alignment before handing off to session-plan.

Quick Start

Start a session to analyze the repository, surface findings, and present recommended wave plans for user alignment.

Frequently Asked Questions about session-start

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze repository state before starting a coding session?

To analyze repository state before a coding session, the skill autonomously runs parallel git queries, VCS checks, and SSOT freshness validation to surface risks. It enforces bootstrap gates to ensure project readiness and safely resume unfinished work.

What is the best way to initialize and align a repository for feature development?

Initializing and aligning a repository for feature development requires aggregating historical metrics, recognizing recurring patterns, and checking environment configurations. This provides structured recommendations and uses AskUserQuestion flows to align session focus before handing off to planning.

How do I check SSOT freshness and environment readiness in a git repository?

Checking SSOT freshness and environment readiness in a git repository involves performing baseline quality probes and cross-repo inspections during session initialization. This validates that source of truth files are current and the local environment meets bootstrap gating criteria.

Does session-start require platform CLIs to analyze VCS status?

Session-start requires access to local repository files to analyze VCS status, while platform CLIs are optional. It performs git queries and cross-repo inspections autonomously, meaning it can function with just local repository access but integrates platform data when CLIs are present.

How do I resume an unfinished engineering session safely?

Resuming an unfinished engineering session safely is handled by enforcing a hard bootstrap gate and respecting persistence state. The system identifies ongoing work, prevents unsafe continuations, and surfaces previous session context to ensure aligned and structured resumption.

When do I need structured repository analysis for engineering sessions?

Structured repository analysis for engineering sessions is needed when starting housekeeping, feature development, or deep coding work. It ensures teams begin with clear recommendations, cross-repo status awareness, and safety gates rather than manually inspecting project readiness.