# AGENTS.md

## Project

**yoke-pi** — a pi.dev package of workflow skills adapted from yoke.

The repository is moving away from Claude Code. Legacy Claude files may still exist during migration, but pi-facing work should use the pi conventions below.

## Pi package

`package.json` is the source of truth for the pi package manifest:

```json
{
  "pi": {
    "skills": ["./skills"]
  }
}
```

Local development:

```bash
pi install -l .
pi
# then /reload after edits
```

Recommended companion package for interactive questions:

```bash
pi install npm:pi-ask-user
```

## Skill status

Pi-adapted and usable now:

- `/skill:grill` — interactive plan grilling through `ask_user`.
- `/skill:grill-docs` — grilling plus `CONTEXT.md` and ADR updates.
- `/skill:handoff` — save a handoff document to the OS temp directory.
- `/skill:gca` — smart git staging and commits.
- `/skill:help` — pi-specific help.
- `/skill:gst` — repository status report.
- `/skill:gp` — git push with checks and report.
- `/skill:prd` — PRD synthesis and optional GitHub issue publishing.
- `/skill:issues` — vertical-slice GitHub issue generation.

Deprecated / pi-port pending:

- `/skill:bootstrap`
- `/skill:do`
- `/skill:explore`
- `/skill:fix`
- `/skill:plan`
- `/skill:pr`
- `/skill:review`
- `/skill:sync-docs`
- `/skill:task`

Pending skills are marked with `disable-model-invocation: true` so pi should not auto-select them. They may still be invoked explicitly for migration/debugging, but they contain Claude-specific instructions until ported.

## Repo-local maintainer skills

Versioned project-local maintainer skills live under `.pi/skills/`:

- `/skill:yoke-create` — create or port yoke-pi skills.
- `/skill:yoke-release` — release yoke-pi from `package.json`.
- `/skill:yoke-validate` — validate changed skills and docs for pi compatibility.
- `/skill:journal` — append concrete session changes to `journal.md`.

They are marked `disable-model-invocation: true` and should be invoked explicitly only while working in this repository.

## Migration rules

- Use `/skill:<name>` in docs and skill text, not `/yoke:<name>`.
- Use `ask_user` for structured interactive questions.
- Replace `$ARGUMENTS` with “user input after `/skill:<name>`”.
- Replace `CLAUDE.md` as the target project instruction file with `AGENTS.md`.
- Replace `.claude/yoke-context.md` with `.pi/yoke-context.md` when bootstrap is ported.
- Avoid `${CLAUDE_PLUGIN_ROOT}` in pi-facing skills. Prefer package-local references, relative skill references, or pi extension tools.
- Do not add new Claude Code hooks or marketplace metadata.

## Formatting

```bash
pnpm run format
pnpm run format:check
```

Config: `.prettierrc.json`.