Prepare the Runway

Failure pattern

Agent mulai mengubah code sebelum tahu kondisi repo. Dependencies belum benar, seed database stale, baseline test sudah gagal, dan typecheck broken karena file generated. Agent lalu memperbaiki hal yang salah.

Runway adalah kondisi minimum sebelum implementation work.

Incident: Feature work di baseline yang rusak

Agent diminta memperbaiki SSO invite enforcement. Ia langsung edit route. Setelah itu typecheck gagal. Karena tidak ada baseline record, agent mengira patch-nya penyebab failure, lalu mengubah generated client dan schema yang sebenarnya unrelated.

Patch menjadi kacau.

Harness principle

Prepare the runway memaksa agent membuktikan start state: install, env, database, focused failing test, known broken state, dan allowed commands.

Tanpa runway, environment friction mudah berubah menjadi code churn.

Operating practice

Runway record:

Check	Expected	Result
install	lockfile tidak berubah	pass
typecheck	baseline diketahui	fails pre-existing
focused test	target failure reproduced	pass
seed data	invite fixture ada	pass
feature flag	SSO on	pass

Known broken state harus ditulis sebelum implementation.

Coding-agent example

Harnessed agent menulis:

Baseline typecheck fails in generated client before patch.
Target invite test reproduces redirect bug.
Proceeding with route and e2e test only.

Reviewer bisa membedakan failure lama dan failure baru.

Common mistakes

Kesalahan pertama adalah menganggap preflight membuang waktu. Preflight mencegah agent menyelesaikan masalah yang tidak diminta.

Kesalahan kedua adalah tidak mereproduksi target failure sebelum patch. Jika failure tidak terlihat sebelum patch, passing test setelah patch tidak banyak berarti.

Practical exercise

Buat runway checklist untuk repo Anda: install, env, database, focused test, baseline verification, known broken state.

Key takeaways

• Setup bukan implementation.
• Known broken state harus dicatat.
• Target failure perlu terlihat sebelum patch.