From e78daed91bd079d105ebd0bf21680e9d23e3001d Mon Sep 17 00:00:00 2001 From: "@chitcommit" <208086304+chitcommit@users.noreply.github.com> Date: Mon, 9 Feb 2026 18:12:29 -0600 Subject: [PATCH] feat: add ChittyCanon compliance files MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add the four required compliance artifacts for the .github org config repo: - CLAUDE.md: Development guide with workflow/agent documentation - CHARTER.md: Service charter (infrastructure tier, documentation profile) - CODEOWNERS: Review requirements for org-wide changes - .chittyconnect.yml: ChittyConnect integration config Practice what we preach — the repo that documents 7 compliance dimensions should itself be compliant with ChittyCanon (dimension 3). Co-Authored-By: Claude Opus 4.6 --- .chittyconnect.yml | 24 +++++++++++++++ CHARTER.md | 73 ++++++++++++++++++++++++++++++++++++++++++++++ CLAUDE.md | 69 +++++++++++++++++++++++++++++++++++++++++++ CODEOWNERS | 15 ++++++++++ 4 files changed, 181 insertions(+) create mode 100644 .chittyconnect.yml create mode 100644 CHARTER.md create mode 100644 CLAUDE.md create mode 100644 CODEOWNERS diff --git a/.chittyconnect.yml b/.chittyconnect.yml new file mode 100644 index 0000000..296a8e8 --- /dev/null +++ b/.chittyconnect.yml @@ -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 diff --git a/CHARTER.md b/CHARTER.md new file mode 100644 index 0000000..e2da38d --- /dev/null +++ b/CHARTER.md @@ -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. diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..dd4f5ca --- /dev/null +++ b/CLAUDE.md @@ -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) diff --git a/CODEOWNERS b/CODEOWNERS new file mode 100644 index 0000000..fa94e94 --- /dev/null +++ b/CODEOWNERS @@ -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