From 92747d008ec106b8bd2e0359e9cd9d85ba2850e6 Mon Sep 17 00:00:00 2001
From: Lancelot <82611597+fastrevmd-lab@users.noreply.github.com>
Date: Fri, 9 Oct 2026 10:44:56 -0400
Subject: [PATCH] Add community health defaults

---
 .github/ISSUE_TEMPLATE/bug_report.yml      | 34 ++++++++++++++++++++++
 .github/ISSUE_TEMPLATE/config.yml          |  8 +++++
 .github/ISSUE_TEMPLATE/feature_request.yml | 34 ++++++++++++++++++++++
 .github/PULL_REQUEST_TEMPLATE.md           | 17 +++++++++++
 profile/README.md                          |  9 ++++++
 5 files changed, 102 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/bug_report.yml
 create mode 100644 .github/ISSUE_TEMPLATE/config.yml
 create mode 100644 .github/ISSUE_TEMPLATE/feature_request.yml
 create mode 100644 .github/PULL_REQUEST_TEMPLATE.md

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
new file mode 100644
index 0000000..54fddb2
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,34 @@
+name: Bug report
+description: Report a reproducible problem in a mechub project.
+title: "[Bug]: "
+labels:
+  - bug
+body:
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: Tell us what went wrong and include relevant error output.
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Version or commit
+      description: Which release, commit, or image tag were you using?
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: List the smallest reliable sequence that demonstrates the problem.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected result
+      description: What did you expect to happen instead?
+    validations:
+      required: true
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 0000000..45a8855
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security issues
+    url: https://github.com/mechubsec/.github/blob/main/SECURITY.md
+    about: Report suspected vulnerabilities privately using SECURITY.md.
+  - name: Questions and community discussion
+    url: https://github.com/orgs/mechubsec/discussions
+    about: Ask questions and share ideas in the mechub community discussions.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
new file mode 100644
index 0000000..9a93ee8
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -0,0 +1,34 @@
+name: Feature request
+description: Suggest an improvement to a mechub project.
+title: "[Feature]: "
+labels:
+  - enhancement
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem would this feature solve, and who experiences it?
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Version or commit
+      description: Which release or commit are you using today?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposal
+      description: Describe the behavior or interface you would like to see.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected result
+      description: What outcome would indicate that the problem is solved?
+    validations:
+      required: true
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 0000000..933a6b5
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,17 @@
+## Summary
+
+<!-- What does this change do, and why? -->
+
+## Linked issue
+
+Closes #
+
+## Tests run
+
+<!-- List the exact checks or tests you ran. -->
+
+## Checklist
+
+- [ ] Public text for security changes is class-level.
+- [ ] No secrets, credentials, customer data, or lab data are included.
+- [ ] CHANGELOG.md is updated when appropriate.
diff --git a/profile/README.md b/profile/README.md
index 5ab5c17..f2b4d2b 100644
--- a/profile/README.md
+++ b/profile/README.md
@@ -59,6 +59,15 @@ the version, not instead of it.
 No server in the family is tagged `stable` yet; all are running in the
 maintainer's lab, not production, regardless of version number.
 
+## Start here
+
+- **Foundation:** Start with [`mecmcp`](https://github.com/mechubsec/mecmcp) for shared MCP orchestration and deterministic change-control foundations.
+- **MCP servers:** Try [`rustjunosmcp`](https://github.com/mechubsec/rustjunosmcp) first, or [`rustunifimcp`](https://github.com/mechubsec/rustunifimcp) as a second released vendor-facing example.
+- **Data:** Explore [`ssdf`](https://github.com/mechubsec/ssdf) for the sovereign security data fabric.
+- **Skills & tools:** Use [`fwskillsshare`](https://github.com/mechubsec/fwskillsshare), [`firewallintentconverter`](https://github.com/mechubsec/firewallintentconverter), [`fwconfigsanitizer`](https://github.com/mechubsec/fwconfigsanitizer), or [`srxsync`](https://github.com/mechubsec/srxsync) for focused operator utilities.
+
+Get in touch / testers wanted: for questions, ideas, or testing feedback, join the [mechub Discussions](https://github.com/orgs/mechubsec/discussions). Report vulnerabilities privately via [SECURITY.md](https://github.com/mechubsec/.github/blob/main/SECURITY.md).
+
 ## Principles
 
 - **Self-hosted by default.** Your realm, your models, your rules.