malteristo/magic

A practice framework for thinking with AI

Python23 ★Personal AI & KnowledgeGitHub ↗
Quality: decent 13/24
PAI: watch 0.38
Appraised: 2026-05-27 current
Contents

Overview

Verdict

Rating Summary
Quality decent (13/24) Actively maintained with a thoughtful README, but no dependency manifest, no tests, and low adoption signal keep the engineering score at floor.
PAI Relevance WATCH (0.38) The ritual initialization pattern and workshop-as-memory framing offer study value, but Python language and no callable CLI make direct integration impractical.

Quality Assessment

13/24 — maintained / adequately-documented / no-signals

Health: 6/8 (maintained)

Failed:

Passed:

Documentation: 5/8 (adequately-documented)

Failed:

Passed:

Engineering Signals: 2/8 (no-signals)

Failed:

Passed:

PAI Relevance

Dimension Score Assessment
Harvest Value 1 The "summoning ritual" pattern — structured system prompts that initialize an agent into a defined cognitive stance — and the workshop-as-memory design offer study value for PAI's skill context architecture, but do not introduce a fundamentally novel pattern PAI hasn't approached through its existing skill/hook system.
Integration Readiness 0 Python-tagged with no dependency manifest or described CLI; the framework is primarily content and conventions rather than callable code, requiring significant adaptation to extract patterns into PAI's TypeScript/Bun skill system.
Overlap Risk 1 Partial overlap with PAI's existing file-based memory system (WORK/, LEARNING/, KNOWLEDGE/) and the Telos/Interview skills that handle goal-tracking and conversational context fill — but the explicit practice-ritual and stance-initialization layer is not directly replicated.
Gap Fill 1 PAI has no dedicated structured practice-session framework with a defined AI stance and explicit capture/process/orient cycle; Telos and Interview cover adjacent territory but not the same ritual cadence and session-arc pattern.

Composite: 0.38

What Next

Landscape Position

Category: Personal AI & Knowledge

In this category: tinyhumansai--openhuman (excellent, 21/24); malteristo--magic is the first practice-framework entry in this subcategory.

Standing: Magic occupies a distinct practice-oriented niche within personal AI — lower quality signal than openhuman but conceptually differentiated by its ritual structure, explicit AI stance design, and portability-first philosophy.

Evidence Base

Density: 9/10 — README (full, 8KB), repository metadata (stars, forks, dates, language, license, release), topic tags, and landscape context all available; dependency manifest absent and source code not directly inspected.

Notes

Magic is the framework layer above malteristo--turtleos (its companion self-hosted infrastructure repo, also in the vault). The two repos form a deliberate pair: Magic defines the cognitive patterns and rituals; turtleOS makes them persistent and local-first. Any future evaluation of either should consider both together. The rolling summary previously assigned poor (2.6/24) — that figure appears to have been a preliminary pass; probe-based scoring produces decent (13/24).