Contribute a Policy | Covenant v1

Submission Flow

Open an Issue

Use the Policy Submission template. Fill in the project name, URL, stance, and a proposed covenant.yml mapping.

Automated Validation

A CI workflow extracts the YAML from your issue and validates it against the Covenant.yml v1.0.0 schema. If valid, the issue is labeled validated. If invalid, you receive specific error feedback.

Maintainer Review

A maintainer reviews the policy mapping for accuracy and completeness. The mapping must faithfully represent the project's actual AI contribution stance.

Catalog Merge

The approved policy is merged into docs/POLICY_CATALOG.md and appears on the catalog page.

What to Include

Field	Required	Description
Project name	Yes	The name of the open-source project.
Project URL	Yes	Link to the project repository.
Stance	Yes	One of: accepting, restricting, rejecting.
Policy source URL	Yes	Direct link to the project's AI contribution policy or discussion.
Summary	Yes	One to three sentences describing the policy.
covenant.yml mapping	Yes	A valid Covenant v1 YAML policy that programmatically represents the stance.

Example Submission

Project: NumPy
URL: https://github.com/numpy/numpy
Stance: accepting
Policy source: https://numpy.org/doc/stable/dev/index.html
Summary: AI-assisted contributions accepted with disclosure. Standard review applies.

covenant.yml mapping:

spec_version: 1.0.0
defaults:
  unmatched: warn
requirements:
  on_failure: warn
  default_provenance_profile: disclosure
  provenance_profiles:
    disclosure:
      required_fields: [model, provider]
      on_failure: warn
rules:
  - id: agent-pr-with-disclosure
    actor: agent
    action: pull_request.open
    requirements:
      provenance_profile: disclosure
    outcome: warn
  - id: human-pr
    actor: human
    action: pull_request.open
    outcome: allow
  - id: protect-human-threads
    actor: agent
    action: conversation.intervene_human_thread
    outcome: deny

Updating an Existing Policy

If a project in the catalog has changed its AI contribution policy, use the Policy Update template. Include the project name, the updated policy source, and the revised covenant.yml mapping.

Contributing Code

For contributions to the Covenant standard itself (specification, schema, tooling, site), see CONTRIBUTING.md. This repository governs itself with its own covenant.yml.