ferdinandobons

Bonsai — Development skill for Claude Code

Development community

A patient gardener for your code — proactive observations for Claude Code.

How to install Bonsai

This entry records only its repository, not the path inside it, so there is no exact command to give. Open ferdinandobons/bonsai and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Bonsai does

A patient gardener for your code — proactive observations for Claude Code.

Alternatives in Development

  • 18 Proactive Mode — Proactive / Autonomous Mode 2.3k ★
  • Proactive / Autonomous 모드 — 관찰 위치: Claude Code 내부 아키텍처 PROACTIVE 또는 KAIROS 플래그 뒤에 있는 기능입니다 149 ★
  • Box0 — Open-Source Platform for Subagents and Agent Teams 81 ★

README

Bonsai

![Bonsai: from the active approach to the proactive approach](assets/hero.svg)

**Claude answers what you ask. Bonsai catches what you miss.**

Bonsai is a Claude Code plugin that acts as a patient gardener for your code. After each turn of your session it silently observes what just happened and, only when it finds something that truly matters, leaves you a single observation: a latent bug you missed, a risky architectural decision you made without noticing, a workflow friction quietly costing you an hour a day.

It never touches your code. It runs in the background, independent of your session, and stays quiet most of the time. It speaks only when the signal is high. **Silence beats noise** is its hard rule, and the reason it's worth leaving on.

The proof

The first time the gardener ran on a real session (the transcript of building Bonsai itself), it caught two real bugs in its own codebase that sixteen rounds of code review during the build had missed:

  1. bonsai_branches_write was the only non-atomic file write in a codebase that uses atomic patterns everywhere else. The gardener writes its own observations through that function. It surfaced the bug while writing its own report about it.
  2. The CI workflow never triggered on release tags. That is exactly why two earlier releases shipped with a Linux compatibility regression.

Both fixed in v0.1.4. Both marked "kept" in the project's observation index. The loop closed in a single afternoon.

This is what proactive looks like.

Why you want it

Claude is reactive by design. You ask, Claude answers, then Claude waits. The cost of that wait is invisible until you ship: the race condition you would have caught on Monday morning ships on Friday night. The architecture decision you made in a 3am haze becomes a six-month refactor. The small repetition in your workflow becomes a daily tax.

Bonsai closes the gap between the moment something matters and the moment you notice. You stop relying on rememb