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`.
- 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.