ORKA — Workflow

1

Activation & Interview

You trigger ORKA. Often, your initial prompt ("Build a dashboard") is too vague. ORKA enters Interview Mode to clarify requirements.

                        User: "Build a user profile page."

                        ORKA: "Sure. 1) Should this use the existing NextAuth
                        session? 2) Do we need an avatar upload feature?"
                    

2

The Plan

ORKA updates .orka/plan.md. This is a contract. You review it. If it's wrong, you edit the markdown file directly.

                        # plan.md

                        - [ ] Create `ProfileComponent` in `src/components/`

                        - [ ] Connect to `useSession` hook

                        - [ ] Add API route `PUT /api/user/profile`

3

Execution

ORKA runs the tools. It creates files, runs terminal commands, and applies diffs. It respects the project structure because the Skills enforce it.

✔ Created file ✔ Ran npm install

4

Verification & Memory

Finally, ORKA updates .orka/state.md. It records exactly what was built so the next interaction has full context.