talvikai/mak4i-protocol

Open protocol for reusable AI artifacts, knowledge continuity, and check-before-create workflows across AI tools.

0

stars

20

commits

JavaScript

primary language

Sep 8, 2026

updated

talvik.ai
ai-artifacts
ai-interpretability
ai-workflows
artificial
artificial-intelligence
context-management
developer-tools
knowledge-management
mak4i
mcp
open-source
protocol

README

MAK4I — Memory, Artifacts & Knowledge for Intelligence

The protocol for not rebuilding what your AI already built.

Built by Talvik, Inc.

Status: Phase 0 — Foundation. This repo currently contains the protocol design, specification draft, and documentation. The reference API implementation (backend, CLI, SDK) has not been built yet — that's Phase 2. See ROADMAP.md for what exists today versus what's planned.


What MAK4I Is

MAK4I is an open protocol for packaging, identifying, versioning, sharing, injecting, and reusing AI artifacts across models, platforms, and organizations.

New to MAK4I? Start with Understanding MAK4I for a plain-language explanation of MAK4I, what a MAK specification is, and how the core MAK standards work together.

A MAK4I artifact can represent:

  • Project context
  • Procedural knowledge (how to do something, consistently)
  • Prompts
  • Workflows
  • Architecture and API contracts
  • Historical decisions and rationale
  • Reusable outputs (documents, code, templates)

Memory is one artifact type — not the entire protocol. Just as Git standardized source control and npm standardized package distribution, MAK4I standardizes how reusable AI artifacts move between tools instead of being rebuilt from scratch in each one.

Claude Code, Cursor, ChatGPT, Gemini, Bedrock, Copilot, internal agents
                              │
                        MCP / SDK / API
                              │
                            MAK4I
                              │
              Registry · Artifacts · Knowledge · Context

See ARCHITECTURE.md for the full architecture, including what's actually implemented today versus planned.


Protocol Philosophy

MAK4I is the protocol. Talvik builds the platform.

MAK4I Protocol (open, MIT licensed)
    ↓
Talvik Registry (hosted)
Talvik Enterprise (commercial)
Talvik SDK (Python, Node.js, Go, Rust)
Talvik CLI (mak4i install, inject, publish)

Open protocol forever. Commercial ecosystem on top.

Following the open protocol + commercial ecosystem approach used by projects such as Git, Kubernetes, and OpenTelemetry.


How MAK4I Is Different

The AI memory space is crowded — Mem0, Google's Open Knowledge Format, Open Memory Protocol, and every major platform's native memory all solve some version of "the AI doesn't remember." MAK4I was designed after evaluating the existing landscape of AI memory, knowledge, and interoperability projects. See COMPETITIVE_LANDSCAPE.md for the full comparison.

MAK4I isn't trying to out-remember them. It solves a narrower, different problem:

If your problem is...Look at
"The AI doesn't remember my preferences"Mem0, native platform memory
"Our knowledge should live in files, not a vendor's database"Google's OKF
"I want lifecycle and staleness tracked, but nothing stops duplicate work"OKF v0.2, ByteRover
"We keep paying to regenerate things we already built, and nothing actually stops that from happening again"MAK4I

MAK4I is a reuse discipline, enforced as a protocol behavior: check the registry before generating anything, reuse or adapt what exists, and only create new when nothing matches. That check is a protocol guarantee, not an optional convention a client can skip — the distinction that matters, since tracking that an artifact could be reused is different from a runtime that requires checking first. Every reuse decision is logged with a real token-savings estimate — not a benchmark claim, a running ledger designed to track actual reuse over time (currently reflecting development-time observations — see Proof of Concept below).


The Problem

Every AI tool represents reusable knowledge differently — Claude has Projects, Artifacts, and Skills; Cursor has Rules; ChatGPT has Memory; GitHub Copilot has Instructions. None of those representations travel between tools. Switch tools and you start from zero.

You re-explain your stack, regenerate code that already exists, re-establish context that was already shared.

That's waste — computational, financial, and environmental.

At 1 million AI sessions per day each wasting 1,000 tokens — that is 1 billion tokens per day in avoidable generation.

As AI moves toward metered compute billing, that waste becomes a direct dollar cost for every business running AI at scale.

MAK4I fixes this.


Three Memory Types

TypeAnswersExamples
ProceduralHow?Code frameworks, deployment pipelines, engineering playbooks
SemanticWhat?System architecture, schemas, API contracts, domain models
EpisodicWhy?Decisions made, rationale, sprint history, team conventions

Together they provide complete project continuity across any AI tool.


How It Works

# Install memory packs
mak4i install company/backend-standards
mak4i install schedovia/context

# Inject before any AI session
mak4i inject

# AI session starts with full context
# No re-explaining. No regenerating. Continue instantly.

Quick Example

{
  "id": "schedovia-stack-context",
  "version": "1.0.0",
  "type": "context",
  "layer": "episodic",
  "name": "Schedovia Stack Context",
  "description": "Full stack context for Schedovia — eliminates re-explaining architecture each session",
  "token_estimate": 1500,
  "tags": ["schedovia", "stack", "context"]
}

Proof of Concept

MAK4I's core reuse mechanism — checking for and reusing existing artifacts instead of regenerating them — was demonstrated during MAK4I's own development process, before any API existed. Early figures below reflect that development-time observation, not production traffic.

MetricValue
Tokens saved (dev-time observation)38,400+
Sessions tracked29
Artifacts registered9 across 6 types

See docs/MAK4I_SAVINGS_LOG.md for the full, dated session-by-session breakdown.

WD Technology Solutions is Talvik's design partner and the intended first production adopter, once the Phase 2 API is live. See ROADMAP.md for the integration plan.


Roadmap

MAK4I uses the MAK-XXXX convention for protocol standards. See ROADMAP.md for the full phase-by-phase roadmap and VISION.md for the standards list — this repo is currently Phase 0 — Foundation (Aug 2026).


Vision

Write knowledge once. Inject anywhere. Continue instantly.

MAK4I is to AI sessions what npm is to Node.js.

Portable AI Memory. Open Forever.


  • Website: talvik.ai
  • Documentation: GitHub
  • Company: Talvik, Inc.
  • License: MIT

© 2026 Talvik, Inc. — MAK4I Protocol is open source, MIT licensed.

Contributors

abalakrishnan86

10 commits

aswin22886

9 commits

talvikai/mak4i-protocol

Open protocol for reusable AI artifacts, knowledge continuity, and check-before-create workflows across AI tools.

0

stars

20

commits

JavaScript

primary language

Sep 8, 2026

updated

talvik.ai
ai-artifacts
ai-interpretability
ai-workflows
artificial
artificial-intelligence
context-management
developer-tools
knowledge-management
mak4i
mcp
open-source
protocol

README

MAK4I — Memory, Artifacts & Knowledge for Intelligence

The protocol for not rebuilding what your AI already built.

Built by Talvik, Inc.

Status: Phase 0 — Foundation. This repo currently contains the protocol design, specification draft, and documentation. The reference API implementation (backend, CLI, SDK) has not been built yet — that's Phase 2. See ROADMAP.md for what exists today versus what's planned.


What MAK4I Is

MAK4I is an open protocol for packaging, identifying, versioning, sharing, injecting, and reusing AI artifacts across models, platforms, and organizations.

New to MAK4I? Start with Understanding MAK4I for a plain-language explanation of MAK4I, what a MAK specification is, and how the core MAK standards work together.

A MAK4I artifact can represent:

  • Project context
  • Procedural knowledge (how to do something, consistently)
  • Prompts
  • Workflows
  • Architecture and API contracts
  • Historical decisions and rationale
  • Reusable outputs (documents, code, templates)

Memory is one artifact type — not the entire protocol. Just as Git standardized source control and npm standardized package distribution, MAK4I standardizes how reusable AI artifacts move between tools instead of being rebuilt from scratch in each one.

Claude Code, Cursor, ChatGPT, Gemini, Bedrock, Copilot, internal agents
                              │
                        MCP / SDK / API
                              │
                            MAK4I
                              │
              Registry · Artifacts · Knowledge · Context

See ARCHITECTURE.md for the full architecture, including what's actually implemented today versus planned.


Protocol Philosophy

MAK4I is the protocol. Talvik builds the platform.

MAK4I Protocol (open, MIT licensed)
    ↓
Talvik Registry (hosted)
Talvik Enterprise (commercial)
Talvik SDK (Python, Node.js, Go, Rust)
Talvik CLI (mak4i install, inject, publish)

Open protocol forever. Commercial ecosystem on top.

Following the open protocol + commercial ecosystem approach used by projects such as Git, Kubernetes, and OpenTelemetry.


How MAK4I Is Different

The AI memory space is crowded — Mem0, Google's Open Knowledge Format, Open Memory Protocol, and every major platform's native memory all solve some version of "the AI doesn't remember." MAK4I was designed after evaluating the existing landscape of AI memory, knowledge, and interoperability projects. See COMPETITIVE_LANDSCAPE.md for the full comparison.

MAK4I isn't trying to out-remember them. It solves a narrower, different problem:

If your problem is...Look at
"The AI doesn't remember my preferences"Mem0, native platform memory
"Our knowledge should live in files, not a vendor's database"Google's OKF
"I want lifecycle and staleness tracked, but nothing stops duplicate work"OKF v0.2, ByteRover
"We keep paying to regenerate things we already built, and nothing actually stops that from happening again"MAK4I

MAK4I is a reuse discipline, enforced as a protocol behavior: check the registry before generating anything, reuse or adapt what exists, and only create new when nothing matches. That check is a protocol guarantee, not an optional convention a client can skip — the distinction that matters, since tracking that an artifact could be reused is different from a runtime that requires checking first. Every reuse decision is logged with a real token-savings estimate — not a benchmark claim, a running ledger designed to track actual reuse over time (currently reflecting development-time observations — see Proof of Concept below).


The Problem

Every AI tool represents reusable knowledge differently — Claude has Projects, Artifacts, and Skills; Cursor has Rules; ChatGPT has Memory; GitHub Copilot has Instructions. None of those representations travel between tools. Switch tools and you start from zero.

You re-explain your stack, regenerate code that already exists, re-establish context that was already shared.

That's waste — computational, financial, and environmental.

At 1 million AI sessions per day each wasting 1,000 tokens — that is 1 billion tokens per day in avoidable generation.

As AI moves toward metered compute billing, that waste becomes a direct dollar cost for every business running AI at scale.

MAK4I fixes this.


Three Memory Types

TypeAnswersExamples
ProceduralHow?Code frameworks, deployment pipelines, engineering playbooks
SemanticWhat?System architecture, schemas, API contracts, domain models
EpisodicWhy?Decisions made, rationale, sprint history, team conventions

Together they provide complete project continuity across any AI tool.


How It Works

# Install memory packs
mak4i install company/backend-standards
mak4i install schedovia/context

# Inject before any AI session
mak4i inject

# AI session starts with full context
# No re-explaining. No regenerating. Continue instantly.

Quick Example

{
  "id": "schedovia-stack-context",
  "version": "1.0.0",
  "type": "context",
  "layer": "episodic",
  "name": "Schedovia Stack Context",
  "description": "Full stack context for Schedovia — eliminates re-explaining architecture each session",
  "token_estimate": 1500,
  "tags": ["schedovia", "stack", "context"]
}

Proof of Concept

MAK4I's core reuse mechanism — checking for and reusing existing artifacts instead of regenerating them — was demonstrated during MAK4I's own development process, before any API existed. Early figures below reflect that development-time observation, not production traffic.

MetricValue
Tokens saved (dev-time observation)38,400+
Sessions tracked29
Artifacts registered9 across 6 types

See docs/MAK4I_SAVINGS_LOG.md for the full, dated session-by-session breakdown.

WD Technology Solutions is Talvik's design partner and the intended first production adopter, once the Phase 2 API is live. See ROADMAP.md for the integration plan.


Roadmap

MAK4I uses the MAK-XXXX convention for protocol standards. See ROADMAP.md for the full phase-by-phase roadmap and VISION.md for the standards list — this repo is currently Phase 0 — Foundation (Aug 2026).


Vision

Write knowledge once. Inject anywhere. Continue instantly.

MAK4I is to AI sessions what npm is to Node.js.

Portable AI Memory. Open Forever.


  • Website: talvik.ai
  • Documentation: GitHub
  • Company: Talvik, Inc.
  • License: MIT

© 2026 Talvik, Inc. — MAK4I Protocol is open source, MIT licensed.

Contributors

abalakrishnan86

10 commits

aswin22886

9 commits

Languages

JavaScript

100.0%