whatisgithub

What is sublation?

sven-mirana/sublation — explained in plain English

Analysis updated 2026-05-18

30PythonAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A governance framework that lets AI agent skills improve over time through audited proposals, never by an agent editing its own live skills.

Mindmap

mindmap
  root((sublation))
    What it does
      Agent skill governance
      Read-only active skills
      Audited change pipeline
    Tech stack
      Python
      CLI scripts
    Use cases
      Track failures
      Review candidate changes
      Rollback safety window
    Audience
      AI agent developers
    Status
      Maintenance mode
      Version 1.0

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Keep an audit trail and human checkpoint whenever an AI agent's skills need to change.

USE CASE 2

Turn a failed skill execution into a sandboxed candidate change that goes through review.

USE CASE 3

Roll back a promoted skill change if it causes problems in production.

USE CASE 4

Merge and consolidate many overlapping agent skills down into fewer, cleaner ones.

What is it built with?

PythonCLI

How does it compare?

sven-mirana/sublationchandar-lab/semantic-wmdjlougen/hive
Stars303030
LanguagePythonPythonPython
Setup difficultymoderatehardeasy
Complexity3/55/53/5
Audiencedeveloperresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Command-line driven pipeline, requires understanding the observation, candidate, audit, and promotion workflow before first use.

So what is it?

Sublation is a governance framework for managing skills used by AI agents. The name comes from a philosophical concept (Aufhebung in German) that means preserving something while also changing it. Applied here, it describes a process where agent skills are improved over time based on observed failures, but never by having the agent directly edit its own live skills. The core problem it addresses is control: if an AI agent can freely modify its own instructions or capabilities, there is no audit trail and no human checkpoint. Sublation solves this by treating all active skills as read-only. When an agent encounters a failure during a skill execution, it files an observation describing what went wrong. From that observation, a candidate is created, which is a sandboxed proposed change. The candidate goes through a 22-point audit covering correctness, safety, and consistency checks. It then requires cross-agent review and user approval before being promoted to replace the active skill. After promotion, there is a safety window where the change is monitored in production. If something goes wrong, a rollback mechanism is available. The framework tracks provenance and license information for any content that gets incorporated into skills. The framework supports four types of changes: patches to the skill specification, enhancements to scripts, infrastructure fixes, and tooling improvements. It also handles merging multiple skills together, which the README notes was used to reduce 32 skills down to 11 in one consolidation effort. The project is described as being in maintenance mode at version 1.0, meaning the framework is considered complete and future changes will only come from real usage revealing problems, not from adding features speculatively. It is built in Python and uses command-line scripts to drive each stage of the pipeline.

Copy-paste prompts

Prompt 1
Explain how Sublation's observation to candidate to promotion pipeline works for AI agent skills.
Prompt 2
Walk me through the 22-point audit a candidate change goes through before promotion.
Prompt 3
How would I use Sublation to safely consolidate 32 overlapping agent skills into 11?
Prompt 4
Show me how the rollback and safety window mechanism works after a skill change is promoted.

Frequently asked questions

What is sublation?

A governance framework that lets AI agent skills improve over time through audited proposals, never by an agent editing its own live skills.

What language is sublation written in?

Mainly Python. The stack also includes Python, CLI.

How hard is sublation to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is sublation for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.