self-evolution

Installation
SKILL.md

Project Self-Evolution Knowledge System

This skill creates and governs a living knowledge base that evolves with a software project. It addresses three fundamental gaps: the reality gap (actual state vs documented), the access gap (documented vs discoverable), and the trust gap (discovered vs trustworthy).

Read references/philosophy.md if you need to understand WHY the system works this way. This file tells you WHAT to do and WHEN.

Mode Detection

Determine the operating mode from context:

User says Mode
"initialize", "init", "set up knowledge base" Initialize (auto-detects empty vs existing)
"deep onboard", "comprehensive init", "audit and restructure" Deep Brownfield Onboarding (Mode 2B)
"evolve", "update knowledge", "compress inbox", "promote" Evolve
"check health", "KB health", "knowledge base status" Health Check
"crystallize", "turn this into a workflow", "formalize this process" Crystallize
"improve the skill", "skill maintenance", "fix the skill" Skill Maintenance
(completing a non-trivial task, no explicit request) Capture (ambient)
Installs
10
GitHub Stars
4
First Seen
Apr 27, 2026