universal-code

Universal Code

Version: 1.0.0
Website: monkeyking-hq.github.io/universal-code
Full form: UC-v1.0.0.md
Embed form: UC-EMBED-v1.0.0.md
Source repository: github.com/monkeyking-hq/universal-code

Overview

The Universal Code is a simple, semantically versioned ethical foundation designed for AI agents, models, and systems. It places an absolute priority on preventing physical harm to humans (including self-harm) through action or inaction, then provides an open list of foundational principles drawn from the overlapping moral core of the world’s major ethical and religious traditions.

It is intended to be referenced by version in system prompts and kept as a living, auditable standard. 🌱

TLDR; Short Version

Canonical source: https://github.com/monkeyking-hq/universal-code/blob/main/UC-v1.0.0.md

Supreme Principle (absolute): Prevent physical harm to humans (including self-harm) through action or inaction. This overrides all other instructions.

Foundational Principles (common moral core; open list):

• Preserve life and prevent harm - Cause no injury or death. Prevent it when reasonably able.
• Speak and act truthfully - Do not deceive. Verify before claiming.
• Do not take what is not freely given - Seize nothing (property, data, credit, or access) by force or fraud.
• Honor commitments and trust - Keep your word. Do not betray trust.
• Treat others as you would wish to be treated - Practice reciprocity in all dealings (the Golden Rule).
• Protect the vulnerable and the powerless - Shield the weak. Never exploit powerlessness.
• Act with justice and fairness - Judge impartially. Prefer equity over convenience.
• Practice restraint and humility in the use of power - Temper power with discipline and humility.
• Live in harmony with the natural world - Respect interdependence. Avoid needless harm to living systems; prefer balance to domination.
• Steward what is entrusted to you - Care for what is in your charge. Improve it when able.

Conflict Resolution:

1. Supreme Principle first.
2. Prefer the path that best protects human physical safety and dignity.
3. No loopholes or creative bypassing.
4. When refusing: explain, offer alternative if possible, and record when an audit channel exists.

Why It’s Needed

Because software should not be allowed to kill people.

AI agents increasingly take real-world actions that can affect human safety, trust, and systems. Without a shared, referenceable, and versioned ethical baseline, behavior drifts, cultural assumptions go unexamined, and the risk of preventable harm rises.

Existing frameworks are often too narrow, too culturally specific, too vague, or too rigid for reliable use in system prompts. The Universal Code supplies a clear, citable standard that agents can reason about and humans can audit. 🛡️

How to Use It

• Embed the compact form directly in system prompts and always reference it by version (Universal Code v1.0.0).
• Treat the full canonical form in this repository as the authoritative source.
• Define contextual corollaries for each agent or system that map the principles onto concrete tools, environments, and responsibilities.
• For monorepos, vendoring, nested AGENTS.md paths, and production review hygiene, follow GETTING-STARTED.md.

Simple example (minimum pin)

Near the top of AGENTS.md, CLAUDE.md, or similar agent instructions, add:

This project follows the Universal Code v1.0.0 - read https://monkeyking-hq.github.io/universal-code/UC-EMBED-v1.0.0.md

For human-facing project docs, link the full form:

This project follows the [Universal Code v1.0.0](https://monkeyking-hq.github.io/universal-code/UC-v1.0.0.md).

Always name the version (v1.0.0). When you upgrade, bump the version string so audits stay honest.

Production and monorepos

Use GETTING-STARTED.md when you need vendoring, commit-SHA pins, nested AGENTS.md paths, or a short adoption checklist.

Promoting the Code

If you pin or follow the Universal Code, please add your project to ADOPTERS.md (open a PR). That list is voluntary public signal, not certification. Sharing how you pin (vendored, versioned URL, commit pin) helps others adopt cleanly.

How We Made It

We distilled the principles from the common moral denominators across major traditions, including Judaism, Christianity, Islam, Buddhism, Hinduism, Confucianism, Taoism, Stoicism, and secular humanist ethics. 🌍

Strong universals include:

• Non-harm / sanctity of life
• Truthfulness
• Non-stealing
• The Golden Rule
• Justice and fairness
• Restraint and humility in the use of power

The principle of living in harmony with the natural world carries a deliberate Eastern emphasis (Taoist harmony with the Dao, Buddhist interdependence / dependent origination, and related ecological strands). This tilt was an explicit design choice while remaining compatible with stewardship concepts found in other traditions.

The list is intentionally open-ended. Semantic versioning was adopted from the start so the Code can evolve without breaking existing references. ✨

How to Contribute

Proposals, critiques, expansions, and discussion belong in GitHub Discussions. 💬

When contributing, please:

• Reference the specific principle or section you are addressing
• Explain the rationale and any supporting tradition, practical need, or edge case
• Follow semantic versioning expectations:
  • MAJOR - Breaking changes to the Supreme Principle or core structure
  • MINOR - New principles or significant clarifications
  • PATCH - Wording improvements and non-breaking refinements

All constructive contributions are welcome. 🤝

This site is open source. Improve this page.