docs: refresh org profile and add complete community health defaults - #19
Merged
Merged
Conversation
- profile: current install paths (npm CLI + Homebrew casks), docs and feedback links, and a grouped directory of every public repository - add CODE_OF_CONDUCT, SUPPORT, default issue forms and config, default PR template, AGENTS.md, and llms.txt - root README documents what each default file does and what overrides it - CONTRIBUTING: workflow steps, agent-assisted contribution rules, links to conduct, security, and support - SECURITY: route reports to OpenCoven/coven when the affected repository has private vulnerability reporting disabled (true for most repos today) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Val Alexander <val@opencoven.ai>
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
Issue forms are stored outside GitHub’s required default-template path, and several organization-wide documents need corrected scope or reporting guidance.
Review effort: Balanced
Findings: 2
Open (3)
What changed in this PR
Refreshes OpenCoven’s organization profile and introduces shared community-health guidance.
Changes:
- Updates installation guidance and the public project directory.
- Adds issue forms, support, conduct, PR, and agent guidance.
- Clarifies contribution and private vulnerability-reporting workflows.
| File | Description |
|---|---|
AGENTS.md |
Adds repository guidance and verification steps. |
CODE_OF_CONDUCT.md |
Defines community standards and enforcement. |
CONTRIBUTING.md |
Expands contribution and agent-assisted-work guidance. |
ISSUE_TEMPLATE/bug_report.yml |
Adds a bug-report form. |
ISSUE_TEMPLATE/config.yml |
Adds issue-picker contact links. |
ISSUE_TEMPLATE/feature_request.yml |
Adds a feature-request form. |
PULL_REQUEST_TEMPLATE.md |
Adds a default PR checklist. |
README.md |
Documents repository contents and defaults. |
SECURITY.md |
Adds fallback private-report routing. |
SUPPORT.md |
Documents support channels and expectations. |
llms.txt |
Adds agent-oriented navigation and boundaries. |
profile/README.md |
Refreshes installation, projects, and contribution links. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
| Report conduct concerns **privately**: | ||
|
|
||
| - **Discord:** message a server moderator or admin directly. | ||
| - **GitHub:** contact a maintainer of the affected repository through a private channel you have already verified, or use GitHub's [report content](https://docs.github.com/en/communities/maintaining-your-safety-on-github/reporting-abuse-or-spam) tools. |
Comment on lines
+5
to
+7
| 1. **Run `coven doctor`.** It detects installed harnesses and prints fix hints for most setup problems. | ||
| 2. **Check the docs.** [docs.opencoven.ai](https://docs.opencoven.ai) covers installation, the CLI, the daemon, harnesses, memory, and [troubleshooting](https://docs.opencoven.ai/docs/reference/troubleshooting). | ||
| 3. **Read the repository README.** Each project documents its own setup, platform support, and known limits. |
|
|
||
| Organization profile, community health files, and shared GitHub defaults for [OpenCoven](https://github.com/OpenCoven). | ||
|
|
||
| The public organization page is rendered from [`profile/README.md`](profile/README.md). The other files here are **defaults**: GitHub uses them in any OpenCoven repository that does not ship its own copy. |
BunsDev
added a commit
that referenced
this pull request
Oct 2, 2026
GitHub reads default community health files from this repository's .github/ folder before the root. After #19 added root ISSUE_TEMPLATE/ and PULL_REQUEST_TEMPLATE.md as organization-wide defaults, the governance forms and PR template in .github/ would have replaced them for every OpenCoven repository without its own templates. - move governance issue forms to the root ISSUE_TEMPLATE/ beside the bug and feature forms; label their descriptions as OpenCoven/.github-only - drop .github/ISSUE_TEMPLATE/config.yml; the root config already routes security reports to SECURITY.md - move the governance PR checklist to docs/templates/ and link it from the default PR template; update GOV-010 evidence to the new path Verified: ./scripts/agent-check fast (97 tests OK, validation passed, generated views current); issue forms parse as YAML. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Val Alexander <val@opencoven.ai>
BunsDev
added a commit
that referenced
this pull request
Oct 2, 2026
GitHub reads default community health files from this repository's .github/ folder before the root. After #19 added root ISSUE_TEMPLATE/ and PULL_REQUEST_TEMPLATE.md as organization-wide defaults, the governance forms and PR template in .github/ would have replaced them for every OpenCoven repository without its own templates. - move governance issue forms to the root ISSUE_TEMPLATE/ beside the bug and feature forms; label their descriptions as OpenCoven/.github-only - drop .github/ISSUE_TEMPLATE/config.yml; the root config already routes security reports to SECURITY.md - move the governance PR checklist to docs/templates/ and link it from the default PR template; update GOV-010 evidence to the new path Verified: ./scripts/agent-check fast (97 tests OK, validation passed, generated views current); issue forms parse as YAML. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Val Alexander <val@opencoven.ai>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
@opencoven/cliper the coven README, Homebrew casks for Coven Cave and Wand), docs and feedback links, and a grouped directory of all public, non-archived, non-fork repos (descriptions taken from each repo's About text; brand/design-system wording followsdocs/brand-ui-consolidation-resolution-2026-09-01.md).CODE_OF_CONDUCT.md,SUPPORT.md,ISSUE_TEMPLATE/(bug, feature, config with security/Discord/docs/feedback links),PULL_REQUEST_TEMPLATE.md,AGENTS.md,llms.txt.OpenCoven/coven(enabled) when the button is missing.Verification
ruby -ryamlparses all three issue forms.gh api repos/...).npm view @opencoven/cli→ 0.4.6). Both Discord invite casings resolve to the OpenCoven guild.🤖 Generated with Claude Code