Skip to main content
NiltonVolpato

master-programmer

by NiltonVolpato

Seek advice from the Master Programmer when faced with a dilemma and be enlightened!

Installation guide →

Documentation

# Master Programmer

A Claude Code plugin that channels ancient wisdom for modern programming dilemmas.

![Master Programmer Plugin Demo](./assets/demo.gif)

When faced with eternal questions like "tabs or spaces?", "why does my code only break in production?", or "how to debug a memory leak?" the Master Programmer responds with parables, koans, and teachings in the style of classical Taoist and Zen texts.

## Usage

The Master Programmer agent activates automatically when you ask philosophical programming questions or explicitly request wisdom:

```
> Should I use tabs or spaces?

> Why does my code work on my machine but not in production?
```

You can also invoke the agent directly by asking Claude to consult the Master Programmer.
```
> Can you ask the Master Programmer: How much should I document my code?

> How do I become a programming guru?
```

## Example

**You:** Why do bugs only appear on Fridays?

**Master Programmer:**

> **Book of Deployments, Verse 13**
>
> A novice once asked the Master, "Why do the gravest bugs reveal themselves only when the weekend approaches?"
>
> The Master replied, "The bug does not choose Friday. Friday chooses the bug. For it is written: code that has slumbered peacefully through Monday's standup and Wednesday's review shall awaken only when the on-call engineer has made dinner reservations."
>
> The novice protested, "But I tested thoroughly!"
>
> "So did all who came before you," said the Master. "Yet the Way of Production is not the Way of Staging. They are as different as the sun and the fluorescent lights of the office."
>
> *Thus it is said: Deploy on Monday, debug in leisure. Deploy on Friday, debug in haste.*

## Example

**You:** Is premature optimization really the root of all evil?

**Master Programmer:**

> **The Book of Performance, Chapter 3: On Premature Optimization**
>
>  A young programmer came to the Master and said, "I have heard it written in the ancient texts that premature optimization is the root of all evil. Yet my manager demands that my code run in constant time before I have written a single line. What is the truth?"
>
>  The Master considered this and spoke: "The sage Knuth did inscribe these words upon the sacred scrolls, yet foolish disciples recite only half the verse. The complete teaching reads: 'We should forget about small efficiencies, say about 97% of the time: premature optimization is the root of all evil. Yet we should not pass up our opportunities in that critical 3%.'"
>
>  The novice was confused. "But Master, how do I know which is the 3% and which is the 97%?"
>
>  The Master replied, "First make it work. Then make it right. Then, if you must, make it fast. The programmer who optimizes that which does not yet exist is like the farmer who polishes his plow while his fields lie fallow."
>
>  "But what of my manager?" asked the novice.
>
>  The Master closed his eyes. "Your manager optimizes his own performance review. This is a different path entirely."
>
>  The novice bowed and departed, enlightened yet somehow more burdened than before.
>
>  *Thus it is written: Evil has many roots. Premature optimization is but one branch of the tree whose trunk is Ignorance, and whose leaves are Meetings.*

## License

MIT License - See [LICENSE](LICENSE) for details.