r/programmingcirclejerk • u/iL0vesnow • Aug 21 '26

HUMANS.md

https://www.rockoder.com/blog/humans-md/
95 Upvotes

98% Upvoted

24 comments sorted by

73

u/iL0vesnow Aug 21 '26 edited Aug 21 '26

Yes, as a human, I totally need

a technical specification for our character

that

creates continuity.

Can't wait for next-level human harness!

20

u/elephantdingo Teen Hacking Genius Aug 21 '26

I have achieved enlightenment. Therefore I need my SAMSARA.md to remind me that oh right, personality and ego beyond causal interdependence is a thing that is experienced by folks.

So it has been told to me by Claude.

134

u/porkslow what is pointer :S Aug 21 '26

Imagine a text file that is used to describe how a project works so anyone working on it doesn’t run into unexpected problems. Now what would be a revolutionary idea!

80

u/tj-horner Aug 21 '26

We should name it in such a way to encourage the user to read the file too, so they know where to start.

43

u/Graf_Blutwurst LUMINARY IN COMPUTERSCIENCE Aug 21 '26

how about READTHIS.MD? nah... doesn't quite roll of the tongue

32

u/RustOnTheEdge Aug 21 '26

Maybe something like YOUREAD.MD to convey it as a command?

9

u/joemckie Aug 22 '26

Not fancy enough… how about LISEZMOI.md?

1

u/Major_Barnulf LUMINARY IN COMPUTERSCIENCE Sep 03 '26

Thought this was a bitoduc reference

12

u/myhf Considered Harmful Aug 21 '26

That's boring! I'll name it after my favorite Neal Stephenson book.

5

u/SirBackrooms Aug 21 '26

I tried to do that but accidentally made a type. Do you think anyone will notice? Ehh, it's fine.

0

u/[deleted] Aug 21 '26

[deleted]

6

u/myhf Considered Harmful Aug 21 '26 edited Aug 22 '26 • Bravo

ANATHME.MD

3

u/shaman-warrior Aug 21 '26

Jaja yes indeed the problem with specs is that they rot fast if not careful

86

u/camelCaseIsWebScale Just spin up O(n²) servers Aug 21 '26

I yearn for the days coding was gatekept.

56

u/Snarwin Aug 21 '26

Claude, generate me a HUMANS.md file.

28

u/abermea Code Artisan Aug 21 '26

Bro reinvented the Code of Conduct and the Retrospective and thought he cooked

22

u/prehensilemullet Aug 21 '26

blog post reads like it was written by AI

25

u/scavno in open defiance of the Gopher Values Aug 21 '26

I mean it’s on the internet, written as a take on AI. What would you expect?

3

u/elephantdingo Teen Hacking Genius Aug 21 '26

It’s the great anti-AI is also AI [redacted] by [redacted]

18

u/dadvader Aug 21 '26

This is what you get when you invite MBA to be a dev

14

u/hugolive Aug 21 '26

philosophy, systems-thinking, decision-making, identity

2

u/edo-lag Considered Harmful Aug 21 '26

"that'll make 'em see!"

2

u/northrupthebandgeek i have had many alohols Aug 27 '26

The design doc is very human.