HUMAN.md

Every repo has an AGENTS.md. It tells your AI about your code: your stack, your conventions, this repo. Nothing tells it about you. That file is empty. stratless writes it.

HUMAN.md is the person layer. It lives at ~/.claude/HUMAN.md, and your assistant loads it at the start of every session, so it starts already knowing who it’s talking to instead of a blank.

What’s in it

Not a rules sheet you wrote. A brief on how you actually work, derived from your real history and nothing you declared, in four parts:

  • your shorthand, decoded (“In the moment”): the phrases you reach for, and what each one means you want right now, so your assistant recognises the move as you make it
  • what to offer you before you ask: the things you reliably want set up or handed over, so your assistant offers them unprompted instead of waiting to be told
  • what to catch for you: what you reliably challenge or refuse, so it pre-empts those instead of making you catch them yourself
  • how to talk to you: the register you work in, matched rather than smoothed over

Every line is an instruction to the AI with the real count behind it. No section is guaranteed: the file carries whatever your history actually supports.

Seeing it

stratless profile

profile prints the current model of you, free and instant. It is the same HUMAN.md your assistant loads; profile just shows it to you, and never spends. Building and loading it is update’s job. See Commands.

A sample

Every line is observed and carries the count behind it. It opens with your shorthand, then tells your assistant what to do:

## In the moment

- "yes plan" · "lets plan" → wants a plan before building
- "what was" · "what happened" → wants a quick plain answer

## What to offer me before I ask

- offer a quick sketch of the idea before building it out,
  then ask them to validate it. (218×)

## What to catch for me

- catch completed work presented as done and expect a
  double-check pass before it's accepted. (101×)

## How to talk to me

- talk in short go-ahead bursts, they approve with a brief
  word and expect you to keep moving. (159×, rising)

rising and fading are the trend: whether you are doing that thing more than you used to, or less. A full, unedited example lives on the home page.

It sharpens every time it runs.