How to adapt when AI codes better than you?

Arseny ShatokhinAbout 2 min readJun 8, 2025Watch original
THE SUMMARYAI-generated

Key Concepts:

  • Distribution vs. Product: The balance between creating a product and getting it to market.
  • AI-Assisted Development: Using AI tools to streamline product creation and documentation.
  • Code Organization for AI: Structuring code to be easily understood and manipulated by AI agents.
  • Documentation Synchronization: Keeping documentation up-to-date and aligned with the codebase.

The Evolving Role of the Developer

The primary shift in the developer's role centers around the increasing importance of distribution. Traditionally, developers focused heavily on product creation. However, with AI making product development more accessible, the emphasis is shifting towards mastering distribution and marketing. The speaker suggests that time saved through AI-assisted development should be invested in learning how to market oneself and one's products, especially for those aiming to build a business. The core idea is that "there's only two problems you know distribution and product" and AI is heavily impacting the "product" side.

AI and Documentation: A Case Study

The speaker provides a concrete example of using AI (specifically Cursor and Cloud Code) to generate 6,000 lines of documentation for a library. This illustrates how AI can significantly reduce the burden of documentation, allowing developers to focus on other critical tasks.

Code Organization for AI Agents

The speaker highlights the need to adapt coding practices to facilitate AI interaction. This involves considering how AI agents can best understand and work with the codebase. Key questions include:

  • File Structure: Should code be organized into multiple files or consolidated into single files to optimize AI comprehension?
  • Documentation Practices: How can documentation be structured to guide AI agents effectively?

Documentation Best Practices

The speaker has modified their documentation approach to explicitly link documentation to specific code files. This ensures that AI agents can easily locate the relevant code when referencing documentation. The speaker now ensures that "documents now always mention the code file so they know where to look".

Conclusion

The future of the developer role involves a greater focus on distribution and marketing, leveraging AI to streamline product creation and documentation. Adapting coding practices to facilitate AI interaction, particularly in terms of code organization and documentation, is crucial. The key takeaway is that developers need to evolve beyond pure product creation and embrace the challenges and opportunities presented by AI-driven development.

AI summaries can miss context or contain errors. Check important details against the original video.

Go a little deeper.

Have a question about this video? Load its transcript to open the video chat.