-
Notifications
You must be signed in to change notification settings - Fork 0
feat: add ChittyCanon compliance files #4
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
chitcommit
wants to merge
1
commit into
main
Choose a base branch
from
feat/compliance-files
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
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
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,24 @@ | ||
| --- | ||
| # ChittyConnect integration for CHITTYOS/.github | ||
| service: chittyos-github | ||
| tier: infrastructure | ||
| organization: CHITTYOS | ||
| domain: null | ||
|
|
||
| onboarding: | ||
| provisions: | ||
| - chitty_id | ||
| - service_token | ||
| auth_provider: chittyauth | ||
|
|
||
| sync: | ||
| enabled: true | ||
| interval: 6h | ||
|
|
||
| metadata: | ||
| description: Organization-wide GitHub configuration | ||
| compliance_profile: documentation | ||
| tags: | ||
| - org-config | ||
| - workflows | ||
| - agents |
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
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,73 @@ | ||
| --- | ||
| uri: chittycanon://gov/charter/chittyos-github | ||
| namespace: chittycanon://gov | ||
| type: charter | ||
| version: 1.0.0 | ||
| status: CERTIFIED | ||
| registered_with: chittycanon://core/services/canon | ||
| title: ChittyOS .github Charter | ||
| author: ChittyOS Governance | ||
| certifier: chittycanon://gov/authority/chittygov | ||
| created: 2026-02-09T00:00:00Z | ||
| --- | ||
|
|
||
| # ChittyOS .github Charter | ||
|
|
||
| ## Mission | ||
|
|
||
| Provide consistent, org-wide GitHub configuration including reusable workflows, Copilot agents, compliance templates, and repository bootstrapping for all CHITTYOS repositories. | ||
|
|
||
| ## Scope | ||
|
|
||
| This repository governs: | ||
| - Organization-wide workflow inheritance | ||
| - GitHub Copilot custom agent definitions | ||
| - New repository bootstrapping automation | ||
| - Cross-repo sync workflows (evidence, governance, operations, property) | ||
| - Organization public profile | ||
|
|
||
| ## Classification | ||
|
|
||
| - **Tier**: Infrastructure (not a deployable service) | ||
| - **Organization**: CHITTYOS | ||
| - **Domain**: N/A (org-wide configuration) | ||
| - **Compliance Profile**: `documentation` (Canon required, other dimensions optional) | ||
|
|
||
| ## Principles | ||
|
|
||
| ### 1. Org-Wide Impact | ||
|
|
||
| Changes to this repo affect all CHITTYOS repositories immediately. All changes require review. | ||
|
|
||
| ### 2. Minimal Footprint | ||
|
|
||
| Only include configuration that genuinely benefits from org-wide inheritance. Repo-specific config belongs in individual repos. | ||
|
|
||
| ### 3. Compliance First | ||
|
|
||
| This repo bootstraps compliance for other repos via `new_repo_setup.yml`. It must itself be compliant. | ||
|
|
||
| ## Governance | ||
|
|
||
| ### Authority | ||
|
|
||
| - **ChittyGov**: Approves charter amendments | ||
| - **Platform Team**: Maintains workflows and agents | ||
| - **CODEOWNERS**: Enforces review requirements | ||
|
|
||
| ### Review Process | ||
|
|
||
| 1. All changes via PR (no direct pushes to main) | ||
| 2. Required review from CODEOWNERS | ||
| 3. Workflow changes tested in a fork or test repo first | ||
| 4. Agent changes validated via Copilot chat | ||
|
|
||
| ## Dependencies | ||
|
|
||
| - **ChittyConnect**: Credential provisioning for workflows | ||
| - **ChittyCanon**: Documentation and naming standards | ||
| - **GitHub Actions**: Workflow runtime | ||
|
|
||
| ## Amendments | ||
|
|
||
| This charter may be amended by PR with ChittyGov approval. |
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
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,69 @@ | ||
| --- | ||
| uri: chittycanon://docs/tech/spec/chittyos-github | ||
| namespace: chittycanon://docs/tech | ||
| type: spec | ||
| version: 1.0.0 | ||
| status: CERTIFIED | ||
| registered_with: chittycanon://core/services/canon | ||
| title: ChittyOS .github Development Guide | ||
| author: ChittyOS Team | ||
| created: 2026-02-09T00:00:00Z | ||
| modified: 2026-02-09T00:00:00Z | ||
| visibility: PUBLIC | ||
| tags: [org-config, workflows, agents, compliance] | ||
| --- | ||
|
|
||
| # ChittyOS .github | ||
|
|
||
| Organization-wide GitHub configuration for all CHITTYOS repositories. | ||
|
|
||
| ## What This Repo Contains | ||
|
|
||
| | Directory | Purpose | | ||
| |-----------|---------| | ||
| | `.github/agents/` | GitHub Copilot custom agents (org-wide) | | ||
| | `.github/workflows/` | Reusable workflows inherited by all repos | | ||
| | `profile/` | Organization README (public profile) | | ||
| | `scripts/` | Preflight and verification tooling | | ||
|
|
||
| ## Workflows | ||
|
|
||
| | Workflow | Trigger | Purpose | | ||
| |----------|---------|---------| | ||
| | `documentation_check.yml` | PR | Validates documentation standards | | ||
| | `metadata_check.yml` | PR | Validates metadata and frontmatter | | ||
| | `new_repo_setup.yml` | Repository creation | Bootstraps compliance files | | ||
| | `sync-evidence.yml` | Schedule | Syncs evidence artifacts | | ||
| | `sync-governance.yml` | Schedule | Syncs governance docs | | ||
| | `sync-operations.yml` | Schedule | Syncs operations config | | ||
| | `sync-property.yml` | Schedule | Syncs property records | | ||
|
|
||
| ## Copilot Agent | ||
|
|
||
| The `@chittyos` agent (`chittyos.md`) is available org-wide in GitHub Copilot. It covers: | ||
| - Ecosystem navigation (62+ services, 6 tiers) | ||
| - Compliance guidance (7 dimensions) | ||
| - Service onboarding walkthrough | ||
| - Architecture explanation | ||
|
|
||
| ## Development | ||
|
|
||
| ```bash | ||
| # Clone | ||
| gh repo clone CHITTYOS/.github | ||
|
|
||
| # Edit workflows or agents | ||
| # Push to main (changes apply org-wide immediately) | ||
| ``` | ||
|
|
||
| ## Testing Changes | ||
|
|
||
| - Workflow changes: Create a PR and check the Actions tab in any CHITTYOS repo | ||
| - Agent changes: Open Copilot chat in any CHITTYOS repo and invoke `@chittyos` | ||
| - Profile changes: View at github.com/CHITTYOS | ||
|
|
||
| ## Security | ||
|
|
||
| - No secrets in this repo -- all credentials flow through ChittyConnect | ||
| - Workflow secrets are configured at the org level in GitHub Settings | ||
| - The `new_repo_setup.yml` workflow uses `GITHUB_TOKEN` (automatic) | ||
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
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,15 @@ | ||
| # ChittyOS .github CODEOWNERS | ||
| # Changes to this repo affect all CHITTYOS repositories | ||
|
|
||
| # Default: Platform Team | ||
| * @CHITTYOS/platform-team | ||
|
|
||
| # Copilot agents require additional review | ||
| .github/agents/ @CHITTYOS/platform-team | ||
|
|
||
| # Workflows require careful review (org-wide impact) | ||
| .github/workflows/ @CHITTYOS/platform-team | ||
|
|
||
| # Governance documents | ||
| CHARTER.md @CHITTYOS/platform-team | ||
| CLAUDE.md @CHITTYOS/platform-team |
Oops, something went wrong.
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.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The development snippet instructs contributors to “push to main,” which conflicts with the charter’s governance rule that “all changes via PR (no direct pushes to main)” (CHARTER.md:60). If someone follows CLAUDE.md here, they can bypass CODEOWNERS review and the required PR workflow, undermining the compliance and review guarantees this repo is meant to enforce. Please align the development instructions with the charter’s required PR-based process.
Useful? React with 👍 / 👎.