Agent Instructions

CLAUDE.md

Best practices

• whenever you're performing a test using real data, use a small amount of data at first, especially when databases are involved
• always commit your tests in an appropriate 'tests' directory (you can check if one already exists, if not you can create it)
• in Python code, prefer logging.info() to print() so we can see timestamps
• if two instructions seem potentially contradictory, point it out and ask for clarification before proceeding
• before beginning work, ask me if we should work in a separate git worktree. depending on the scope of the task, we may or may not need to
• if something i suggest or ask contradicts best practice or common sense, please flag it before proceeding. e.g. I may ask you to use batch size of 100 for database inserts but you know that 1,500 is more common
• keep track of all external resources (i.e. databases, tables in databases) in a file in the project directory called RESOURCES.md which you can reference when you need to e.g. look something up or run a query. if this file doesn't already exist, create it