Skip to content
k-os

k-os

Konstruct Operating System — a GitHub-backed store of markdown documents for Konstruct Digital. k-os is the Notion replacement: client docs, internal policies, and shared playbooks live here as plain markdown files.

It’s read and written by Konstruct’s agents (Wolfgang, Jordan, Fitzy) through the kos_search, kos_read, and kos_save tools. Folder paths are scoped per-channel by the channel’s Client: <slug> marker — so a Slack channel mapped to a specific client can only reach that client’s folder plus the shared global/ area.

Layout

Section titled “Layout”
  • global/ — applies to all clients. Shared playbooks, templates, recurring process docs, anything any agent should be able to read regardless of which client they’re working on.
  • clients/<slug>/ — per-client docs. The slug matches the Client: <slug> line in the channel description in Slack. Lowercase, hyphen-separated.
  • internal/ — Konstruct-only policies and procedures that must never influence client-facing work. Currently not exposed to any agent; will be gated to a future dedicated agent.

Conventions

Section titled “Conventions”
  • Lowercase, hyphen-separated filenames: seo-audit.md, not SeoAudit.md.
  • One topic per file, .md extension required by the agent tools.
  • Nested subfolders within a scope are fine: clients/baker-tilly/seo/audit.md.
  • Write content as normal prose with proper capitalization, headings, etc. Only the filenames need the kebab-case rule.

How docs get edited

Section titled “How docs get edited”

Two ways:

  1. Directly in this repo (GitHub UI or local clone) — same as any markdown repo.
  2. Through Slack — ask an agent to save or update a doc, e.g. “save these notes to k-os as seo-audit-2026-h1” in a channel mapped to that client.