❓ What is ORKA?
ORKA is a Project-Local AI Skill Orchestration Framework designed to control how IDE AI behaves while building software.
Instead of relying on prompts, ORKA places structured intelligence
directly inside the project workspace using .agent and .orka folders.
"ORKA converts IDE AI from a chat assistant into a deterministic project generator."
🚨 The Problem ORKA Solves
Ideally, IDE AI builds perfect projects. In reality, it:
- ✕ Hallucinates architecture & mixes frameworks
- ✕ Generates inconsistent code & skips requirements
- ✕ Poor UI/UX decisions & forgets project stack
These are not model problems.
They are environment design problems.
ORKA fixes the environment.
Core Features
A new operating system for your AI assistant.
ORKA Brain
Controls how AI thinks using .orka/brain.md.
Activation Mode
Activates only when you type: "Use ORKA".
Interview Mode
AI MUST ask structured questions before planning.
Execution Planning
Writes plan.md before creating
a single line of code.
Persistent Memory
state.md stores exactly what
has been built.
Design Rules
UI/UX and style rules embedded per-skill.
⚙️ How ORKA Works
Example: SaaS Dashboard
> User: "Build a SaaS dashboard with login" [ORKA Auto-Pilot] 1. Chooses Next.js skill 2. Chooses Node backend 3. Adds DB connector 4. Adds Auth module (Clerk/NextAuth) 5. Adds Payments (Stripe) 6. Plans execution steps 7. Builds step by step...
📦 Installation
Simply drop the folders into your project root.
your-project/ ├── .agent/ # Skills & Tools ├── .orka/ # Brain & State
Then type in your IDE:
🧱 Architecture
.agent/skills/<skill>/
SKILL.md
SKILL.meta.json
templates/
design-rules/
.orka/
brain.md
graph.json
plan.md
state.md