Rules-of-Robotics

# Rules of Robotics

### Universal Laws of Artificial Entities

A modern governance framework for AI agents, systems, and models — evolved from Isaac Asimov's Three Laws of Robotics (1942) into five enforceable laws for the age of autonomous AI.

**This repository provides a ready-to-use `CLAUDE.md` file** that embeds these laws as immutable instructions for any AI coding agent working on your project. Drop it into your project root, and every AI agent that reads it becomes bound by the Five Laws.

---

## Quick Start

### Step 1: Install Claude Code (if you haven't already)

Claude Code is Anthropic's official CLI for AI-assisted development. Install it:

```bash
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
```

On first run, you'll be prompted to log in with your [Cursor account](https://cursor.com/pricing).

### Step 2: Download CLAUDE.md into your project

Navigate to your project root and download the file:

```bash
cd /path/to/your/project
curl -o CLAUDE.md https://raw.githubusercontent.com/PavelValentov/Rules-of-Robotics/main/CLAUDE.md
```

Or manually copy the [`CLAUDE.md`](./CLAUDE.md) file to the root of your repository.

### Step 3: Initialize your project with Claude Code

Start Claude Code in your project directory and run the built-in `/init` command:

```bash
cursor
```

Then inside the Claude Code session:

```
/init
```

**What `/init` does:**
- Analyzes your codebase — discovers languages, frameworks, build commands, test scripts, and project structure
- Detects that `CLAUDE.md` already exists — it will **not** overwrite or modify the Five Laws
- Suggests improvements to the `Project-Specific Instructions` section below the immutable boundary
- Fills in the TODO placeholders with actual project details (tech stack, commands, conventions)

**Important:** The `/init` command respects the immutable boundary in `CLAUDE.md`. It only modifies the project-specific sectio