Agentic OS 🧭

"Code is cheap. Context is expensive."
The Governance Kernel for the Age of AI Agents.

---

🧐 The Problem: The "Context Collapse"

We are entering an era where AI agents can write code faster than humans can review it. This leads to Context Collapse:

1. Speed without Direction: Agents write code that "works" but solves the wrong problem.
2. Hallucination Chains: One bad assumption in step 1 becomes a catastrophic architectural flaw by step 10.
3. The "Blank Page" Paralysis: Agents drift when given vague instructions like "Build me a CRM."

We don't need faster coding tools. We need a better Operating System for them.

---

💡 The Solution: Spec Driven Development (SDD)

Agentic OS is not an AI. It is the Governance Layer that sits between you and the AI. It enforces a strict, context-rich workflow that ensures no code is written until the "Standard of Truth" is established.

The Flow of Truth

graph LR
    A[🧠 Context] -->|Defines| B(PRD.md)
    B -->|Constraints| C{SPEC.md}
    C -->|Blueprint| D[TASKS.md]
    D -->|Action| E((Code))
    
    style A fill:#E1F5FE,stroke:#01579B,stroke-width:2px,color:#000
    style B fill:#FFF3E0,stroke:#EF6C00,stroke-width:2px,color:#000
    style C fill:#E8F5E9,stroke:#2E7D32,stroke-width:2px,color:#000
    style D fill:#F3E5F5,stroke:#7B1FA2,stroke-width:2px,color:#000
    style E fill:#fff,stroke:#333,stroke-width:2px,color:#000

Loading

1. PRD (Product Requirements Document): The "Why" and "What".
2. SPEC (Implementation Plan): The "How". The Blueprint.
3. TASKS (Checklist): The "When". Atomic units of work.
4. CODE: The output.

---

🧠 AI Workflows (Universal)

The .agent/workflows folder contains System Prompts for your AI.

Compatibility:

• Antigravity: Native support.
• Cursor / Windsurf / Copilot: Simply add the .agent folder to your context (or @mention the specific workflow file) and ask: "Run /init-prd".

Supported Slash Commands:

• /init-prd: "Interview me and write the PRD."
• /init-spec: "Read the PRD and write the Solution."
• /review: "Read the SPEC and judge the CODE."
• /status: "Read the state and tell me if I'm drifting."

---

🤝 Contributing

We are building the standard for Agentic Governance. Join us in defining how humans and machines collaborate. See CONTRIBUTING.md.

---

"Discipline is freedom."
Agentic OS gives your agents the discipline they need to give you the freedom you want.