session-plan SKILL.md skillA

session-plan from kanevry/session-orchestrator is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kanevry/session-orchestrator/session-plan@git:20260909.d4c51bd

Pins git:20260909.d4c51bd in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kanevry/session-orchestrator
Path
skills/session-plan/SKILL.md
Versions recorded
8
Latest version
git:20260909.d4c51bd, committed Sep 9, 2026
First version recorded
Jul 29, 2026
Size
39,336 bytes
Repository stars
53
License
MIT

Creates a structured wave execution plan with role-based assignment after user alignment. Decomposes agreed tasks into waves resolved from the session mode by `scripts/session-shape.mjs`, with optimal agent assignment, dependency ordering, and inter-wave checkpoints. Activated by session-start after Q&A phase completes.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

> **Platform Note:** Project agents live in `<state-dir>/agents/` where `<state-dir>` is `.claude/` (Claude Code), `.codex/` (Codex CLI), `.cursor/` (Cursor IDE), or `.pi/` (Pi). On Cursor IDE and Pi v1, parallel agent dispatch is not available — present wave tasks as a sequential execution list instead. See `skills/_shared/platform-tools.md`.

# Session Plan Skill

> Project-instruction file resolution: `CLAUDE.md` and `AGENTS.md` (Codex CLI) are transparent aliases — see [skills/_shared/instruction-file-resolution.md](../_shared/instruction-file-resolution.md). Wherever this skill mentions `CLAUDE.md`, the alias rule applies.

## Phase 0.5: Parallel-Aware Preamble

> Skip silently when `persistence: false` in Session Config.

Before any Phase 1 work, run the parallel-aware preamble per `skills/_shared/parallel-aware-preamble.md`. The preamble detects other active sessions in the worktree-family via `findPeers(repoRoot, { mySessionId })`, classifies the caller's mode via `classifyMode(callerMode)` against the exclusivity-matrix, and either:

- Returns `PASS_THROUGH` (no other session / `always-ok` mode) → continue to Phase 1
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kanevry/session-orchestrator/session-plan@sha256:f018385814c10101

The line at the top of this page pins the label git:20260909.d4c51bd, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_c6a5emu6p6ti3rih.svg)](https://markdownregistry.com/a/art_c6a5emu6p6ti3rih)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 8 versions of this file, between Jul 29, 2026 and Sep 9, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20260909.d4c51bd latest2026-09-09 d4c51bd 39,336 BA view · diff
git:20260909.bd6f39b2026-09-09 bd6f39b 51,730 BA view · diff
git:20260908.362e3c32026-09-08 362e3c3 48,399 BA view · diff
git:20260906.9b0a5552026-09-06 9b0a555 47,665 BA view · diff
git:20260825.a19e8642026-08-25 a19e864 43,129 BA view · diff
git:20260823.4d7b3232026-08-23 4d7b323 41,903 BA view · diff
git:20260815.957b21b2026-08-15 957b21b 41,640 BA view · diff
git:20260729.594bb602026-07-29 594bb60 41,085 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (39336 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

kanevry/session-orchestrator · 53 stars · license MIT · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_c6a5emu6p6ti3rih
GET https://markdownregistry.com/api/v1/resolve?ref=kanevry/session-orchestrator/session-plan
GET https://markdownregistry.com/api/v1/blob/f018385814c101016de3a9078d6c4c5b9153b3d5619685b9045c49496382e036

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from kanevry/session-orchestrator

architecture SKILL.md skill
kanevry/session-orchestrator · .agents/skills/architecture/SKILL.md · Use when the user asks to improve architecture, find refactoring opportunities, surface deepening opportunities…
git:20261003.c34ec50 · audit A · 53 stars
autopilot SKILL.md skill
kanevry/session-orchestrator · .agents/skills/autopilot/SKILL.md · Use this skill when running an autonomous session-orchestration loop. Chains session-start → session-plan →…
git:20260919.176b605 · audit A · 53 stars
bootstrap SKILL.md skill
kanevry/session-orchestrator · .agents/skills/bootstrap/SKILL.md · Use this skill when scaffolding the minimum repository structure required by session-orchestrator. Invoked…
git:20260919.176b605 · audit A · 53 stars
brainstorm SKILL.md skill
kanevry/session-orchestrator · .agents/skills/brainstorm/SKILL.md · Use when you have a feature idea but the scope or UX is still ambiguous — runs a lightweight Socratic design dialogue…
git:20260919.176b605 · audit A · 53 stars
claude-md-drift-check SKILL.md skill
kanevry/session-orchestrator · .agents/skills/claude-md-drift-check/SKILL.md · Use when detecting drift between CLAUDE.md (or AGENTS.md, the Codex CLI alias) / _meta narrative and live repository…
git:20261003.c34ec50 · audit A · 53 stars
close SKILL.md skill
kanevry/session-orchestrator · .agents/skills/close/SKILL.md · End session with verification, commits, and documentation
git:20260919.176b605 · audit A · 53 stars
convergence-monitoring SKILL.md skill
kanevry/session-orchestrator · .agents/skills/convergence-monitoring/SKILL.md · Monitor iterative improvement loops for convergence. Three signals — shrinking diff, pass-rate plateau, velocity —…
git:20260919.176b605 · audit A · 53 stars
debug SKILL.md skill
kanevry/session-orchestrator · .agents/skills/debug/SKILL.md · Use when encountering any bug, test failure, build break, or unexpected behavior — runs a 4-phase systematic debugging…
git:20260919.176b605 · audit A · 53 stars
deepen SKILL.md skill
kanevry/session-orchestrator · .agents/skills/deepen/SKILL.md · Make a task deeper, not bigger. Use when the user asks for a deeper or more ambitious version of a task (tiefer, geh…
git:20261027.7eb9aed · audit A · 53 stars
discovery SKILL.md skill
kanevry/session-orchestrator · .agents/skills/discovery/SKILL.md · Use this skill when running systematic quality discovery and issue detection. Runs modular probes adapted to the…
git:20260919.176b605 · audit A · 53 stars
dispatcher SKILL.md skill
kanevry/session-orchestrator · .agents/skills/dispatcher/SKILL.md · Use when you want the orchestrator to pick the next repo to work on across your whole portfolio — it enumerates…
git:20260919.176b605 · audit A · 53 stars
docs-orchestrator SKILL.md skill
kanevry/session-orchestrator · .agents/skills/docs-orchestrator/SKILL.md · Use this skill when orchestrating documentation generation and updates within a session. Maps session scope to…
git:20260919.176b605 · audit A · 53 stars

Every file in kanevry/session-orchestrator

Other files named session-plan

session-plan SKILL.md skill
kanevry/session-orchestrator · .cursor/skills/session-plan/SKILL.md · Creates a structured wave execution plan with role-based assignment after user alignment. Decomposes agreed tasks into…
git:20260909.bd6f39b · audit A · 53 stars
session-plan SKILL.md skill
kanevry/session-orchestrator · .agents/skills/session-plan/SKILL.md · Creates a structured wave execution plan with role-based assignment after user alignment. Decomposes agreed tasks into…
git:20260919.176b605 · audit A · 53 stars
session-plan SKILL.md skill
kanevry/session-orchestrator · .codex-plugin/skills/session-plan/SKILL.md · Creates a structured wave execution plan with role-based assignment after user alignment. Decomposes agreed tasks into…
git:20260909.bd6f39b · audit A · 53 stars

Browse by kind, by grade A, or by owner.