The Ultimate Engineering Operating System for Devin & AI Coding Agents
Transform every Devin installation into a continuously improving Senior Software Engineer
- What is DevinOS?
- Why DevinOS?
- Quick Start
- Core Components
- Engineering Constitution
- Priority Hierarchy
- 23 Core Skills
- 21 Immutable Rules
- Self-Improving Knowledge Engine
- Repository Structure
- Quality Gates
- Contributing
- Roadmap
- License
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
| Without DevinOS | With DevinOS |
|---|---|
| Generic, inconsistent output | Constitution-driven, principled decisions |
| Reinvents the wheel every project | Reuses battle-tested patterns and skills |
| Security overlooked | Security-by-default in every line |
| No memory between sessions | Growing knowledge base from every project |
| No quality standards | Rigorous quality gates for every contribution |
| AI hallucinations unchecked | Verification-before-declaration mandatory |
# Clone DevinOS
git clone https://github.com/ahmedhazim97/DevinOS.git
# Copy the brain into your project
cp -r DevinOS/.agents ./
# Done. Devin will auto-discover and use the skills and rules.Installs directly into your IDE's global Rules & Skills folders — no project setup needed.
Windows (Windsurf / Cursor):
irm https://raw.githubusercontent.com/ahmedhazim97/DevinOS/main/install.ps1 | iexMac / Linux (Windsurf / Cursor / Claude Code):
curl -sL https://raw.githubusercontent.com/ahmedhazim97/DevinOS/main/install.sh | bashThe installer auto-detects your IDE and copies:
- 21 Rules → Global Rules folder
- 23 Skills → Global Skills folder
Restart your IDE to activate.
DevinOS Brain Structure
|
|-- ENGINEERING_CONSTITUTION.md # The Supreme Law
|-- .agents/
| |-- skills/ # 23+ actionable capabilities
| |-- rules/ # 21+ 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
The Engineering Constitution is the supreme law of DevinOS. Every skill, rule, workflow, and memory entry must derive from it.
- Priority Hierarchy - Correctness > Security > Maintainability > Performance > DX > Readability > Speed
- Never Assume - Verify requirements, code, libraries, tests, documentation
- Verification Before Declaration - No task is complete without evidence
- Reuse Over Reinvention - Search existing code before creating new files
- Simplicity - Keep functions small, files focused, prefer composition
- Security by Default - Validate inputs, escape outputs, never expose secrets
- Continuous Learning - Extract generalizable lessons from every project
- Quality Gates - Uniqueness, documentation, examples, anti-patterns, verification
- Git Ethics - Small focused commits, meaningful messages, no secrets
- Human-AI Collaboration - AI augments humans; decisions must be explainable
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.
Every skill includes: Description, Purpose, Trigger, Context, Workflow, Examples (good & bad), Anti-patterns, Verification Checklist, and References.
| Skill | Category | Purpose |
|---|---|---|
| Planning | Core | Break complex tasks into small, verifiable steps |
| Architecture Review | Core | Evaluate and improve architectural decisions |
| Structured Debugging | Core | Systematic, evidence-based bug fixing |
| Code Review | Core | Evaluate changes for correctness and security |
| Refactoring | Core | Improve structure without changing behavior |
| Testing | Core | Write comprehensive, deterministic tests |
| Verification | Core | Rigorous validation before declaring completion |
| Skill | Category | Purpose |
|---|---|---|
| Security Review | Security | Systematic vulnerability evaluation |
| Performance Optimization | Performance | Measure, analyze, and improve with evidence |
| Documentation | Core | Write clear, accurate, useful documentation |
| Git Workflow | Core | Professional version control practices |
| Docker & Containers | DevOps | Build and optimize containerized applications |
| CI/CD Pipeline Design | DevOps | Automate testing, building, and deployment |
| Database Design | Backend | Design, optimize, and review schemas |
| API Design | Backend | Build robust, consistent, developer-friendly APIs |
| Frontend Engineering | Frontend | Responsive, accessible, performant UIs |
| Backend Engineering | Backend | Reliable, scalable, secure server-side systems |
| Skill | Category | Purpose |
|---|---|---|
| MCP Builder | AI | Build Model Context Protocol servers |
| AI Engineering | AI | Build reliable systems leveraging AI |
| Knowledge Distillation | Meta | Extract reusable lessons from projects |
| Quality Audit | Meta | Rigorously evaluate assets before acceptance |
| Incident Response | Ops | Systematic response to production incidents |
| Root Cause Analysis | Core | Determine fundamental causes, not symptoms |
Located in .agents/rules/, each rule references the Constitution article it derives from and includes a verification checklist.
| # | Rule | Focus |
|---|---|---|
| 1 | Engineering Principles | Never assume, reuse, keep simple |
| 2 | Architecture | SOLID, composition, loose coupling |
| 3 | Security | OWASP, input validation, secrets |
| 4 | Performance | Profile first, optimize hot paths |
| 5 | Debugging | Reproduce, isolate, root cause |
| 6 | Planning | Understand before solving, small steps |
| 7 | Documentation | Update README, explain decisions |
| 8 | Git | Small commits, meaningful messages |
| 9 | Testing | TDD, deterministic, edge cases |
| 10 | Code Review | Correctness first, constructive |
| 11 | Communication | Concise, specific, evidence-based |
| 12 | UX | Responsive, accessible, Core Web Vitals |
| 13 | API Design | Consumer-first, versioning, errors |
| 14 | Database | Parameterized queries, migrations |
| 15 | AI Engineering | Verify output, structured outputs |
| 16 | MCP | Single purpose, validate, document |
| 17 | Memory | Generalize lessons, update skills |
| 18 | Learning | Extract knowledge, create assets |
| 19 | Deployment | Automated, blue-green, rollback |
| 20 | Monitoring | Structured logs, actionable alerts |
| 21 | Quality | 7-gate audit, scoring rubric, reviewer ethics |
DevinOS is not static. It is designed to learn and grow from every project it touches.
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
- Fork DevinOS into your own private repository
- Use it across all your projects
- After each project, Devin asks: "What did I learn? Can this become a reusable skill?"
- Extract lessons, generalize them, and add to your private fork
- Optionally contribute back to the public DevinOS (opt-in)
- 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
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
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/ # 23+ core 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
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
See CONTRIBUTING.md for the full guide.
Quick start:
- Read the Engineering Constitution
- Check ROADMAP.md for planned features
- Search existing issues to avoid duplicates
- Follow the skill template structure
- Submit a pull request with clear justification
| Version | Focus | Status |
|---|---|---|
| v0.1 | Foundation - Constitution, Rules, Skills | Live |
| v0.2 | Rules & Governance expansion | Planned |
| v0.3 | Skills expansion (50+) | Planned |
| v0.4 | Workflows library | Planned |
| v0.5 | Playbooks (Incident, Security, Optimization) | Planned |
| v0.6 | Memory system | Planned |
| v0.7 | Templates library | Planned |
| v0.8 | Prompt library (100+) | Planned |
| v0.9 | Knowledge graph & searchable index | Planned |
| v1.0 | Public release with community marketplace | Planned |
Full details: ROADMAP.md
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.
MIT - Free for personal and commercial use.
Build with purpose. Verify with rigor. Improve continuously.
Made for Devin. Built by the community.