.github

Organization-wide infrastructure for CI/CD, AI agents, and community health

Documentation | Contributing | Security

Contents

• Why This Repository?
• Quick Start
• Workflows
• AI Framework
• Organization Governance
• Documentation
• Contributing
• Security
• Acknowledgments
• License

This is the organization-level .github repository for {{ORG_NAME}}. Files here — workflows, templates, governance docs — are automatically inherited by every repository in the organization that doesn't define its own.

Why This Repository?

Managing organization-wide standards across dozens of repositories is tedious and error-prone. This .github repo solves that by providing a single source of truth — workflows, templates, governance docs, and AI configurations that every org repo inherits automatically. Change it once here, and every repository benefits.

graph TB
    subgraph dotgithub[".github Repository"]
        direction TB
        governance["Community Health<br/>Code of Conduct · Contributing · Security · Support"]
        workflows["{{WORKFLOW_COUNT}} Workflows<br/>CI/CD · Security · Automation · {{REUSABLE_TEMPLATE_COUNT}} Reusable Templates"]
        ai["AI Framework<br/>{{AGENT_COUNT}} Agents · {{CHATMODE_COUNT}} Chatmodes · Prompts · Collections"]
    end
    subgraph org["Organization Repos"]
        R1[Repo A]
        R2[Repo B]
        R3[Repo N]
    end
    dotgithub -->|inherits defaults| org

Loading

Quick Start

git clone https://github.com/{{ORG_NAME}}/.github.git
cd .github
pip install -e ".[dev]"
pre-commit install

Need help? Check SUPPORT.md or start a discussion.

Workflows

{{WORKFLOW_COUNT}} workflows covering CI/CD pipelines, security scanning (CodeQL, Gitleaks, TruffleHog), PR automation, health monitoring, and metrics. All actions are SHA-pinned with ratchet comments.

Key workflows: ci.yml · codeql-analysis.yml · auto-merge.yml · health-check.yml · batch-onboarding.yml · demo-deployment.yml

See the Workflow Registry for the full catalog.

AI Framework

{{AGENT_COUNT}} production agents across security, infrastructure, development, languages, and documentation. {{CHATMODE_COUNT}} chatmodes for specialized AI personas. Plus coding instructions, task prompts, and curated collections — all compatible with GitHub Copilot.

• Agent Registry
• Copilot Quick Start

Organization Governance

Default community health files inherited by all org repos:

File	Purpose
CODE_OF_CONDUCT.md	Community standards
CONTRIBUTING.md	Contribution guidelines
SECURITY.md	Vulnerability reporting
SUPPORT.md	Getting help
README_STANDARDS.md	README structure and depth standards

Issue templates, PR templates, and workflow templates are also provided for bootstrapping new repositories.

Documentation

Resource	Description
Documentation Index	Browse all docs
Development Environment	Setup guide
Workflow Design	Architecture
Claude Code Guide	AI assistant reference

Contributing

We welcome contributions. Please read CONTRIBUTING.md for guidelines, including our conventional commit requirement (type(scope): subject).

Security

Found a vulnerability? Do not open a public issue. Follow our Security Policy or use GitHub Security Advisories.

Acknowledgments

• GitHub Copilot customizations adapted from github/awesome-copilot
• Workflow SHA-pinning via ratchet

License

MIT