Prepare a project for Claude Code and Codex: from setup to the first change
From an empty folder to a verified first change: AGENTS.md and CLAUDE.md instructions, tests, permissions and a handoff for coding agents.
Blog / Matteo Vincenti
Notes from work.
I write about AI in everyday work, software development and how teams work together. I start with business problems and explore the technical decisions.
7 articles in AI agents
Topic: AI agents Clear topic
Debugging with an AI agent: challenge the diagnosis before fixing the code
Reproduce a JavaScript date bug in Docker, distinguish two diagnoses and preserve regression tests before asking an AI agent to patch the code.
Prompt injection: what can leave an agent’s environment
Follow a hostile proposal through a data transfer. A Docker lab separates file access, network reachability, recipients and legitimate work.
Harness engineering: which controls an agent actually needs
A Docker lab shows how an agent harness controls permissions, retries, budgets and evidence, and when to choose an existing runtime.
Code review with AI agents: when a pull request is ready
A small pull request can pass its tests and still be wrong. A Docker example shows how to expose the defect, fix it and explain the acceptance decision.
Meta repositories and AI agents: a project map or pinned revisions?
Decide when a project map is enough and when to pin revisions. A complete submodule setup with manifests, agent instructions and a runnable Git example.
AI agents in a team: evaluate quality, costs and responsibility
Evaluate AI agents at work: quality, complete-task cost, ownership and criteria for adopting, limiting or stopping a pilot.
Contact