paseo-session-brief

Paseo Session Brief

This skill produces a short, actionable context brief for the current repo. It is meant for the start of a work session, not for deep implementation.

Use /paseo-project-bootstrap when the user wants setup scripts or generated .paseobility/ files. Use this skill when the user wants a readable brief in the conversation.

Goals

• identify the active project and git state
• read the most important docs and agent instructions
• identify likely install/dev/build/test commands
• summarize project shape and risk areas
• give the next agent or human a clean starting point

Core workflow

1. Confirm root and status:

   pwd
   git rev-parse --show-toplevel
   git remote -v
   git branch --show-current
   git status --short
   

2. When Paseo CLI is available, establish the live topology without mutation:

   paseo --version
   paseo daemon status --json
   paseo project ls --json
   paseo workspace ls --json
   paseo script ls --cwd <project-root> --json
   

   Do not restart the daemon or start workspace scripts for a brief.
3. List files with rg --files first.
4. Read available instruction sources:
   • README*
   • AGENTS.md
   • CLAUDE.md
   • .cursor/rules/**
   • .github/copilot-instructions.md
   • important files under docs/
5. Detect project commands from:
   • package.json
   • pyproject.toml, requirements*.txt
   • Cargo.toml
   • go.mod
   • Makefile, justfile, Taskfile.yml
   • paseo.json
6. Produce the brief. Do not edit files unless the user asks.

Reading strategy

Keep the brief lightweight:

• Read README and explicit instruction files first.
• For docs/, list files and read only obviously relevant overview, setup, architecture, contributing, or decision documents.
• Do not read every source file unless the repo is tiny or the user asks.
• Prefer command discovery over guessing.
• If generated .paseobility/context.md exists, read it and verify it against current git state.