docs(forge-preferences): replace open questions with derived preferences and add conventions

- Replace hardcoded open questions with runtime-derived preferences for
  forge remote, CLI, and host/username detection
- Add issue label mapping reference to triage-labels.md
- Add PR title/body conventions following Conventional Commits
- Add release tagging conventions with semver format
This commit is contained in:
2026-06-23 23:58:12 -04:00
parent 91e643553e
commit 510d4be99c
2 changed files with 34 additions and 6 deletions
+19 -6
View File
@@ -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`. - 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. - 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. - Canonical forge remote: prefer `forge`, then default remote, then `origin`.
- GitHub usernames or organizations. - Forge CLI: determined from remote URL (GitHub → `gh`, Gitea → `tea`).
- Preferred PR title/body format. - Known personal Gitea hosts and GitHub usernames/orgs are collected from the remote URL and git CLI at time of use — no hardcoded list.
- Preferred issue labels and milestones.
- Release naming and tagging conventions. ## 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.
@@ -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.