The Manager’s README: A Practice in Radical Honesty and Leadership Evolution

The Document as Mirror

The Manager’s README, sometimes called a personal user manual or leadership charter, has gained popularity as a transparency tool. But its true power lies not in the words themselves but in the accountability framework they create. When you articulate who you are as a leader, your preferences, and your values, you’re informing your team… and you’re lso creating a reference point against which your actions will inevitably be measured.

This isn’t documentation for documentation’s sake; it’s the creation of a mirror you cannot hide from.

Consider what happens when you write, “I welcome new ideas and constructive challenges to my thinking.” This statement, seemingly positive and progressive, carries significant risk. You’ve now established a standard by which your team will evaluate your reactions. Each time you interrupt a challenging perspective or dismiss an unexpected proposal, you create a dissonance between your stated values and your observable actions.

This dissonance of the README process is precisely its purpose.

The Data of Dissonance

Most leadership discourse frames feedback as something managers give rather than receive. The Manager’s README inverts this dynamic, creating a structured invitation for your team to reflect your behaviors back to you.

When a team member musters the courage to say, “You wrote that you value creativity, but I’ve noticed you tend to focus on potential problems whenever new ideas are shared,” they’re providing invaluable data about the gap between your self-perception and your impact.

This moment represents a critical juncture. Will you defend your intentions (“That’s not what I meant” or “You’re misinterpreting my questions”) or will you engage with the reality of your impact? Your response in this moment speaks volumes about your capacity for growth—far more than any carefully crafted value statement.

The discomfort of this feedback is a feature (not a bug). The Manager’s README creates a structured space for precisely this type of productive tension.

Visible Evolution as Trust Currency

Trust is built on demonstrations. When your team observes a disconnect between your README and your actions, they don’t immediately lose faith, but they’ll be watching what happens next.

Do you acknowledge the gap? Do you make visible adjustments? Do you follow up to check whether your changes are addressing the concern?

Trust is built on visible evolution. When your team witnesses you actively working to align your actions with your stated intentions, they experience something rare in organizational life: a leader whose growth happens in plain sight rather than behind closed doors.

Consider the manager who, upon receiving feedback about interrupting team members, acknowledges the behavior and also institutes a new practice in meetings: “I’ve been told I sometimes cut people off. If you notice me doing this, please say ‘I’d like to finish my thought.’ This will help me be more aware.” This visible commitment to change, and the vulnerability of making it public, creates far more trust than any aspirational statement about valuing all voices.

The Authenticity of Imperfection

Perfection is not a leadership goal. A leader who never makes mistakes, never has off days, and never shows frustration comes across as performative rather than real.

The Manager’s README shouldn’t aim to portray an idealized version of yourself, but rather to create a framework for understanding your real patterns—including your limitations. The document might include acknowledgments like “I tend to become more directive under tight deadlines” or “I sometimes need processing time before responding to unexpected proposals.”

These statements are context that helps your team interpret your actions more accurately while also holding you accountable to manage your tendencies.

The paradox is that acknowledging your imperfections makes your strengths more credible. When you admit to struggling with certain aspects of leadership, your team is more likely to trust your competence in other areas. Selective vulnerability creates space for authentic strength.

Intrapersonal Competency: The Meta-Skill

Leadership development typically focuses on interpersonal skills: communication, influence, delegation. The Manager’s README process highlights a more fundamental capability: intrapersonal competency. Your ability to evolve yourself intentionally.

This meta-skill encompasses:

  • Self-awareness: Recognizing your patterns, triggers, and impact
  • Feedback receptivity: Taking in potentially uncomfortable information without defensiveness
  • Intentional adaptation: Making targeted changes to align actions with intentions
  • Progress monitoring: Checking whether changes are having the desired effect

The Manager’s README documents who you are and it also creates conditions to develop who you’re becoming. The gap between your written intentions and your lived behaviors is the productive tension that drives growth.

The Practice, Not the Product

The value of the Manager’s README is in how it evolves. A document created once and left untouched becomes a monument to aspirations never realized. The README should itself evolve as you do—updated not just with new preferences but with new awareness gained through feedback.

Some managers track how their README evolves, noting shifts based on feedback. It shows a commitment to growth.

The Invitation

The Manager’s README represents an invitation to a different kind of leadership, one defined not by certainty but by curiosity. It challenges the notion that leaders should have it all figured out, offering instead a model where figuring it out happens collaboratively and continually.

This practice won’t eliminate the gap between who you aspire to be and how you actually show up, but it will make that gap visible, discussable, and addressable. And perhaps this is the most powerful leadership stance of all: not “I know the way” but “I’m on the way, and I welcome your help in getting there.”

Your README says who you think you are. Their annotations say who you really are. Which version is more accurate?

==

A genius is the one most like himself: Thelonious Monk’s tips for musicians

I’m a jazz fan, always have been. And I’m a Monk fan.

Monk created this list when a musician joined his band for a multiple-week gig.

I encourage the managers I work with to have a readme document for themselves and to have a structured, personal way of welcoming new members to their team. It also goes a long way for that welcoming to include peers.

In any case, here’s Monk’s list. What does yours look like?

 

  • Just because you’re not a drummer, doesn’t mean you don’t have to keep time.
  • Pat your foot & sing the melody in your head, when you play.
  • Stop playing all that bullshit, those weird notes, play the melody!
  • Make the drummer sound good.
  • Discrimination is important.
  • You’ve got to dig it to dig it, you dig?
  • All reet!
  • Always know… (monk [backwards])
  • It must be always night, otherwise they wouldn’t need the lights.
  • Let’s lift the band stand!!
  • I want to avoid the hecklers.
  • Don’t play the piano part, I’m playing that. Don’t listen to me. I’m supposed to be accompanying you!
  • The inside of the tune (the bridge) is the part that makes the outside sound good.
  • Don’t play everything (or every time); let some things go by. Some music just imagined.
  • What you don’t play can be more important than what you do.
  • Always leave them wanting more.
  • A note can be small as a pin or as big as the world, it depends on your imagination.
  • Stay in shape! Sometimes a musician waits for a gig, & when it comes, he’s out of shape & can’t make it.
  • When you’re swinging, swing some more!
  • (What should we wear tonight?) Sharp as possible!
  • Don’t sound anybody for a gig, just be on the scene.
  • These pieces were written so as to have something to play, & to get cats interested enough to come to rehearsal.
  • You’ve got it! If you don’t want to play, tell a joke or dance, but in any case, you got it! (to a drummer who didn’t want to solo).
  • Whatever you think can’t be done, somebody will come along & do it. A genius is the one most like himself.
  • They tried to get me to hate white people, but someone would always come along & spoil it.

Source: Open culture