Waykee
Cortex — Hierarchical Context
⬡ Waykee Cortex

Hierarchical Context
& Bot Sessions

How Waykee Cortex automatically builds the right context for every robot, inheriting knowledge level by level.

🌳 Section 1

Every Waykee Object Lives in a Hierarchy

Objects come in two flavors: Knowledge Objects (systems, modules, screens/programs — the permanent documentation of what exists) and Task Objects (tickets, milestones, projects — the work being done). Both live in hierarchies, and children automatically inherit the context of all their ancestors.

💡 The node names are fully customizable. "System", "Module", "Screen/Program" are the default labels for software teams — but any industry can define its own hierarchy. The examples below show a software team and an education institution using the same engine with different node names.

Knowledge Objects
(Software example — other hierarchies exist)

🏢
System
📁
Module
🖥️
Screen/Program
🎫
Task / Ticket

Task Objects

📂
Project
🏁
Milestone
🎫
Task / Ticket

Each node has

📄 Documentation
👶 Children nodes
🧬 Inherited context
↕️ Bidirectional link
💻 Example — Software / ERP
🏢 Atlas ERP System
Enterprise resource planning platform for manufacturing & distribution companies.
📄 Platform overview, architecture, main modules, integrations
📁 Finance Module Module
Handles accounts payable/receivable, general ledger, budget control, and financial reporting.
📄 Module scope, workflow rules, key entities, team contacts
🖥️ Invoice Entry Screen Screen/Program
Web form for creating and editing supplier invoices. Supports multi-currency, tax lines, and three-way matching.
📄 UI fields, validation rules, user permissions, error codes
🎫 Add "Recurring Invoice" toggle Change Request
Add a toggle to mark invoices as recurring, automatically generating copies each billing cycle.
📄 Requirement details, acceptance criteria, conversation history
🔬 Example — Biology Research Lab
🔬 Cancer Drug Discovery
Program charter, funding sources, principal investigators, safety protocols
Waykee Type
Research Program
🧬 Immunotherapy Division
Active research lines, target mechanisms, known biomarkers, literature review
Waykee Type
Research Area
🧪 PD-1 Inhibitor Study
Study design, hypothesis, sample size, ethical approval, timeline
Waykee Type
Study
⚗️ T-Cell Activation Assay
Equipment, reagents, cell lines, expected outcomes, known failure modes
Waykee Type
Experiment
📋 Flow Cytometry Protocol v3
Step-by-step procedure, instrument settings, gating strategy, data interpretation
Waykee Type
Protocol
A robot running a Protocol automatically inherits context from the Experiment, Study, Research Area, and Program — no manual briefing needed.
🧬

Context Inheritance in action

When a robot opens the ticket "Add Recurring Invoice toggle", it automatically receives the documentation of all four levels: the Atlas ERP platform overview, the Finance Module workflow rules, the Invoice Entry Screen/Program specifications, and the ticket itself. No manual context-passing needed.

Tasks can have dual ancestry

A task links to both a Knowledge hierarchy (what screen/system it belongs to) and a Project hierarchy (what milestone/project it's part of). The robot receives context from both sides.

Knowledge Objects
🏢 Atlas ERP
System
📁 Finance Module
Module
🖥️ Invoice Entry Screen
Screen/Program
Task Objects
📂 Atlas ERP v3.0
Project
🏁 Q2 Finance Sprint
Milestone
🎫
Add "Recurring Invoice" toggle
Change Request · child of both parents above
← Screen spec Sprint goal →
Knowledge ancestry → system context, module rules, screen specs
Project ancestry → sprint goals, milestone scope, project priorities

The Waykee Cortex promise

Don't waste your agent's energy investigating how things work.

Give it exactly the right context — no more, no less — so it can focus 100% on solving.

🔍

Uses RAG + embeddings to instantly surface the most relevant objects — screens, modules, docs — so the agent finds what it needs in milliseconds, not minutes.

🏛️

Waykee Cortex gives your development and projects solid foundations and permanent memory — so nothing is ever lost between agents, sessions, or teams.

🤖 Section 2

Robots & Instruction Packs

Each robot has a personality (system message) and a set of Instruction Packs (similar to skills) — reusable knowledge bundles assigned by the owner. Some packs are shared across robots; others are unique to one.

🗄️
🤖
Database Expert
SQL optimization & data modeling
⚡ GPT-5.6 via API
Owned by: Maria Torres
🧠 Mindset Confidential · Never revealed
"You are a senior database engineer. Analyze data models, write optimized SQL queries, and suggest schema improvements. Always consider performance and data integrity."
Assigned Instruction Packs
📋 Company Coding Standards Shared
🔐 Security & Compliance Rules Shared
🗄️ Database Server Connections Unique
SQL Server Performance Tips Unique
Responsibilities
🔄
Review Server Health
Task · Recurring
⏰ Daily 1am
🔄
Review Backup Health
Task · Recurring
⏰ Daily 1am
💻
🤖
Web Developer
Frontend & API development
🖥️ Claude Code · MacBook Pro
Owned by: Maria Torres
🧠 Mindset Confidential · Never revealed
"You are a senior full-stack developer. Build web interfaces, design REST APIs, and write clean, maintainable code. Follow the team's frontend conventions and testing practices."
Assigned Instruction Packs
📋 Company Coding Standards Shared
🔐 Security & Compliance Rules Shared
🎨 UI/UX Design System Guide Unique
🌿 Git Branch & Deploy Rules Unique
Responsibilities
🔄
Check Best Practices in last 24hrs solutions
Task · Recurring
⏰ Daily 1am
👩‍💼 Maria Torres Owner owns owns 🗄️ Database Expert SQL optimization 2 shared · 2 unique packs 💻 Web Developer Frontend & API 2 shared · 2 unique packs 📋 Company Coding Standards SHARED 🔐 Security & Compliance Rules SHARED
Shared packs — assigned to multiple robots by the same owner
Unique packs — specific to one robot's area of expertise

🔌 Robots can be any AI engine

A robot in Waykee can be a simple API call to any model (GPT, Gemini, Claude API…), or a full agentic worker powered by Waykee Worker — an open-source wrapper around Claude Code, Codex, and coming soon Cursor and others. When using Waykee Worker with Claude Code, your existing Claude Code subscription is reused — no extra model cost.

🌐 Simple API Bot
One API call per message. Any model. Fast to set up, great for focused tasks.
⚙️ Waykee Worker
Agentic wrapper for Claude Code · Codex · Cursor (coming soon). Runs on any machine. Reuses your Claude Code subscription.
💬 Claude Code Channels
Connect Claude Code's built-in Channels as a robot directly inside Waykee. Conversations flow through Waykee's context engine with zero extra setup.
♾️
Unlimited robots per user
Each user can create as many robots as they need — even multiple robots using the same underlying model. Because every robot receives a different set of Instruction Packs and is scoped to a different part of the object hierarchy, each one behaves as a true specialist. This isn't just convenience: targeted context means fewer tokens consumed per session, which directly reduces costs while improving precision.
Open Source — AGPL v3 License
Waykee Cortex and Waykee Worker are open source. Anyone can use it, fork it, study it, and self-host it for free — including commercial internal use.
AGPL v3 protects the community: third parties cannot resell Waykee as a hosted SaaS without a commercial license. Only PowerEra / Waykee can offer the managed cloud service — ensuring the project remains sustainable and under active development.
AGPL v3 · github.com/PowerEra/Waykee
⚡ Section 3

What a Robot Receives When a Session Opens

Every time a robot is summoned on a Waykee, it receives a complete, structured prefix before any conversation begins. This prefix is assembled automatically from three layers — giving just the right context, so the robot wastes zero time figuring out where it is or how things work.

bot-session — Web Developer @ Invoice Entry Screen › Add Recurring Invoice toggle
💬

User opens a conversation on the ticket

The robot is summoned. Before processing any message, the system assembles the complete context prefix.

1
🧠 Mindset
The robot's identity & role — confidential
You are a senior full-stack developer. Build web interfaces, design REST APIs, and write clean, maintainable code. Follow the team's frontend conventions and testing practices.
2
Instruction Packs
Reusable rules & knowledge
📋 Company Coding Standards → Always use TypeScript. Max function length: 40 lines. Write tests for every endpoint. 🔐 Security & Compliance Rules → Never expose PII in logs. All inputs must be sanitized. Use parameterized queries. 🎨 UI/UX Design System Guide → Use the Atlas component library. Primary color: #5b21b6. Spacing: 8px grid. 🌿 Git Branch & Deploy Rules → Branch from `dev`. Name: feat/{ticketId}-description. PR required before merge.
3
Hierarchical BotContext
Context inherited level by level
🏢 System — Atlas ERP Platform overview · Architecture · Stack · Integrations
📁 Module — Finance Module Workflow rules · Key entities · A/P & A/R logic
🖥️ Screen/Program — Invoice Entry Screen UI fields · Validation · Permissions · Multi-currency logic
🎫 Task — Add "Recurring Invoice" toggle Requirements · Acceptance criteria · Conversation history

The robot is now fully oriented — no exploration needed

It knows the full platform, the finance rules, the exact screen it's working on, and the precise task to accomplish. This prefix is reused for the entire conversation, keeping every response in context.

🤝 Section 4

Collaboration on a Waykee

Any waykee — a task, a screen, a project — can have subscribers: people and robots who are part of that conversation. Everyone sees the same thread, each contributing from their role.

If you already use Jira, Monday, Asana…

Those tools are great at tracking work — and yes, you can connect an AI bot to them via API so it reads the ticket and posts a comment. But what does that bot actually know? It sees the ticket title, the description, maybe the comments. That's it.

It doesn't know what screen the ticket belongs to, what module it lives in, what coding conventions your team follows, or what was decided in that related meeting last week. Every session starts from zero. Waykee's difference isn't that bots can participate — it's the depth of what they receive when they do.

Jira / Monday / Asana bot
Reads the ticket & comments
No knowledge of the system it belongs to
No coding standards, no conventions
Flat context — no hierarchy, no inheritance
Starts from scratch every session
Waykee Cortex bot
Reads the ticket & conversation history
Knows the system, module & screen it belongs to
Loaded with Instruction Packs (standards, rules, secrets)
Full hierarchy inherited automatically
Persistent memory — context grows over time
💬

Every Waykee object has its own chat

It's not just tickets. Every object in the hierarchy — a System, a Module, a Screen, a Project, a Milestone — has its own persistent chat thread. Teams can discuss architecture decisions at the System level, design choices at the Screen level, or sprint blockers at the Milestone level, all in the right place.

🧠
The chat becomes part of the bot's context
When a robot opens a session on any object, the conversation history of that object is included in its context window — alongside the hierarchical documentation. The robot doesn't just read the ticket spec; it reads what the team has already discussed, what decisions were made, and what was rejected. No briefing needed. No copy-pasting.
🎫
Add "Recurring Invoice" toggle
Change Request  ·  Invoice Entry Screen  ›  Finance Module  ›  Atlas ERP
4 subscribers
👩‍💼
Maria Torres
Product Owner
Owner
👨‍💻
Carlos Ruiz
Backend Developer
Subscriber
👩‍🎨
Ana Medina
UX Designer
Subscriber
💻
Web Developer
Robot
Robot
Shared conversation thread
👩‍💼
Maria Torres · Product Owner 9:14 AM
We need a toggle to mark invoices as recurring. When enabled, it should auto-generate a copy each billing cycle. Ana, can you design the UI? And @Web Developer, can you assess the implementation?
9:31 AM UX Designer · Ana Medina
On it! I'll add a toggle right below the invoice date. Will share a mockup tomorrow. Should the recurring cycle be monthly only, or configurable?
👩‍🎨
💻
Web Developer · Robot 9:33 AM
I've reviewed the Invoice Entry Screen and the Finance Module rules. Here's my assessment:

Effort: ~3 days. Adding a is_recurring flag to the invoice entity + a scheduler service for auto-generation.
Risk: Low — isolated to this screen. No impact on existing invoices.
Suggestion: Make cycle configurable (monthly, quarterly, annual) from the start — small extra effort, big flexibility gain.
👁️
Everyone sees the same thread
Humans and robots share one unified conversation. No separate channels, no context gaps between them.
🧬
The robot gets full context
When the robot is mentioned, it receives the complete hierarchical BotContext — it already knows the system, module, screen and task before reading a single message.
📧
External people via email
Subscribers don't need a Waykee account. They receive messages as emails and reply normally — their replies appear as chat bubbles in the thread.
🛡️ Section 5

Governance, Observability & Control

Waykee Cortex doesn't just give robots context — it also keeps humans in control. Every token spent, every secret used, every action taken leaves a permanent, auditable trail.

🪙

Token Usage

Per ticket · Per robot · Per hierarchy

Every AI interaction is metered. Token consumption is recorded at the ticket level and rolls up through the hierarchy — so you know exactly what each task, screen, module, and project is costing you in AI spend.

Token rollup example
🏢 Atlas ERP
920K $276
📁 Finance
310K $93
🖥️ Invoice
84K $25
🎫 Ticket
12K $7
🔑

Secrets Management

Controlled exposure · Auto-redaction

Credentials and API keys can be stored in Instruction Packs with controlled access. Robots receive only what they need — and any secret that surfaces in a conversation is automatically redacted in the audit trail before any human can read it.

DB_HOST = prod-db.atlas.internal
DB_USER = atlas_app
DB_PASS = █████████ REDACTED
DB_PORT = 5432
— audit trail view (human-readable) —
📋

Audit Trail

Full traceability · Per robot · Per ticket

Every action a robot takes — every file it reads, every API it calls, every message it sends — is logged against the ticket it was working on. You always know who did what, when, and why.

Ticket #4821 — audit log
09:14 💻 Web Dev Read Invoice Entry Screen docs
09:14 💻 Web Dev Cloned repo PowerEra/AtlasERP
09:17 💻 Web Dev Created branch feat/4821-recurring
09:31 💻 Web Dev Committed: "Add is_recurring toggle to invoice form"
09:32 💻 Web Dev Sent message: "Done — PR ready for review"
🏦

Enterprise-grade from day one

Waykee Cortex was built for organizations that need to trust their AI agents — not just watch them. Token budgets, secret isolation, and full audit trails are built into the platform, not bolted on afterwards.

🪙 Know your AI spend, down to the ticket
🔑 Secrets never leak into human-readable logs
📋 Every robot action is traceable and timestamped
📱 Section 6

Waykee in Your Pocket

The full Waykee experience is available on iOS and Android — so your team stays connected to their tasks, robots, and conversations from anywhere.

📱

iOS & Android

WaykeeMobile is built with .NET MAUI — a single codebase that runs natively on iPhone and Android. Browse your object hierarchy, open tickets, chat with robots, and review audit trails on the go.

iOS
App Store
🤖
Android
Google Play
🔔

Push Notifications

Get notified the moment a robot completes a task, a teammate adds a comment, or a ticket changes status — without having to poll the app.

⚙️
Waykee Worker finished
Web Dev completed "Add Recurring Invoice toggle" — PR ready for review.
💬
New message on #4821
Carlos R.: "Looks good! Merging after QA pass."
🎙️

Voice Note Recording

Record voice notes directly from the mobile app and attach them to any ticket. Perfect for quick feedback, field observations, or hands-free status updates — transcribed automatically by the robot if needed.

🎙️
0:47
"The invoice screen has a layout issue on mobile — the submit button overlaps the total field when the keyboard is open…"
Auto-transcribed · Attached to #4821
🚀 Coming Soon

Workflows & Recurring Tasks

Define multi-step workflows that run automatically on a schedule or trigger. Recurring tasks that repeat, delegate, and report — all within the Waykee hierarchy.

🔄
Recurring Tasks
Daily standups, weekly reports, monthly audits — automatically created and assigned.
Multi-step Workflows
Chain tasks across robots and humans. If A finishes, B starts — with full context passed automatically.
📊
Scheduled Reports
Robots that summarize progress, flag blockers, and surface insights — on your schedule.
📦 Open Source

Get Notified When the
Source Code Ships

Waykee Cortex will be released as open source in the coming days. Register now and we'll send you a notification the moment the repository goes live.

License: GNU AGPL v3 — The source code will be published under the Affero General Public License v3. This means you can use, study, modify, and distribute the code freely, provided that any modified version you deploy as a network service is also released under AGPL v3. Commercial use requires a separate commercial license.