AI-assisted development: a workflow that keeps quality up

By Ruben Bijker · Published · 5 min read

AI coding tools are most useful for well-defined, routine work: boilerplate, refactors, tests, documentation and exploring unfamiliar code. They are least reliable for architecture, security and anything that depends on context they cannot see.

Where AI helps

  • Scaffolding. Components, routes, forms, migrations and typed API clients.
  • Refactoring. Renaming, extracting functions and migrating between library versions.
  • Tests. Generating cases and edge cases for logic you have already specified.
  • Explaining code. Summarising an unfamiliar module or tracing a bug through layers.
  • Documentation. Drafting READMEs, comments and changelogs from code.

Where it needs supervision

  • Architecture and boundaries. Left alone, it adds code rather than finding the simpler design.
  • Security. Authentication, authorisation, input handling and secrets need deliberate review.
  • Dependencies. It may suggest outdated APIs or packages that do not exist. Verify against current documentation.
  • Performance. Output often works but renders or queries more than necessary.

A workflow that works

  1. Give context. Share conventions, the relevant files and the goal. Project rules files help keep style consistent.
  2. Work in small steps. One change at a time is easier to review and revert.
  3. Define the contract first. Types, schemas and tests tell the tool what correct looks like.
  4. Read every diff. If you cannot explain a change, do not merge it.
  5. Run the checks. Type check, lint, tests and a manual pass on the critical path.
  6. Keep humans on decisions. Use AI to explore options, then choose deliberately.

Habits that keep a codebase healthy

Keep functions small and modules focused so generated code stays easy to review. Prefer boring, well-known patterns the tool has seen often. Delete generated code that is not needed; more code is more to maintain.

Related: TypeScript in web projects and choosing a stack.

Frequently asked questions

Can AI write production-ready code?
It can write a lot of it, but output must be reviewed, tested and fitted to the architecture. Treat it like a fast junior who needs clear instructions and careful review.
Does AI replace developers?
No. It speeds up typing and exploration. Decisions about architecture, security, trade-offs and product fit still need an experienced person.

Related service: Freelance web developer in Amsterdam

Have a project in mind?

Tell me briefly what you need. You get an answer from me, not from a sales team.

Get in touch