Skip to content
Documentation

Welcome to cajeX

cajeX is an architecture governance platform. It helps your team turn unstructured architectural knowledge — standards documents, policy PDFs, whitepapers, Confluence pages — into approved directives, then applies those directives automatically when reviewing real projects.

This guide is written for everyday users of cajeX. It walks you through every feature you can interact with, starting from your first login and finishing with the workspace-admin and workspace-owner controls.

Who this guide is for

  • Members and reviewers — anyone who logs in to capture knowledge, submit projects, run reviews, or track findings.
  • Workspace admins — anyone who manages members, branding, security, billing visibility, and identity for a workspace.
  • Workspace owners — the single account responsible for plan changes, ownership transfer, and workspace deletion.

This guide covers the everyday cajeX experience. Some advanced surfaces aimed at compliance and platform teams are outside its scope — if you think you need more than what's here, ask your workspace owner.

Key concepts in 60 seconds

ConceptWhat it is
WorkspaceAn isolated tenant. Every project, directive, finding, and member belongs to exactly one workspace. You can belong to several workspaces and switch between them from the header.
Knowledge Base (KB)Your raw material — documents, links, attachments, structured entries. The AI ingests the KB to understand your organisation's context.
DirectiveAn atomic, approved rule distilled from the knowledge base. Three flavours: Principles (why), Decisions (what), Guardrails (how). Every governance module produces, applies, or audits directives.
ProjectA submission for review — typically an architecture proposal, design doc, or change request — that the AI reviews against approved directives.
SessionA scheduled architecture review with participants, a workflow template, and a state machine (Draft → Scheduled → In Progress → Completed).
FindingAn issue raised against a project, either by the AI or a human reviewer. Each finding has a severity, an owner, a status, and a link back to the directive it violated.
ReportA point-in-time governance report card for a project, snapshot, or program. Exportable to Markdown or PDF.

If only one of these clicks for you, make it directives. They are the centre of cajeX — every other feature exists to produce, apply, or audit them.

How to use this guide

Each chapter focuses on one feature area, opens with a screenshot of the screen you'll be looking at, and explains:

  • What it does — one or two sentences.
  • How to use it — the common actions, in order.
  • Permissions — who can do what (member / admin / owner).
  • Tips — non-obvious things that will save you time.

You don't need to read end-to-end. Jump to the chapter that matches the screen you're on.