launch-project

Loads or scaffolds project context from cwd or prompt for lifecycle skills.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/mikestopcontinues/agent-skills --skill launch-project-mikestopcontinues
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: launch-project
Source: https://github.com/mikestopcontinues/agent-skills/tree/main/claude/skills/launch-project
Command: npx skills add https://github.com/mikestopcontinues/agent-skills --skill launch-project-mikestopcontinues

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Lifecycle skills like create-spike, create-plan, and execute-plan need a resolved project context before they can act, but determining which project the user means from the working directory or a vague prompt is error-prone. This Skill centralizes that resolution, loading canonical project files or scaffolding a new project skeleton, so calling skills never guess. ## Core Features & Use Cases - Project resolution: Detects the target project from the current working directory (via git root and the docs/xNNN-name convention) or from an explicit name in the prompt, with exact and descriptive matching. - Context loading or scaffolding: Reads README.md, tasks.md, decisions/, and notes/ for existing projects, or invokes the yolo CLI to scaffold a new project skeleton with canonical structure. - Structured metadata and bounded refusal: Returns path, name, status, open spikes/plans, and decision/note counts to the calling skill, and refuses with a stable error shape when no project is determinable. - Use Case: A user runs /create-plan while inside docs/x003-auth/; launch-project resolves the project, loads its charter and open decisions, and hands metadata to create-plan so planning starts immediately. ## Quick Start Ask the agent to launch the project named x000-yolo-project so its context is loaded before running any lifecycle skill.

Frequently Asked Questions about launch-project

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

FAQPage Schema
How do I load project context before running a lifecycle skill?▼

Invoke launch-project with a project name or from inside the project directory. It resolves the target from cwd or the prompt, loads README.md, tasks.md, decisions, and notes, then returns metadata to the calling skill.

How does launch-project resolve which project to use?▼

It first checks whether the working directory sits inside a docs/xNNN-name folder using git rev-parse. If not, it matches an xNNN-name token or descriptive name from the prompt against docs/x*/ directories, refusing when ambiguous.

Can launch-project create a new project automatically?▼

Yes, but only when a supplied name matches no existing project. It runs the yolo new project CLI to scaffold the canonical layout with README charter, tasks.md, and empty decisions and notes directories, then loads it as existing.

What happens when no project can be determined?▼

It returns a structured refusal with reason no-project-determinable or ambiguous-descriptive-name. The calling skill asks the user for the project name and may retry exactly once before surfacing the refusal.

Does launch-project modify tasks.md or store session state?▼

No. Loading is read-only against tasks.md, and it writes no filesystem state marker. On session resume the project is re-derived from the working directory alone, following the filesystem-derived-state rule.