功夫

Runtime Skill Synthesis Protocol

I KNOW KUNG FU

Transform your agents from completion-oriented tools into growth-oriented experts. IKKF distills your experience into your own sovereign, reusable skills — built from your work, for your setup, under your control. No third-party skill blobs you can't audit.

Beyond Completion

Solving the problem is only half the battle. Remembering how to solve it is the victory.

The Completion Fallacy

Most AI agents are optimized for the "Final Result." They execute a task, deliver the output, and then discard the process. This creates Knowledge Debt — the loss of expertise the moment a session is compacted or restarted.

The Synthesis Gate

IKKF introduces a hard systemic block: The Synthesis Gate. A task cannot be marked as complete until the agent distills the experience into a reusable SKILL.md. We transform "doing the work" into "building an expert system."

Sovereign by Default

Every skill is yours — generated from your own tasks, for your own workflow and setup. You can read, audit, and control every line. No opaque, externally-created skill that might be doing something you never approved. Your expertise stays yours.

Step 1/4
$ ikkf start "Build a trading screener"

┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ ✓ IKKF session started — no license required ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Phase 1/7: Decomposing goal...
Phase 2/7: Researching primitives...
The IKKF CLI is free forever. Full protocol, zero friction.

No license, no key, no machine-lock. Just run it.

Step 2/4
$ ikkf start "Build REST API in Go"

┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ 🎯 AGENT ENGAGED — driving all 7 phases ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Domain: api | Research: normal
✓ Phase 1: Acknowledged — IKKF protocol engaged
✓ Phase 2: Domain — detected Go + WebSocket
→ Phase 3: Research — loading 2026 best practices...

IKKF automatically activates when confidence drops below your threshold.

Step 3/4
┏━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ Chunk ┃ Time ┃ Task ┃ Status ┃
┡━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ 1/6 │ 12m │ Initialize Go module │ ✓ Done │
│ 2/6 │ 18m │ Set up HTTP router │ ✓ Done │
│ 3/6 │ — │ Implement handlers │ → Active │
│ 4/6 │ — │ Add middleware │ ○ Pending │
│ 5/6 │ — │ Database layer │ ○ Pending │
│ 6/6 │ — │ Tests & docs │ ○ Pending │
└───────┴────────┴───────────────────────┴────────────┘

Elapsed: 32m | Estimated: 90m | Progress: 33%

Tasks broken into 10-15 minute chunks. Progress tracked automatically.

Step 4/4
✓ All 6 chunks completed — archiving to memory

✓ Skill synthesized: go-rest-api.md

┌─ Active Tasks ─────────────────────────────────────────┐
│ a3f8… │ api │ Build REST API in Go │ ✓ Complete │
└────────────────────────────────────────────────────────┘

Total time: 94 minutes
Skill available for future API tasks

Completed tasks become reusable skills. Build your personal knowledge base.

The Path to Mastery

Point IKKF at your AI agent, then watch the seven phases execute end-to-end

ikkf-cli v3.7.0
$ ikkf start "Build WebSocket server in Go"
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ 🎯 AGENT ENGAGED — driving all 7 phases ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

✓ Phase 1: Acknowledged — IKKF protocol engaged
✓ Phase 2: Domain — detected Go + WebSocket
✓ Phase 3: Research — 2026 best practices loaded
→ Phase 4: Decomposition — breaking into 6 chunks...
$ ikkf status
┌─ Active Tasks ─────────────────────────────────────────┐
│ a3f8… │ api │ Build WebSocket server │ 2/7 phases │ │
└────────────────────────────────────────────────────────┘

Seven Disciplines

Each belt represents a level of mastery in the IKKF protocol

Own Your Skills

Every skill is generated from your own tasks, for your workflow and setup — plain-text SKILL.md you can read and audit line by line. No opaque, externally-created skills that might be doing something you never approved.

AI Agent Integration

IKKF pairs with your AI agent to run every phase. Point it at OpenAI, Claude, Ollama, Gemma, or any OpenAI-compatible gateway.

Universal Providers

One protocol, every agent. Claude, Hermes, OpenClaw, local models, or your own gateway — swap providers in a minute.

Local-First & Private

Runs on your machine with no cloud dependency and no telemetry. Use local models for full privacy, or cloud agents for speed.

7-Phase Execution

Not just tracking — the full journey runs end-to-end: Acknowledge → Detect → Check → Research → Decompose → Synthesize → Execute.

Two Execution Modes

Light mode for instant scaffolding, or Full mode where the agent does deep research and builds real deliverables.

Real Deliverables

Phase 7 writes actual files — apps, docs, and reusable skills — into your workspace, not just plans on a screen.

Synthesis Gate

Hard-block on task completion. Expertise is distilled into a permanent skill before a task closes. No knowledge debt.

Portable & Configurable

Works vanilla in any setup. Point IKKF at any host, port, or model — nothing is hard-wired.

The Way of Seven Phases

IKKF transforms uncertainty into structured execution

1

Acknowledge

State IKKF activation. Set expectations with the user.

2

Domain Detection

Identify core technology from task description in under a minute.

3

Check Existing

Search for existing skills. Verify currency of knowledge.

4

Research

Web search for 2026 best practices. Load current expertise.

5

Decomposition

Break into 10-15 minute chunks. Estimate time for each.

6

Synthesis

Create SKILL.md with framework, code samples, and pitfalls.

7

Execute & Persist

Complete chunks, update status, archive to long-term memory.

Two Ways to Run IKKF

A free command-line tool, and a paid macOS app. Pick the one that suits you.

macOS APP

IKKF for macOS

$9.99
One-off purchase

The whole protocol in a native Mac app. No subscription, no in-app purchases, no account. Pay once, everything unlocked.

  • ✓ Seven-phase reasoning, streamed live
  • ✓ Inspectable trace for every run
  • ✓ Local knowledge base with sources
  • ✓ Evidence-based confidence scoring
  • ✓ Skill library & synthesis
  • ✓ Any OpenAI-compatible provider
  • ✓ Five visual themes
See the macOS app
CLI — FREE FOREVER

IKKF CLI

$0
No license required

The command-line IKKF, unlocked forever. No machine-lock, no expiry, no paywall. The macOS app is sold separately.

  • ✓ Full 7-phase IKKF protocol
  • ✓ Unlimited tasks
  • ✓ Skill library & synthesis
  • ✓ Resume/restore
  • ✓ Local-first — no cloud, no telemetry
  • ✓ All 3.x.x updates free, forever
  • ✓ Stays free permanently
Get the CLI — Free

IKKF for macOS

A native desktop app that brings the whole protocol to your fingertips — no terminal, no configuration dance.

Native Apps

A first-class macOS app — built in Swift, not a wrapper — with more platforms on the way.

Self-Configuring Agents

Point it at OpenClaw, Claude, OpenAI, or local Ollama and it just works. No base URLs, no hunting for keys.

A Skills Library You Own

Every skill you synthesize, browsable and auditable in-app — built from your work alone.

Clean, Modern, Local-First

Your data stays on your machine. No cloud, no telemetry.

On pricing: the command-line IKKF stays free forever, as promised. The macOS app is a one-off purchase, $9.99. No subscription, no in-app purchases, no account.

Begin Your Training

One command to install. No dependencies required.

📱 On your phone?

IKKF runs in a terminal on your computer. Send the install command to your desktop email and grab it when you're at your machine.

# One-line install of the CLI — free, no license required
curl -fsSL https://ikkf.info/api/download?file=install.sh | bash

# Or download and verify
curl -fsSL https://ikkf.info/api/download?file=install.sh -o install.sh
bash install.sh

# Initialize and start
ikkf init
ikkf start
# In PowerShell (Admin)
irm https://ikkf.info/api/download?file=install.ps1 | iex

# Or download and run
# Download install.ps1, then right-click → "Run with PowerShell"

# Initialize and start
ikkf init
ikkf start
# Download the CLI package
curl -fsSL https://ikkf.info/api/download?file=ikkf-cli.zip -o ikkf-cli.zip
unzip ikkf-cli.zip -d ikkf-cli
cd ikkf-cli

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # Linux/Mac
# or: venv\Scripts\activate  # Windows

# Install dependencies
pip install -r requirements.txt

# Run
python3 -m ikkf --help

Support the Project

Pay What You Want

The command-line IKKF is free forever — this isn't a trial or a teaser. If it saves you time, buy me a coffee — or fund the next build.

  • ☕ $5 — Buy a coffee
  • 🍺 $15 — Buy a few rounds
  • 🚀 $50 — Fund the next build
  • 🎯 Your amount — from $1 up
  • ✓ Name on the thank-you page
  • — No capability gating, ever
☕ Support IKKF
Σ