diff --git a/common/personal/forge-preferences/SKILL.md b/common/personal/forge-preferences/SKILL.md index 2b5047f..0e1fc76 100644 --- a/common/personal/forge-preferences/SKILL.md +++ b/common/personal/forge-preferences/SKILL.md @@ -22,10 +22,23 @@ Store personal conventions that should not live in the generic forge interaction - If the correct CLI is missing, tell the user to install it or add it to `PATH`. - Do not use the wrong CLI as a fallback. -## Open Questions To Fill In Later +## Derived Preferences (auto-detected at runtime) -- Known personal Gitea hosts. -- GitHub usernames or organizations. -- Preferred PR title/body format. -- Preferred issue labels and milestones. -- Release naming and tagging conventions. +- Canonical forge remote: prefer `forge`, then default remote, then `origin`. +- Forge CLI: determined from remote URL (GitHub → `gh`, Gitea → `tea`). +- Known personal Gitea hosts and GitHub usernames/orgs are collected from the remote URL and git CLI at time of use — no hardcoded list. + +## Issue Labels + +See `triage-labels.md` in this directory for the canonical-to-actual label mapping. + +## PR Conventions + +- PR titles follow Conventional Commits: `type(scope): description`. + - Common types: `feat`, `fix`, `refactor`, `docs`, `chore`, `test`, `style`. +- PR body is freeform but should summarise the change and any breaking or noteworthy details. + +## Release Conventions + +- Tags follow semver: `v{major}.{minor}.{patch}` (e.g. `v1.2.3`). +- Releases are created from the tag with auto-generated or manually curated notes. diff --git a/common/personal/forge-preferences/triage-labels.md b/common/personal/forge-preferences/triage-labels.md new file mode 100644 index 0000000..b716855 --- /dev/null +++ b/common/personal/forge-preferences/triage-labels.md @@ -0,0 +1,15 @@ +# Triage Labels + +The skills speak in terms of five canonical triage roles. This file maps those roles to the actual label strings used in this repo's issue tracker. + +| Label in mattpocock/skills | Label in our tracker | Meaning | +| -------------------------- | -------------------- | ---------------------------------------- | +| `needs-triage` | `needs-triage` | Maintainer needs to evaluate this issue | +| `needs-info` | `needs-info` | Waiting on reporter for more information | +| `ready-for-agent` | `ready-for-agent` | Fully specified, ready for an AFK agent | +| `ready-for-human` | `ready-for-human` | Requires human implementation | +| `wontfix` | `wontfix` | Will not be actioned | + +When a skill mentions a role (e.g. "apply the AFK-ready triage label"), use the corresponding label string from this table. + +Edit the right-hand column to match whatever vocabulary you actually use.