auto-brain

To generate context summaries for source files, this tool writes or refreshes an adjacent `<file>.brain` summary containing YAML frontmatter and five Markdown sections whenever a source file is edited. It captures the file's purpose, exports, collaborators, gotchas, and conventions.

A brain file is a per-source Markdown summary with YAML frontmatter that restores session context by allowing readers to grasp a file's purpose without opening the source. It keeps session context small during SDCD workflows.

You can keep context window size small by generating per-file brain summaries instead of loading entire source files. This tool creates concise summaries of purpose, exports, and conventions, reducing context-switching for future readers.

No external dependencies are required to generate brain files. The tool operates directly within the SDCD project environment, writing YAML frontmatter with source, source_hash, model, and generated_at fields alongside the edited source file.

You should refresh per-file brain summaries whenever Claude edits or creates a source file in an SDCD project and the corresponding brain file is missing or outdated. This ensures future readers always have accurate context.

Automatic brain summaries use a format consisting of YAML frontmatter with source, source_hash, model, and generated_at fields, followed by a fixed five-section Markdown body documenting the source file's key information.