From 5914cfdaa8f24159759726bbda3ed1ba40dd79ce Mon Sep 17 00:00:00 2001 From: Kirk Marple Date: Wed, 14 Oct 2026 14:47:40 -0700 Subject: [PATCH] Document required priorities for active issues --- CONTRIBUTING.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c89590b..ad7e70d 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -10,6 +10,14 @@ Set the native GitHub issue type explicitly: Use labels for independent information such as area, priority, phase or Factory role. Do not add redundant `bug`, `enhancement`, `feature` or `task` classification labels. Preserve required role labels such as `factory:objective` and `factory:work-item`. +Maintainers and agents must assign exactly one existing priority when creating an issue or triaging the active backlog. The Clockgrove convention is: + +- `P0`: urgent security/data loss, duplicate effects or stranded work. +- `P1`: current critical-path delivery or incorrect behavior with a supported workaround. +- `P2`: low-impact bugs, optional improvements, cleanup or deferred qualification. + +Work Items normally inherit their parent's priority unless their own impact justifies a difference. Verify priority after issue creation or Factory projection, and preserve an existing priority unless evidence supports a change. Native type and blocked status do not determine priority. If the target has no configured priority labels, have its maintainer establish the approved convention rather than inventing a fallback. + Issue forms must set their top-level `type`. When creating an issue through a CLI or API, supply the type explicitly and verify the returned issue's type and labels. Do not assume a title or label assigned the type, and do not leave issues untyped when an appropriate native type is available. An issue's type or Project placement does not authorize execution, spending or deployment. Follow the target repository's existing approval and delivery rules. Keep credentials, private source and raw agent transcripts out of public issues.