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:
@@ -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.
|
||||||
Reference in New Issue
Block a user