Skip to content

Instantly share code, notes, and snippets.

@audiodude
Created June 20, 2026 16:28
Show Gist options
  • Select an option

  • Save audiodude/55e75d69a701762422f1ec1baa1ba676 to your computer and use it in GitHub Desktop.

Select an option

Save audiodude/55e75d69a701762422f1ec1baa1ba676 to your computer and use it in GitHub Desktop.
CLAUDE.md instructions on documentation

When adding significant features, always remember to update relevant documentation.

  • If you've added a feature, make sure it's mentioned in the README. The amount of space it takes up should be relevant to the
    significance of the feature and the length and composition of the existing README
  • If you've finished a TODO or implementation task, update that document. Alternately keep a log/record next to it of what's been done, the tradeoffs made, and what's left to do
  • ALWAYS document changes to how the application or utility is run, including CLI options (though not every minor option needs to be documented).
  • ALWAYS document changes to how the application is deployed, in the sense of the specific steps or scripts that deploy it.
  • Details on whether to include specific deployment environments and architecture in the README should be left to the user. They
    can be added freely if they already exist there.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment