session-start

Read workplans, development notes, and GitHub issues to report a session goal.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/oletizi/writingcontrol.org --skill session-start-oletizi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-start
Source: https://github.com/oletizi/writingcontrol.org/tree/main/.claude/skills/session-start
Command: npx skills add https://github.com/oletizi/writingcontrol.org --skill session-start-oletizi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bootstrap sessions by reading the feature workplan, the latest DEVELOPMENT-NOTES entry, and open issues to report a concise session goal.

Core Features & Use Cases

  • Reads the current feature workplan and workplan.md to summarize the feature's current phase, completed tasks, and next steps.
  • Reads the latest DEVELOPMENT-NOTES.md entry to capture what was accomplished, what failed, and any course corrections.
  • Checks open GitHub issues to surface top unresolved items and guiding priorities for the session.
  • Reports a clear session goal and context back to the user for confirmation before any actions are taken.

Quick Start

Confirm the session goal to bootstrap context before any actions are taken.

Frequently Asked Questions about session-start

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

FAQPage Schema
How do I bootstrap a development session with clear goals from git and markdown files?

To bootstrap a development session, the Skill parses repository state from git, reads workplan markdown files, and queries open GitHub issues to present a concise session goal. It summarizes the current phase, completed tasks, and next steps for confirmation before taking action.

What is the best way to track editorial workflow progress across worktrees and DEVELOPMENT-NOTES?

Tracking editorial workflow progress involves reading the latest DEVELOPMENT-NOTES.md entry and feature workplans to capture accomplishments, failures, and course corrections. This process surfaces top unresolved items and guiding priorities to establish a clear session goal and context.

How does session management for feature work integrate open GitHub issues with local development notes?

Session management integrates GitHub issues by querying open issues via gh to surface unresolved items, then reading local DEVELOPMENT-NOTES.md and workplan files. It combines this repository state to report a session goal, expected outcomes, and top actions back to the user.

Can I use this session-start workflow for git-driven projects with feature folders in docs?

Yes, this session-start workflow is applicable when planning editorial or feature work in a git-driven project. It specifically scopes worktrees and feature folders located in docs/1.0/001-IN-PROGRESS alongside DEVELOPMENT-NOTES.md and GitHub issues to parse repository state.

Do I need the GitHub CLI installed to bootstrap sessions and query open issues?

Yes, querying open GitHub issues to surface top unresolved items requires the gh CLI. The session bootstrapping process depends on gh to check open issues and parse repository state from git before presenting a session goal.

Why does the session goal require confirmation before any development actions are taken?

The session goal requires confirmation to ensure the parsed repository state, markdown summaries, and open issues accurately reflect the current context. This validation step prevents incorrect actions by verifying the gathered workplan and development notes align with user expectations.