Skip to content

chore: org-wide YAML issue forms + PR template at .github/ path#6

Draft
chazmaniandinkle wants to merge 1 commit intomainfrom
chore/issue-template-yaml-forms
Draft

chore: org-wide YAML issue forms + PR template at .github/ path#6
chazmaniandinkle wants to merge 1 commit intomainfrom
chore/issue-template-yaml-forms

Conversation

@chazmaniandinkle
Copy link
Copy Markdown
Contributor

What

Adds YAML issue forms at .github/ISSUE_TEMPLATE/:

  • bug.yml — structured bug report with project dropdown, required fields
  • feature.yml — structured feature request with project dropdown
  • config.yml — enables blank issues, adds Security contact link

Copies PR template to .github/PULL_REQUEST_TEMPLATE.md (same file,
inherited path).

Why

Per 2026-04-24 public-repo audit §OSS-readiness-gaps #4
(~/cog-workspace/.cog/run/trackh/public-repo-audit.md):

Issue templates are missing everywhere — neither repo-level nor
org-level. Every issue today is free-form.

GitHub surfaces org-default issue templates to member repos only
when they live under .github/ISSUE_TEMPLATE/ inside the
cogos-dev/.github repo — not at the root-level ISSUE_TEMPLATE/
directory this repo currently uses. The existing markdown templates
are a no-op for inheritance; they only apply to this repo itself.

This PR places YAML forms at the correct path so every public repo
(cogos, mod3, constellation, cog-sandbox-mcp, charts,
skills, research) picks them up automatically with no per-repo
changes.

Why YAML forms over the old markdown

  • Project dropdown is mandatory — no more "which repo is this?"
  • Required fields enforce structure at submission time
  • Reproduction steps pre-templated
  • Easier to parse programmatically for triage automation later

How

  • New directory .github/ISSUE_TEMPLATE/ with three YAML files
  • Copy of root PULL_REQUEST_TEMPLATE.md to .github/PULL_REQUEST_TEMPLATE.md
  • Root-level ISSUE_TEMPLATE/ and PULL_REQUEST_TEMPLATE.md left in
    place (they're a no-op for other repos but still serve this repo)

Verification after merge

  1. Open a new issue on cogos-dev/cogos → should show Bug Report
    and Feature Request forms as options, not a blank body.
  2. Open a new issue on cogos-dev/mod3 → same.
  3. Fire a test submission on a throwaway branch, close immediately.

Follow-up (not in this PR)

  • Deprecate the root-level ISSUE_TEMPLATE/ markdown files in a
    future cleanup PR once inheritance is verified.
  • Wire YAML field IDs into triage automation if/when we add one.

Per 2026-04-24 public-repo audit §OSS-readiness-gaps #4: every repo
in cogos-dev is missing issue templates, and the existing markdown
templates at this repo's root-level ISSUE_TEMPLATE/ directory do not
surface on member repos through org-default inheritance.

GitHub inherits defaults from the cogos-dev/.github repo ONLY when
they live under .github/ — not at the repo root. Adding the YAML
form versions at .github/ISSUE_TEMPLATE/ so every cogos-dev repo
(including cogos, mod3, constellation, cog-sandbox-mcp, charts,
skills, research) picks them up automatically.

YAML forms over the old markdown: enforces structured fields
(dropdowns + required fields) instead of free-form bodies, which
cuts triage work materially.

Leaving the root-level ISSUE_TEMPLATE/ and PULL_REQUEST_TEMPLATE.md
in place for this repo's own local use. Also copying the PR template
to .github/PULL_REQUEST_TEMPLATE.md so the same inheritance applies.

config.yml adds a 'Security report' link pointing at SECURITY.md, to
redirect vulnerability reports out of public issue threads.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant