Files
pad/skills
xarmian 4d02616d54 refactor(skill): generalize /pad for domain-agnostic workspaces (TASK-613) (#145)
* refactor(skill): generalize /pad for domain-agnostic workspaces (TASK-613)

The /pad skill is baked into the binary and runs the same regardless
of whether the workspace is a software project, a hiring pipeline, or
a research notebook. This change strips the software-centric framing
without losing any dev workflow — dev-specific rules that used to live
in SKILL.md are already shipped as conventions by the software
templates (TASK-612).

Changes
-------
- Always-on conventions blurb now frames trigger vocabulary as
  workspace-dependent and gives non-software examples (anonymize
  candidate names, always cite sources).
- "Before Performing Work" no longer hardcodes on-commit / on-pr-create
  as if they were universal. Replaced with a generic X→on-X mapping
  and a note that each template defines its own trigger set, with
  the software set called out as the common case.
- "Creating items" examples mix dev and non-dev patterns and add a
  guiding note to match intent to the workspace's actual collections.
- Planning workflow drops "Each task should be PR-sized" — replaced
  with a domain-neutral sizing guideline (software=PR, hiring=loop,
  research=question, etc.). PR-sizing for software workspaces is
  captured in the template's conventions.
- Onboarding workflow now prefers the template's onboarding playbook
  as its first step, falls back to the codebase scan only when a
  playbook isn't present or is software-flavored. Makes room for
  hiring/interviewing/research templates to ship their own
  onboarding flows without skill churn.
- Key principle #7 ("Keep it practical — tasks should be PR-sized")
  rewritten to reference the workspace's conventions.

No CLI, API, or store changes — skill file only.

Parent: PLAN-609.

* fix(skill): replace literal on-X placeholder, include playbook triggers

Per Codex review on PR #145:

- The on-X placeholder in the pre-action example commands would be
  run literally by an agent and return 0 results, causing required
  conventions to be skipped. Replaced with explicit <trigger> angle-
  bracket placeholders plus concrete examples (on-implement,
  on-commit, on-review) an agent can substitute or run directly.
- Software playbooks use a slightly different trigger vocabulary
  from software conventions (on-triage, on-release, on-review,
  on-deploy, manual). Updated the \"inspect the schema\" guidance
  to call out that agents should inspect BOTH the Conventions and
  Playbooks schemas to discover triggers, not the Conventions one
  alone.
2026-04-18 01:35:04 -04:00
..