documentation skews from code
documentation skews from code

Backlinks

agent skill -- update-skills

documentation skews from code and part of skills is documentation, so we need to fix that skew. Perhaps this would also benefit from being turned into a practice - continuous background check.

see in context
practice - grill with docs for spec creation

In blog post - OpenAI harness engineering 2026-02, in the section about documentation there is a quote about when everything is important nothing is important. It also describes how documentation skews from code is inevitable in a large document because it's impossible to do things like cross-check links, look at metadata around how recently something was updated, etc. So they suggest breaking things apart into what I call a documentation context graph. I think that's probably superior to the CONTEXT.md file being advocated by Matt.

see in context
review - Open AI harness blog post - 2026-02-22

In that section is a quote about when everything is important nothing is important. It's also something about how documentation skews from code is inevitable in a large document because it's impossible to do things like cross check links look at metadata around how recently something was updated, etc.

see in context