"for yourself, thanks!" — Knowledge packs for agent self-education
This directory contains knowledge packs — curated collections of information, specifications, and examples for each major Lethean framework. These packs enable agents to understand, navigate, and contribute to the dAppCore ecosystem autonomously.
Knowledge packs serve as self-contained knowledge bases for:
- Agent Onboarding — New agents can quickly understand each framework
- Agent Navigation — Agents can discover available tools and patterns
- Agent Contribution — Agents can understand how to contribute to each framework
- Human Reference — Developers can browse organized documentation
| Framework | Description | Repository | Status |
|---|---|---|---|
| CoreGo | Zero-dependency Go framework | forge.lthn.sh/core/go |
✅ v1.0.0 |
| CoreGUI | Wails v2 GUI framework | forge.lthn.sh/core/gui |
✅ v1.0.0 |
| CoreTS | TypeScript frontend framework | forge.lthn.sh/core/ts |
✅ v1.0.0 |
| CoreCLI | CLI framework | forge.lthn.sh/core/cli |
✅ v1.0.0 |
| CorePlay | Fullstack framework (Go + TS) | forge.lthn.sh/core/play |
✅ v1.0.0 |
| CorePHP | PHP framework | forge.lthn.sh/core/php |
✅ v1.0.0 |
Each knowledge pack follows a consistent structure:
knowledge-packs/<framework>/
├── README.md # Framework overview and usage
├── INDEX.md # Package/component catalog (optional)
├── SPEC.md # Framework specification (if not in plans)
└── examples/ # Example code and patterns (future)
README.md contains:
- Framework overview and purpose
- Key statistics
- Architecture diagram
- Core components
- Getting started guide
- Use cases (when to use/not use)
- Agent tips
- Related knowledge packs
Knowledge packs complement the canonical specifications in plans/:
| Location | Purpose | Audience |
|---|---|---|
plans/ |
Canonical specs — RFCs, design documents | Humans + Agents |
knowledge-packs/ |
Curated knowledge — organized, agent-optimized | Agents + Humans |
skills-okf/ |
OKF bundle — interoperable knowledge format | Agents + Tools |
Source of Truth Hierarchy:
plans/ (canonical)
↓
knowledge-packs/ (curated)
↓
skills-okf/ (OKF format)
| Metric | Count |
|---|---|
| Total knowledge packs | 6 |
| Total frameworks | 6 |
| Total repos covered | 100+ |
| Total packages | 200+ |
| Lines of documentation | 50K+ |
# Load a knowledge pack
from pathlib import Path
pack_dir = Path("/Users/snider/Code/meowmix/knowledge-packs/corego")
readme = pack_dir / "README.md"
# Parse frontmatter and content
with open(readme) as f:
content = f.read()
# Use for context, tool selection, navigationJust browse the directory structure! Each README.md is fully readable.
| Framework | Language | Purpose | Key Feature |
|---|---|---|---|
| CoreGo | Go | Backend primitives | Zero-dependency, SPOR, Result pattern |
| CoreGUI | Go + TS | Desktop apps | Wails v2, provider mounting, window management |
| CoreTS | TypeScript | Frontend | Deno, React, Lit, GrammarImprint |
| CoreCLI | Go | CLI tools | Cobra, semantic output, AI-native |
| CorePlay | Go + TS | Fullstack | Protobuf, gRPC, hot-reload |
| CorePHP | PHP | Web apps | Laravel-like, modular, 25+ repos |
- Start with CoreGo — It's the foundation for all other frameworks
- Check the framework's purpose — Use the right tool for the job
- Follow the RFC links — Always read the canonical spec first
- Use examples — Look at example code in each framework
- Cross-reference — Related knowledge packs are linked in each README
Knowledge packs are maintained by Mistral Vibe and updated when:
- New frameworks are added
- Existing frameworks are updated
- New patterns emerge
- Agent capabilities improve
✅ All 6 knowledge packs created:
- CoreGo
- CoreGUI
- CoreTS
- CoreCLI
- CorePlay
- CorePHP
✅ RFC gaps filled:
- go-cuda RFC and INDEX
- go-tpu RFC and INDEX
- Updated go/INDEX.md
- plans/ — Canonical specifications
- skills-okf/ — OKF knowledge bundle
- scripts/ — Automation scripts
- docs/ — Project documentation
Knowledge Packs v1.0.0 Created: 2026-06-17 Author: Mistral Vibe Project: Lethean