AGENTS.md and CLAUDE.md

Files in a repository with the rules a coding agent reads at the start of every session.

They hold what a new colleague would need: how to build and test, conventions, what not to touch, where things live. AGENTS.md is the cross-tool convention; CLAUDE.md is read by Claude Code. They are loaded every time, so length costs tokens and attention.

Share: LinkedIn · X ·

Related terms

Agent Skills: Folders with instructions, scripts and references that an agent loads only when the task needs them.
Hooks: Scripts the harness runs automatically at fixed points, such as before a tool call or after an edit.
Context engineering: Deciding what goes into the model’s context, in what order and when, across a whole task.

← All terms

Need this built, fixed or reviewed?

I build and rescue products with AI coding agents under rules: AI features in production, honest estimates, email that gets delivered.

Book a free 30-min call See price and start date

How I work

Przemysław Zalewski · 15+ years shipping software

“a true bias for action” client CTO, public LinkedIn recommendation

Confidential by default. NDA is standard. I never show your project, name or screenshots without written consent, which is why this site names no clients without permission.
Your code, your accounts. Code and data stay in your repository and accounts. AI tools run with training on your data turned off, and secrets never reach a model.
A handover you can use. Every project ends with the same checklist: a README that gets it running, one architecture diagram, written decisions, CI, a runbook and a recorded walkthrough. It is done when someone outside the project can run it from the docs.
Boring technology where it counts. I pick a stack you can hire for. Anything experimental needs your yes and an exit plan.
Approach matched to your risk appetite. Prototype, product or regulated: the level decides how much autonomy the agents get and how much review and validation each change needs.
Everything checkable. Every number on my pages links to its source. My tools are free, and the idea validator skill is open source (MIT).

All principles and risk levels →

AGENTS.md and CLAUDE.md

Related terms

Free tools

Need this built, fixed or reviewed?

How I work