dotfiles

Pi extensions and tool policy: extensions/*.ts, hooks, registerTool, promptGuidelines, registerCommand, footer/status UI, tool_result, session hooks, or subprocesses. Not for slash-command placement; use pi-command.

README, CHANGELOG, docs/, RFCs, ADRs, guides, or Markdown structure. Not for prose cleanup or archival work.

Prose cleanup for filler, hype, vague claims, repetition, detection tells, or uncited specifics. Not for Markdown architecture or archival work.

Requirements, user stories, acceptance/verification criteria, or testable outcomes. Not for PRD drafting (/prd) or Pi /goal prompts.

Use for /prd-it or to draft, refine, or review a Product Requirements Document. Not for acceptance criteria, planning, or Pi /goal prompts.

Pi session, trace, metrics, routing, workflow-friction, workflow-telemetry, usage, or local JSONL analysis with DuckDB. Use for aggregating or correlating Pi runtime logs. Not for adding telemetry, generic SQL/database design, or non-Pi logs.

Forgejo Actions: .forgejo/workflows, forgejo-runner, labels, secrets, workflow_dispatch, CI/CD, or deployment. Not for Git remotes, repository setup, or Forgejo APIs; use git-workflow.

Git operations, commits, branches, remotes, GitHub/GitLab/Forgejo repository setup, merge, rebase, reset, or history rewrite. Not for SSH client/server troubleshooting; use ssh. Not for Forgejo Actions; use forgejo-actions.

SSH client/server configuration and troubleshooting: ssh, sshd, keys, agents, known_hosts, authorized_keys, AuthorizedKeysCommand, ProxyJump, authentication, or host-key verification. Not for Git operations; use git-workflow.

Managed background terminals, bg_start/bg_status/bg_list/bg_kill, /ps, dev servers, watchers, or concurrent long-running shell commands. Not for timers or durable tasks.

SKILL.md, skill frontmatter/descriptions, activation triggers, agent definitions, or command/agent instructions. Not for Pi slash-command placement; use pi-command.

Analyze, validate, debug, troubleshoot, critique, red-team, adversarial, or what-could-go-wrong questions. Not for PR/diff review; use code-review.

Ansible YAML, playbooks, inventory, roles, handlers, ansible-playbook, ansible-lint, Molecule, or Galaxy.

API design, REST, GraphQL, or authentication patterns.

Generate approaches before implementation for design decisions, architecture choices, or multiple valid solutions.

Export, archive, save, or recover Brave tabs or Chromium session files.

Code, PR, diff, branch, or commit review; git diff, git show, or change comparison. Not for debugging or design critique.

C#/.NET, .cs, .csproj, .sln, dotnet, NuGet, EF, LINQ, DI, async/await, xUnit, or NUnit.

SQL, schemas, migrations, ORMs, query optimization, indexing, transactions, EXPLAIN, PostgreSQL, MySQL, SQLite, DynamoDB, or Redis.

Implementation strategy, architecture, experiments, or avoiding over-engineering. Not for edit-time diff consistency; use least-astonishment.

Dockerfile, docker-compose.yml, docker-compose, .dockerignore, .devcontainer, devcontainer.json, containers, images, orchestration, or Podman.

Go: .go, go.mod, go.sum, goroutines, channels, interfaces, go test, go vet, or concurrency.

Stress-test a plan or design, get grilled on a design, or "grill me".

justfile/Justfile, recipes, dotenv, recursive just, or cross-platform just. Not for workflow UX or shell scripting.

Kubernetes manifests, Helm charts, Kustomize, Argo CD, kubectl, helm, GitOps, or cluster rollout checks. Not for Docker-only files.

Focused, pattern-matching edits to existing code. Not for architecture strategy or pure git operations.

Logging, metrics, tracing, monitoring, alerting, SLOs, correlation/trace IDs, or log aggregation. Not for debugging without telemetry.

M365 scripting: Entra ID, Exchange, SharePoint, Teams, Graph, licensing, inventory, or tenant config. Not for unrelated PowerShell.

Read, search, extract, or render PDFs, including page-specific or visual questions.

Pi slash commands, prompt templates, workflow skills, or command placement. Not for skill authoring; use skills-engineer.

Only for badlogic/pi-mono or @mariozechner/pi-* upstream issues/PRs, approval, contributor gates, pkg:* labels, changelogs, or accepted fixes.

Write or improve Pi /goal, goal prompt files, long-running objectives, or goal_prompt_file.md. Not for PRDs or task planning.

Playwright specs, fixtures, traces, browsers, test projects, gated suites, or e2e Docker cleanup. Not for unit-test-only changes.

Save, archive, pack, encrypt, or commit sensitive local private/ files with Dolos.

Python, pyproject.toml, uv, pip, pytest, Pydantic, type hints, or Python patterns.

Reddit public .json search, subreddit listings, or a specific post.

Ruby/Rails: .rb, Gemfile, Rakefile, .gemspec, bundler, ActiveRecord, migrations, RSpec, minitest, or generators.

Rust: .rs, Cargo.toml, Cargo.lock, ownership, borrowing, lifetimes, traits, cargo build/test/run, Result/Option, or borrow checker.

Shell/PowerShell: .sh, .bash, .zsh, .ps1, Makefile fragments, CLI scripts, quoting, exits, traps, or cross-platform behavior. Not for workflow UX or Justfile routing.

Terraform: .tf, variables.tf, main.tf, outputs.tf, terraform.tfvars, .tfstate, HCL, init/plan/apply, or remote backends.