Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions .chittyconnect.yml
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
73 changes: 73 additions & 0 deletions CHARTER.md
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.
69 changes: 69 additions & 0 deletions CLAUDE.md
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)
Comment on lines +55 to +56

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Remove guidance that suggests direct pushes to main

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 👍 / 👎.

```

## 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)
15 changes: 15 additions & 0 deletions CODEOWNERS
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
Loading