paseo-project ยท diff
git:20261013.0234766 to git:20261020.1d9fdc5
31 added, 29 removed. Audit A to A.
---
name: paseo-project
description: >-
Summarize a repository or prepare its Paseo environment when the user asks
- for a project brief, handoff summary, initial setup, environment repair, or
- .paseobility context generation. Ordinary coding and session resumption do
- not trigger this skill.
+ for a project brief, what a repo is or how to run it, a handoff summary,
+ initial setup, environment repair, or .paseobility context generation.
+ Ordinary coding and session resumption do not trigger this skill.
---
# Paseo Project
- This combines `/paseo-session-brief` and `/paseo-project-bootstrap`. Select the
- mode from the requested outcome; do not run both sequentially by default.
+ This combines `/paseo-session-brief` and `/paseo-project-bootstrap`. Pick the
+ mode from the requested outcome.
- A readable overview, commands, or handoff: [brief mode](references/brief.md).
- This mode is read-only and creates no context files.
- Initial setup, environment repair, skill installation, or generated context:
- [setup mode](references/setup.md). Run only the requested operations.
+ [setup mode](references/setup.md).
## Shared context
- Confirm the project root and current git state. Reuse the conversation's
- verified context or existing `.paseobility/` files, checking freshness before
- relying on them. Read only missing or changed material relevant to the request:
- README, applicable agent instructions, overview/setup docs, and command manifests.
- Do not repeat a repository survey just because a new session began.
+ Confirm the project root and git state. Reuse the conversation's verified
+ context and existing `.paseobility/` files after a freshness check (compare
+ their date with recent commits and changed manifests). Read only missing or
+ changed material: README, applicable agent instructions, overview/setup docs,
+ command manifests. Do not resurvey a repository just because a session began.
- A Git repository root, monorepo package directory and registered Paseo workspace
- can be different. Record which one each command targets. Read nearer/nested
- `AGENTS.md` for selected modules; generated `.paseobility` context is a snapshot
- and never replaces applicable current instructions.
+ Keep `.paseobility/` context current: when it is missing or stale and you have
+ just learned the project, write or refresh it so the next session can reuse it
+ instead of resurveying. It is local state; if the repository does not already
+ ignore `.paseobility/`, add it to `.git/info/exclude` rather than `.gitignore`.
+ Generated context is a snapshot and never overrides current `AGENTS.md`
+ instructions, including nested ones for selected modules.
- Only inspect Paseo runtime when the request concerns its setup or operation.
- Use `paseo --version` and `paseo daemon status --json` for the selected host;
- `paseo project ls --json` and `paseo workspace ls --json` identify live records.
- Do not infer workspace identity solely from `pwd`: aliases/symlinks may differ
- from registered paths. If `paseo script ls --cwd <path> --json` reports
+ A Git root, monorepo package and registered Paseo workspace can differ; record
+ which one each command targets.
+
+ Inspect Paseo runtime only when the request concerns it: `paseo --version`,
+ `paseo daemon status --json`, `paseo project ls --json`,
+ `paseo workspace ls --json`. Do not infer workspace identity from `pwd` alone;
+ aliases/symlinks may differ. If `paseo script ls --cwd <path> --json` reports
`WORKSPACE_NOT_FOUND`, resolve the existing workspace and use
- `paseo script ls --workspace <id> --json`. Do not create a duplicate record.
- An empty script list is valid; never invent script names.
+ `--workspace <id>`; do not create a duplicate record. An empty script list is
+ valid; never invent script names.
- Prefer the current project. New workspaces, external clones, dependency installs,
- servers, and generated files require a reason within the user's requested scope.
- Never restart the daemon as part of a brief or skill install. Preserve unrelated
- changes, running work, and private state. Report secrets only by redacted metadata.
+ Never restart the Paseo daemon (other agents depend on it). Preserve unrelated
+ changes, running work and private state. Report secrets only as redacted
+ metadata.
- Return a concise result fitted to the selected mode, with actual evidence and
- limitations. A generated context file is not proof that an app works.
+ Return a concise result with actual evidence and limitations. A context file is
+ not proof that the app works.