Skip to content
kungfu-systemsPublic

About

An open engineering standard for reliable action and continuity under uncertainty.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

673 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

KFD — Kung Fu Decisions

KFD asks: How can a bounded, goal-directed system act and change in an unpredictable world without losing continuity with itself?

KFD is an open engineering standard for work that outlives the person, agent, session, repository, or tool carrying it. It keeps facts, boundaries, and responsibility inspectable as those carriers change.

KFD does not claim to be the final answer or a complete theory of complex systems. Kungfu is its founding implementation, not its adoption boundary.

Start here: the agent is not the center of truth

Two runs can produce the same output. One continues the right work under valid authority; the other does not. They look alike, but require different decisions.

What must remain continuous when the carrier changes but the work continues? KFD uses four short reminders for this break:

running != authorized
retry != same attempt
same output != same result
success != admitted Fact

An agent participates in the work; it does not define its identity, authority, history, or truth. One real delivery broke all four equivalences.

See the real failure that forces this model · Run the one-minute paired-world experiment

Choose a path

Foundation triad

The first three decisions form a simple progression:

KFD-1: facts must not drift.
KFD-2: trust must start from facts.
KFD-3: cooperation must start from trusted value.

First preserve what is true. Then make trust inspectable from those facts. Only then coordinate participants through trusted value. No principle is load-bearing until it has an inspectable product witness.

Read the foundation · See KFD under load · Inspect the formal model · See primitives in history

About this repository

This repository is KFD's canonical open decision registry. Numbered decisions live in decisions/, pre-number candidates in drafts/, and machine-readable metadata in registry.json. Primitive discovery is one frontier through which KFD tests that harder problem. It is not the whole continuity path.

For deeper material, use the repository guide and documentation map. To propose or challenge a decision, read CONTRIBUTING.md. Before contributing, run:

node scripts/check.mjs

KFD is pre-stable and evidence-governed. Verifier output is evidence, not certification, adoption proof, or release authority. See GOVERNANCE.md and LICENSE for stewardship and license boundaries.

About

An open engineering standard for reliable action and continuity under uncertainty.

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages