13. Glossary

Quick reference of terms you'll find when using KaKeKiKoKu.

Automatic mode: AI sync mode where KaKeKiKoKu pushes events in real time to the client (sync requests, out-of-date context, “Talk to AI”). Requires an AI client with channels support; today only Claude Code supports it, launched with --dangerously-load-development-channels.

Block: a bounded unit of knowledge inside a KaKeKiKoKu resource: the resource description, a section, or a subsection. Relationships and moves operate at this level.

Broken reference (broken): a relationship pointing to a resource that can't be located. Icon: 🔗 (orange).

Consult area: a read-only strip at the bottom of the central panel that shows a whole resource, opened on a block when one was asked for, without leaving the resource you are editing: usually the other end of a relationship, or another part of the resource you are editing. When you keep reading through its relations, Back returns to the previous step. It is paired with the editor: it swaps with it or closes when the editor navigates. See Reading the other end: the consult area.

Context (sidecar file): a .wuniq file that accompanies a file or folder of your project and holds its structured knowledge. In the web interface, "Create context" creates one.

Context cascade: implicit relationship between a file and the context of its containing folder. When the AI reads a file, KaKeKiKoKu tells it parent context exists.

Document text viewer: read-only central view that extracts plain text from Word .docx, OpenDocument .odt, and PDF .pdf files. It is for quick inspection, not exact layout rendering.

Draft: state of a knowledge resource indicating its content is not finalized. The AI will treat it with caution.

Entity: a standalone knowledge file (.entity.wuniq) that doesn't accompany any file or folder. For architecture decisions, rules, cross-cutting concepts.

Error: a validation problem in a context — empty description, unfilled required fields, malformed configuration. Icon: 🔴 (red).

Event: a notification KaKeKiKoKu sends to your AI in real time (detected out-of-date context, issues, user requests). Requires a client with channels; without them, KaKeKiKoKu uses Precise mode and copies the request for you to paste.

Exclusion (excluded): a file or folder pattern that KaKeKiKoKu ignores completely. It has no context, doesn't appear in the index, and isn't processed during sync. KaKeKiKoKu refuses to exclude matching resources while context still exists.

File context: accompanies a specific file. Example: AuthService.cs.wuniq.

Focus mode: display mode that hides all panels except the central editor.

Folder context: accompanies a folder. Lives inside it. Example: auth/auth.wuniq. Maximum prose size: 52,000 characters, the same as any other KaKeKiKoKu resource.

Ghost context: a context whose original file no longer exists — it was deleted or moved. Icon: 👻 (purple).

Important (important): a flag for knowledge your AI should always have in mind. When it opens the project, the AI receives the names of important resources and is asked to read them before working. What the AI receives…, on the project root, shows that text exactly.

Index: a structured listing of a folder’s files and folders with their descriptions. When it opens a project, the AI receives the root’s listing and reads the rest as it needs it, without reading all the content.

Incoming relationship: a relationship created in another resource that points to the block you are viewing. Its meaning is edited from the origin resource.

KaKeKiKoKu Studio: the application for managing project knowledge. It stores that knowledge in the Wuniq format, using files with the .wuniq extension.

Knowledge graph: a network of relationships between knowledge resources. Allows navigating connections: a decision linked to the files that implement it.

Local HTTP connection: the quickest way for a local AI to start using Studio, through a startup instruction file; meant for a first look at a small project. Studio must be running and reachable by the AI’s tools. See the common connection guide.

MCP (Model Context Protocol): an open standard created by Anthropic that allows AIs to connect with external tools. KaKeKiKoKu recommends MCP for everyday work; its local HTTP connection is the quickest way to start, but only for a first look.

Out-of-date context: the file changed but its context was not updated, so the context may no longer describe it. Your AI receives this state as drift. Icon: ▲ (amber).

Outgoing relationship: a relationship stored in the block you are viewing, pointing to another resource, section, or subsection.

Pending (pending): a flag marking a resource as needing attention or additional work.

Precise mode: default AI sync mode. KaKeKiKoKu detects changes and notifies you visually; you decide when to invoke the AI by typing sync. “Talk to AI” buttons copy to the clipboard. Used with local HTTP or an MCP client without channels.

Project: a folder on your computer managed by KaKeKiKoKu. Contains a .wuniq/ subfolder with the configuration.

Project map: read-only map mode where the navigation tree expands into a wider project overview with sections, descriptions, previews, and relationship arrows.

Recent resources without context: a file or folder created or modified during this session that has no context. Your AI receives a resource without context as orphan. Icon: ❓ (blue).

Relationship: a directed link between two knowledge blocks, stored by UUID. Doesn't break when moving or renaming files. Descriptions hold up to 200 characters.

Relationship budget: each resource holds up to 20 outgoing relationships within a shared character budget. Incoming relationships have no cap; on AI reads KaKeKiKoKu serves the most descriptive ones first and notes how many more exist.

Relationship arrow: visual line connecting a relationship in the central editor with its target or origin in the navigation tree. Concrete arrows can be selected; dotted or grouped arrows reveal hidden targets.

Relationship shortcut: a row in the navigation tree that shows one relationship of a resource or block, with the icon and name of the other end, a direction mark, and the relationship’s description. It never expands; clicking it takes you to the real resource and block.

Reserved section: one of the nine sections predefined by KaKeKiKoKu, each with a fixed meaning: _description, _summary, _conclusions, _does, _rules, _careful, _whyNot, _soul, _guide.

Resources without context: files and folders that existed before this session and have no context. They are presented in batches of 25. If there are more than 25, an OFF/ON switch in the right-hand sync panel, labeled Add context with AI, controls when your AI starts processing them. Different from recent resources without context. Icon: ⌛ (amber).

Session rules: a file your AI client loads at the start of a conversation to tell it to use KaKeKiKoKu, beginning with open list and help. AGENTS.md is shared by most clients, including recent Claude Code versions. Existing CLAUDE.md instructions, dedicated .claude/rules/wuniq.md rules, or another client’s equivalent can also hold the startup block. Each integration guide explains the location and loading conditions.

Schema: the set of custom sections that exist in a project. Its read-only inventory is available from Settings > Schema.

Section: a block of knowledge within a .wuniq resource. Can be reserved (_description, _does, _rules...) or custom. Limit: 4,000 characters.

Snapshot: a point-in-time backup of a project's knowledge. Created automatically when opening the project and on demand.

Structural warning (other issues): a minor format or configuration problem detected by sync — a subsection without a section, a name collision, text outside the format, a context left for an excluded resource. It has its own counter so it never gets mistaken for a real error. Icon: ⚠️ (amber).

Subsection: a section nested within another section. Same 4,000-character limit. Allows creating more extensive knowledge blocks.

Sync (synchronization): a complete project analysis that detects where files and their context no longer match, applies automatic fixes when the solution is unique, and reports the rest. Run it from the bottom bar or by telling your AI "do a sync".

Untracked: a resource visible to KaKeKiKoKu but intentionally kept without context. Sync won't insist on adding context for it. Use Untrack to set this state and Include to return the resource to normal tracking. KaKeKiKoKu refuses to untrack a resource while its context still exists.

UUID: a unique internal identifier that KaKeKiKoKu assigns to each knowledge resource. Allows relationships to survive moves and renames.

Working directory: the base folder your AI client works from, and where KaKeKiKoKu looks for your projects and writes knowledge exports. You set it on the welcome screen.

Wuniq format: the plain-text format for structured project knowledge used by KaKeKiKoKu Studio. Its file extension is .wuniq. See The Knowledge File Format for its structure.