diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..ca75bf6 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,15 @@ +# Quantum-L9 org-wide issue template chooser config. +# https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository + +blank_issues_enabled: false + +contact_links: + - name: Security Vulnerability Report + url: https://github.com/Quantum-L9/.github/security/policy + about: Do not open a public issue for security vulnerabilities. Follow SECURITY.md instead. + - name: Governance / CANONICAL_LAW Question + url: https://github.com/Quantum-L9/Cursor-Governance/blob/main/CANONICAL_LAW.md + about: For questions about governance policy, symlink contracts, or CANONICAL_LAW.md, read the policy source of truth first. + - name: CI Kernel API Contract + url: https://github.com/Quantum-L9/.github/blob/main/workflow-interface-registry.yml + about: For questions about kernel inputs/outputs/versioning, check the machine-readable registry before filing an issue. diff --git a/.github/labeler.yml b/.github/labeler.yml new file mode 100644 index 0000000..4158e73 --- /dev/null +++ b/.github/labeler.yml @@ -0,0 +1,42 @@ +# Path-based PR auto-labeling config for actions/labeler. +# Mirrors the blast-radius mapping already defined in .github/CODEOWNERS — +# keep both files in sync when adding new top-level paths. + +area:ci-templates: + - changed-files: + - any-glob-to-any-file: "workflow-templates/**" + +area:ci-pack: + - changed-files: + - any-glob-to-any-file: "l9-ci-pack/**" + +area:governance: + - changed-files: + - any-glob-to-any-file: + - "workflow-interface-registry.yml" + - "docs/adr/**" + +area:ops: + - changed-files: + - any-glob-to-any-file: "ops/**" + +area:issue-templates: + - changed-files: + - any-glob-to-any-file: ".github/ISSUE_TEMPLATE/**" + +area:community-health: + - changed-files: + - any-glob-to-any-file: + - "CODE_OF_CONDUCT.md" + - "CONTRIBUTING.md" + - "SECURITY.md" + - "SUPPORT.md" + - "PULL_REQUEST_TEMPLATE.md" + +area:org-profile: + - changed-files: + - any-glob-to-any-file: "profile/**" + +area:ci-self: + - changed-files: + - any-glob-to-any-file: ".github/workflows/**" diff --git a/.github/workflows/labeler.yml b/.github/workflows/labeler.yml new file mode 100644 index 0000000..7e57a1f --- /dev/null +++ b/.github/workflows/labeler.yml @@ -0,0 +1,32 @@ +# Auto-labels PRs by changed path using .github/labeler.yml. +# Read-only trigger (pull_request_target) with minimal permissions — never +# executes PR branch code, only reads the diff and applies labels. +name: PR Labeler + +on: + pull_request_target: + types: [opened, synchronize, reopened] + +permissions: + contents: read + pull-requests: write + +concurrency: + group: pr-labeler-${{ github.workflow }}-${{ github.event.pull_request.number }} + cancel-in-progress: true + +jobs: + label: + name: Apply path-based labels + runs-on: ubuntu-latest + timeout-minutes: 5 + permissions: + contents: read + pull-requests: write + steps: + - name: actions/labeler + uses: actions/labeler@8558fd74291d67161a8a78ce36a881fa63b766a9 # v5.0.0 + with: + repo-token: "${{ secrets.GITHUB_TOKEN }}" + configuration-path: .github/labeler.yml + sync-labels: true diff --git a/FUNDING.yml b/FUNDING.yml new file mode 100644 index 0000000..7e1d6ce --- /dev/null +++ b/FUNDING.yml @@ -0,0 +1,11 @@ +# Quantum-L9 org-wide funding configuration. +# https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/displaying-a-sponsor-button-in-your-repository +# +# No public sponsor links are configured. This is an internal engineering org; +# entries are intentionally left blank rather than omitting the file, so any +# future decision to enable a sponsor button is a one-line change, not a new +# file requiring CODEOWNERS/governance re-review. +# +# github: [] +# open_collective: # '' +# custom: # [''] diff --git a/docs/adr/README.md b/docs/adr/README.md new file mode 100644 index 0000000..b7471a5 --- /dev/null +++ b/docs/adr/README.md @@ -0,0 +1,38 @@ +# Architecture Decision Records (ADRs) + +This directory holds the org-wide ADR template. ADRs record significant, +hard-to-reverse technical or architectural decisions — not routine changes. + +## When to write an ADR + +Write one when a decision: + +- Changes a public contract (kernel API, CLI, schema, workflow interface) +- Introduces, replaces, or retires a dependency, provider, or kernel +- Establishes a convention other repos/teams are expected to follow +- Reverses or supersedes a prior decision + +Skip it for routine bug fixes, dependency bumps, or anything reversible with a +single PR revert. + +## How to use this template + +1. Copy [`template.md`](./template.md) into **your repository's own** + `docs/adr/` directory (this `.github` repo only hosts the template; ADRs + themselves are recorded per-repo, next to the code they govern). +2. Name the file `docs/adr/NNNN-short-title.md`, using the next sequential + 4-digit number for that repo. +3. Fill in every section. Leave `Considered Options` even if only one option + was viable — record *why* alternatives were rejected. +4. Set `Status: Proposed` and open a PR. Reviewers should not approve a + status change to `Accepted` without discussion of the tradeoffs section. +5. If a later ADR reverses this one, do not delete the old file — set its + status to `Superseded by ADR-NNNN` and link both directions. + +## Relationship to CANONICAL_LAW.md + +ADRs are decision *history* (why we chose X over Y, and when). They do not +replace or override [`CANONICAL_LAW.md`](https://github.com/Quantum-L9/Cursor-Governance/blob/main/CANONICAL_LAW.md), +which is the current, binding policy source of truth. If an ADR's outcome +changes a rule in `CANONICAL_LAW.md`, that document must be updated in the +same PR — the ADR records the reasoning, `CANONICAL_LAW.md` records the rule. diff --git a/docs/adr/template.md b/docs/adr/template.md new file mode 100644 index 0000000..04caf9f --- /dev/null +++ b/docs/adr/template.md @@ -0,0 +1,69 @@ +# ADR-NNNN: + + + +## Status + + +Proposed + +**Date:** YYYY-MM-DD +**Deciders:** +**Related:** + +--- + +## Context and Problem Statement + + + +## Decision Drivers + + + +- +- +- + +## Considered Options + +1. +2. +3. + +## Decision Outcome + +**Chosen option:** "", because . + +### Consequences + +- Good, because +- Bad, because +- Neutral, because + +## Pros and Cons of the Options + + + +### + +- Good, because +- Bad, because + +### + +- Good, because +- Bad, because + +## Links + +