← Back to library

File assistant explanations into a git notes repo

mindcrime on Hacker News asks his assistant odd questions as they occur, then has it write the explanation as a file in a suitable git repository. Through the GitHub MCP server it reaches three or four repos, each holding an AGENTS.md that steers where notes go.

  • OutcomeTurn useful chat explanations into durable notes by having the assistant write a summary file into the right git repository, guided by an AGENTS.md in each repo.
  • SetupUnder an hour
  • LevelIntermediate
  • Creditmindcrime on Hacker News
View original
Works with
ChatGPTClaude

Published Oct 23, 2026Updated Oct 23, 2026AI dry run on sample input: passed Oct 23, 2026Source verified Oct 24, 2026

When should you use it?

  • You learn a lot in chats and lose it
  • You keep notes in GitHub repos
  • Assistant memory feels unreliable

Not for: Private material you would not store in a hosted repo; People without a GitHub workflow

What do you need, and what do you get?

You need

  • GitHub connector with access to chosen repos
  • An AGENTS.md per repo

You get

  • Summary files per topic
  • A growing catalog of decisions and ideas

How does it work, step by step?

  1. Pick the reposLimit access to a few repos meant for notes.
  2. Write AGENTS.mdExplain in each repo where summaries go, naming rules and which index files to update.
  3. Add a standing instructionTell the assistant to read the right AGENTS.md at the start of a session.
  4. Ask for a write-upAfter a useful exchange, ask it to summarize and commit the file to the right repo.
  5. Reference past notesList key files in AGENTS.md so later sessions build on them.

The prompt

Our own prompt, inspired by mindcrime on Hacker News and written to work in ChatGPT and Claude. Values in lime are placeholders.

Fill in the blanks (optional; the copied prompt uses your values)

Prompt2 variables
Summarize what we just discussed about {topic} as a markdown note.
Read AGENTS.md in {repo} first and follow its rules for location and naming. Include: key points, sources mentioned, open questions. Commit the file and add a line to the index. Show me the diff before committing.

Inspired by mindcrime on Hacker News: Hacker News comment on keeping AI conversations in git repos. The prompt above is written by playbooks.bot in our own words; nothing from the original is quoted.

What can go wrong?

  • Give access only to notes repos, not code you ship.
  • Summaries can drift from what was said; skim before committing.

Our take

Built-in chat memory is opaque; a git repository is not. This setup gives you notes you own, with history, that any assistant can read when pointed at them. The AGENTS.md convention does the steering. Limit the assistant to a few repositories meant for notes, never code you ship. In each one, an AGENTS.md explains where summaries go, how files are named and which index files to update, and a standing instruction tells the assistant to read it at the start of a session. After a useful exchange, ask for a write-up and skim it before it is committed, since summaries can drift from what was actually said. Listing key files in AGENTS.md lets later sessions build on earlier notes instead of repeating them. Private material you would not store in a hosted repository should stay out. Because everything lives in git, you get history, diffs and the option to move the notes to another assistant later, which built-in chat memory does not offer.

Where the time goes back: Explanations you would otherwise lose become searchable files that future sessions can read.

FAQ

Why not rely on built-in memory?
The author finds explicit files far more reliable than the assistant's memory.
Was setup hard?
It took some work, he says, but paid off in reliability.

Source and credit

Inspired by mindcrime on Hacker News. We describe the idea in our own words, link to the original, and wrote the prompt ourselves; nothing is quoted.

Inspired by
Hacker News comment on keeping AI conversations in git repos
Creator
mindcrime on Hacker News
Published on
Hacker News
Original date
Oct 17, 2026
License
Not openly licensed (the poster keeps all rights), so we quote nothing and link to the original
Originally for
ChatGPT
AI dry run
Oct 23, 2026: passed. Dry-run tested by our AI test agent on sample input. PASS: Gates held on desk check; no live sends or purchases.
AI dry run on sample data; not run with live connected accounts. The playbooks.bot test agent filled the prompt with synthetic inputs, produced the output and checked it against the page's stated outputs and guardrails.
Verified
Oct 24, 2026: source link resolves to the original, the credited creator published it, our excerpt or prompt matches it, and the license allows our use.

Are you the creator? Claim or correct this page.

More in Career & Learning

All 37 Career & Learning playbooks →

Related playbooks

Career & LearningWorkflow✓ AI dry run

Check an AI-edited paper for dropped or invented citations

After any AI rewrite of academic text, compare citations before and after, confirm each source exists and check that claims still match their sources.

Credit: u/ringringpssy on r/ChatGPT

Under an hour
Career & LearningPrompt✓ AI dry run

Compare your project plan with its fastest possible timeline

Have an AI interview you task by task about a project you keep postponing, estimate how long each task would take with no waiting at all, set that beside your real schedule, name the three largest gaps and whether each comes from waiting, approvals, hesitation or genuine effort, and give you a one-page plan to close the largest gap this week.

Credit: AI Guides (@free_ai_guides)

Minutes
Career & LearningSkill✓ AI dry run

Learn any topic with a strict Socratic tutor skill

Load Jane Street's open-source tutoring skill into Claude, ChatGPT or a coding agent so that when you ask to be taught something, it first tests what you already know, keeps a 0 to 5 level for each part of the topic, quizzes you one question at a time without handing over answers, re-tests older material by surprise, and only ends the course after a final mixed exam.

Credit: janestreet

Minutes
Career & LearningWorkflow✓ AI dry run

Turn a textbook chapter into an interactive lesson

Have an agent read study material, choose a lesson structure and assemble it from interactive components, with a reviewer agent checking it against the source.

Credit: Hassan (@nutlope)

An afternoon+
Career & LearningWorkflow✓ AI dry run

Write a literature review that can only cite your sources

Use a source-grounded notebook tool so every citation in your review points to a paper you uploaded, in author-year format.

Credit: u/Federal_Weekend_4278 on r/WritingWithAI

Under an hour