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, drift, “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).

Context: synonym for sidecar in KaKeKiKoKu's web interface. "Create context" = create a sidecar.

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

Discard (untracked): a resource visible to KaKeKiKoKu but intentionally kept without a sidecar. Sync won't insist on documenting it. KaKeKiKoKu refuses to discard a resource while context still 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.

Drift: desynchronization between a file and its sidecar. The file changed but the knowledge was not updated. Icon: ▲ (amber).

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 sidecar — empty description, unfilled required fields, malformed configuration. Icon: 🔴 (red).

Event: a notification KaKeKiKoKu sends to your AI in real time (detected drift, 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 sidecar, doesn't appear in the index, and isn't processed during sync. KaKeKiKoKu refuses to exclude matching resources while context still exists.

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

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

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

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

Important (important): a flag that marks a resource so its sidecar is automatically sent to the AI when opening the project.

Index: a structured listing of all files and folders in the project with their descriptions. What the AI receives when opening a project — 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.

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

MCP (Model Context Protocol): an open standard created by Anthropic that allows AIs to connect with external tools. KaKeKiKoKu works as an MCP server.

Orphan: a file or folder that exists but has no sidecar. Two types: recent (created this session) and pending (inherited). Icon: ❓ (blue).

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.

Pending documentation: inherited files without a sidecar, presented in batches of 25. If there are more than 25, an OFF/ON switch in the right-hand sync panel controls when your AI starts processing them. Different from "recently undocumented". Icon: ⌛ (amber).

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. Works with any MCP client.

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.

Recently undocumented: a file or folder created or modified during this session that has no sidecar. 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 12 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.

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

Session rules: a file at the root of your project that your AI client reads at the start of every conversation. Injects automatic instructions so the AI begins by running open list with KaKeKiKoKu, reads sidecars before editing code, and so on. Typical files: .claude/rules/wuniq.md (Claude Code), AGENTS.md (Codex, Antigravity, and others), .cursorrules (Cursor). Each client annex covers it.

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.

Sidecar: a .wuniq file that accompanies a file or folder of your project, containing its structured knowledge.

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 — an orphan subsection, 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 desynchronizations, 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".

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.