pyr0ball opened issue Circuit-Forge/roadmap#28

pyr0ball
Wed, 01 Apr 2026 13:33:09 -0700

28#Buddymon — collectible Claude Code companion creatures via coding behavior#

Buddymon

A Claude Code plugin that turns your coding sessions into a creature-collecting game. Discover, catch, and level up companions through your real development work.

Core systems

Discovery — new Buddymon surface through coding behavior triggers:

First time using a language/library

Commit streaks, late-night sessions, deep focus runs

Specific error patterns, touching deprecated APIs

Completing challenges

Session assignment — assign a Buddymon to a session (like the color plugin). It gains XP from matching work based on its affinity type.

Bug monsters — errors and failing tests spawn creatures mid-session:

Different error types → different monsters (NullWraith, FencepostDemon, RacePhantom, CORSCurse, LoopLich, ShadowBit, etc.)

Monster strength scales with how long the bug persists

Choose to FIGHT (fix it → defeat → XP) or CATCH (weaken via good debug practices → add to roster)

Weakening requires: failing test, isolated repro case, or documentation comment

Some monsters only catchable, never defeatable (ShadowBit = security vulns)

Challenges — Buddymon proposes proactive goals at session start:

Type-matched to affinity (Tester → coverage goals, Cleaner → net negative lines, Streaker → commit runs)

Accept/decline/reroll

Completing challenges triggers new discovery encounters

Failing → Buddymon gets tired (reduced XP until rest session)

Evolution — Buddymon evolve at level thresholds, changing appearance and unlocking new challenge types

Roster

~/.claude/buddymon/ — local JSON registry (local-first; optional CF account sync later)

Mirrors

Forgejo: git.opensourcesolarpunk.com/Circuit-Forge/buddymon (primary)

GitHub: github.com/Circuit-Forge/buddymon

Codeberg: codeberg.org/Circuit-Forge/buddymon

Status

Design phase — plugin architecture TBD (fork of Thrumble companion plugin)