# DevOS v1 Product Requirements Document

## 1. Product Definition
DevOS is a Developer Work OS: a unified workspace for servers, websites, domains, code, databases, email, notes, tasks, documents, monitoring and automation, with AI as an operational Agent rather than merely a chat interface.

## 2. Core Product Model
The platform is organized around four primitives:

**Resource + Action + Event + Agent**

- Resource: everything managed by DevOS.
- Action: an operation performed against a resource.
- Event: a state change or external signal.
- Agent: observes resources, plans actions, executes through tools, verifies outcomes and reports.

The central architectural principle is the **Unified Resource Model**.

## 3. Primary Users
- Individual developers
- Small development teams

## 4. V1 Scope
V1 focuses on Infrastructure OS capabilities:
- Server
- Docker / Containers
- Website
- Domain
- Deployment
- Monitoring
- Authentication, Workspace, Resource, Permission and Audit foundations

## 5. V2 Scope
Developer OS:
- GitHub / GitLab / other Git providers
- Projects
- Tasks
- Notes
- Documents
- Email

## 6. V3 Scope
Automation OS:
- Event Bus
- Workflow Engine
- Cron
- Webhook
- Notifications

## 7. V4 Scope
AI OS:
- Resource Discovery
- Planning
- Tool Calling
- Execution
- Verification
- Memory
- Approval

## 8. Representative User Journey
“Deploy my blog to the Tokyo server, use Docker, configure blog.example.com and enable HTTPS.”

The intended Agent flow:
1. Find Project and Repository
2. Find target Server
3. Check Docker
4. Clone repository
5. Build image
6. Run container
7. Configure reverse proxy
8. Configure DNS
9. Obtain SSL
10. Health check
11. Return an action log and result

## 9. Non-Goals
- Reimplementing Git
- Reimplementing SMTP
- Building a Kubernetes control plane in V1
- Building a full Notion replacement in the first release
- Starting with microservices

## 10. Product Success Criteria
A developer can manage the core infrastructure lifecycle from one workspace, while resources remain related and discoverable enough for later automation and AI operation.