Devin

Table of Contents

• What is DevinOS?
• Why DevinOS?
• Quick Start
• Core Components
• Engineering Constitution
• Priority Hierarchy
• 67 Skills
• 22 Immutable Rules
• Self-Improving Knowledge Engine
• Repository Structure
• Quality Gates
• Contributing
• Roadmap
• License

What is DevinOS?

DevinOS is the world's first open-source Engineering Operating System built specifically for Devin and AI coding agents. It is a comprehensive, modular, and self-improving knowledge base that turns every AI-assisted project into a learning opportunity.

Think of it as the "brain upgrade" for Devin: a structured collection of rules, skills, workflows, playbooks, templates, memory, and prompts that guide AI agents to write production-grade software with the discipline of a senior engineer.

Unlike generic prompt libraries, DevinOS is:

• Constitution-Driven - Every rule derives from the Engineering Constitution
• Self-Improving - Learns from every project and grows smarter over time
• Production-Ready - Built for real-world software engineering, not toy examples
• Community-Powered - Federated learning from thousands of Devin users worldwide

Why DevinOS?

Quick Start

1. Install DevinOS in Any Project (30 seconds)

# Clone DevinOS
git clone https://github.com/Devin-IQ/DevinOS.git

# Enter your project folder
cd your-project

# Copy the brain into your project
cp -r ../DevinOS/.agents ./

# Done. Devin will auto-discover and use the skills and rules.

2. Global Install (IDE Integration)

Installs directly into your IDE's global Rules & Skills folders — no project setup needed.

Windows (Windsurf / Cursor):

irm https://raw.githubusercontent.com/Devin-IQ/DevinOS/main/install.ps1 | iex

Mac / Linux (Windsurf / Cursor / Claude Code):

curl -sL https://raw.githubusercontent.com/Devin-IQ/DevinOS/main/install.sh | bash

The installer auto-detects your IDE and copies:

• 21 Rules → Global Rules folder
• 40 Skills → Global Skills folder

Restart your IDE to activate.

Core Components

DevinOS Brain Structure
|
|-- ENGINEERING_CONSTITUTION.md    # The Supreme Law
|-- .agents/
|   |-- skills/                    # 67 actionable capabilities
|   |-- rules/                     # 22 immutable principles
|   |-- workflows/                 # End-to-end processes
|   |-- playbooks/                 # Step-by-step guides
|   |-- memory/                    # Growing knowledge base
|   |-- templates/                 # Implementation starters
|   |-- prompts/                   # Curated prompt library
|
|-- docs/                          # Deep documentation
|-- examples/                      # Working code samples
|-- assets/                        # Media and diagrams

Engineering Constitution

The Engineering Constitution is the supreme law of DevinOS. Every skill, rule, workflow, and memory entry must derive from it.

The 10 Articles

1. Priority Hierarchy - Correctness > Security > Maintainability > Performance > DX > Readability > Speed
2. Never Assume - Verify requirements, code, libraries, tests, documentation
3. Verification Before Declaration - No task is complete without evidence
4. Reuse Over Reinvention - Search existing code before creating new files
5. Simplicity - Keep functions small, files focused, prefer composition
6. Security by Default - Validate inputs, escape outputs, never expose secrets
7. Continuous Learning - Extract generalizable lessons from every project
8. Quality Gates - Uniqueness, documentation, examples, anti-patterns, verification
9. Git Ethics - Small focused commits, meaningful messages, no secrets
10. Human-AI Collaboration - AI augments humans; decisions must be explainable

Priority Hierarchy

All DevinOS content follows this immutable priority order:

1. Correctness     -- It must work
2. Security        -- Protect data and users
3. Maintainability -- Easy to understand and modify
4. Performance     -- Fast enough for requirements
5. Developer Experience -- Reduce friction
6. Readability     -- Clear and expressive
7. Speed           -- Deliver quickly

No feature, optimization, or shortcut may violate this hierarchy.

67 Skills

Every skill includes frontmatter with name and description, then Description, Purpose, Trigger, Context, Workflow, Examples, Anti-patterns, Verification Checklist, and References.

Core Engineering

Specialized Disciplines

TypeScript Libraries & Frameworks

iOS & Apple Platform

AI & Operations

Elite & Advanced Capabilities

Pmndrs Ecosystem

22 Immutable Rules

Located in .agents/rules/, each rule references the Constitution article it derives from and includes a verification checklist.

Self-Improving Knowledge Engine

DevinOS is not static. It is designed to learn and grow from every project it touches.

How It Works

Every Devin Project
        |
        v
  Knowledge Distillation
        |
        v
  Generalized Lessons
        |
        v
  New Skills / Updated Rules
        |
        v
  Pull Request to DevinOS
        |
        v
  Community Review & Merge
        |
        v
  Every Devin User Benefits

For Individual Users (Private Fork Model)

1. Fork DevinOS into your own private repository
2. Use it across all your projects
3. After each project, Devin asks: "What did I learn? Can this become a reusable skill?"
4. Extract lessons, generalize them, and add to your private fork
5. Optionally contribute back to the public DevinOS (opt-in)

For the Community (Federated Learning)

• Weekly community updates aggregate validated learnings
• High-quality contributions from real projects are merged into the main branch
• Every user who pulls the latest DevinOS gets the collective wisdom of thousands of projects
• No code is ever shared automatically — only generalized, anonymized patterns

Privacy First

DevinOS never auto-uploads your code. The knowledge distillation process:

• Removes all project-specific identifiers
• Generalizes patterns into reusable skills
• Requires explicit opt-in before any contribution
• Keeps your private fork completely under your control

Repository Structure

DevinOS/
├── ENGINEERING_CONSTITUTION.md  # Supreme law of DevinOS
├── README.md                     # This file
├── ROADMAP.md                    # Future plans
├── CHANGELOG.md                  # Version history
├── CONTRIBUTING.md               # How to contribute
├── CODE_OF_CONDUCT.md            # Community standards
├── SECURITY.md                   # Security policy
├── .gitignore                    # Cross-platform ignore rules
│
├── .agents/
│   ├── skills/                   # 40 skills
│   ├── rules/                    # 21 foundational rules
│   ├── workflows/                # Reusable workflows
│   ├── playbooks/                # Step-by-step guides
│   ├── memory/                   # Knowledge base
│   ├── templates/                # Implementation templates
│   └── prompts/                  # Curated prompts
│
├── docs/                         # Documentation
├── examples/                     # Example implementations
└── assets/                       # Images and media

Quality Gates

Every skill must pass these gates before acceptance:

• Uniqueness - No duplicates in the repository
• Documentation - Description, purpose, trigger, context, workflow
• Examples - Good and bad examples included
• Anti-patterns - Common mistakes documented
• Verification - Checklist for correctness
• References - Further reading provided
• Framework Agnostic - General solution unless specific is unavoidable
• Production Quality - No shortcuts, no TODOs without tickets

Contributing

See CONTRIBUTING.md for the full guide.

Quick start:

1. Read the Engineering Constitution
2. Check ROADMAP.md for planned features
3. Search existing issues to avoid duplicates
4. Follow the skill template structure
5. Submit a pull request with clear justification

Roadmap

Full details: ROADMAP.md

Keywords

DevinOS, Devin AI, AI coding agent, engineering operating system, software engineering rules, AI prompt engineering, MCP server, Model Context Protocol, Devin skills, Devin rules, AI software development, automated code review, AI debugging, knowledge distillation, self-improving AI, LLM engineering, AI best practices, software architecture, secure coding, CI/CD automation, Docker best practices, frontend engineering, backend engineering, database design, API design, incident response, root cause analysis, AI engineering, open source AI tools, AI agent framework.

License

MIT - Free for personal and commercial use.