{
  "id": 13029392,
  "title": "Mistake 1: Skipping the Docs (Spoiler: They’re Goated)",
  "url": "https://urgent.news/2026/10/09/mistake-1-skipping-the-docs-spoiler-theyre-goated",
  "topic": "tech",
  "section": "Tech",
  "published": "2026-10-09T04:38:05.000Z",
  "source": {
    "name": "Dev.to",
    "slug": "dev-to",
    "url": "https://dev.to/belerickii/mistake-1-skipping-the-docs-spoiler-theyre-goated-2jbn"
  },
  "original_language": "en",
  "account": "In the world of software development, particularly in the age of AI, it is easy to overlook the importance of foundational knowledge. This was a lesson learned by a rookie developer who, after setting up their development environment and database design, decided to jump straight into building their project. However, this decision led to a series of issues that could have been easily avoided with a better understanding of the tools they were working with.\n\nThe developer initialized Prisma 8 in their DMS project, assuming that it would correctly generate the necessary folder structure. However, Prisma 8 initially generated the Prisma directory inside the src/ folder, which went against their intended setup. Instead of recognizing this discrepancy, the developer moved the Prisma directory to the project root, believing everything was fine and continuing to write their database models in contract.prisma.\n\nThis seemingly innocuous action had far-reaching consequences. Two major issues arose from this incorrect folder structure. Firstly, the NestJS compilation error occurred because a TypeScript file was placed outside the directory covered by the TypeScript compilation configuration. Secondly, Prisma was unable to locate the schema in the expected location, causing subsequent Prisma commands to fail.\n\nThese problems stemmed from the developer's failure to fully comprehend how Prisma's configuration and NestJS's compilation setup interacted. By changing the folder structure without a proper understanding of the underlying mechanisms, they inadvertently created these issues. The AI tool, ChatGPT, did suggest folder structures and database models, but without the necessary context about the project setup, its suggestions were misleading and unsuitable.\n\nThe developer recognized that AI is only as good as the person using it. They understood that blindly accepting AI's suggestions could lead to problems, especially when working with new versions of tools like Prisma. Reading through the Prisma 8 documentation proved invaluable in resolving these issues and tackling subsequent problems, including cases where AI suggested Prisma ORM queries based on outdated versions.\n\nWhile documentation may not always be the most exciting read, it can often be the most essential. In this case, the developer's experience serves as a reminder that building a solid foundation in the tools and technologies one works with is crucial. It highlights the importance of not solely relying on AI suggestions but rather understanding the underlying principles and seeking guidance from reliable sources like documentation. This lesson learned will undoubtedly help the developer navigate future projects with greater confidence and avoid similar pitfalls.",
  "summary": "As a rookie starting in software development, especially in the age of AI, I could easily skip the learning phase and jump straight into building. But my experience during my undergraduate years taught me something: shaky foundations and an inadequate understanding of the tools you're working with will eventually come back to bite you — sometimes in ways you least expect. After setting up my…",
  "key_points": [
    "Rookie developer skipped Prisma documentation, leading to folder structure issues",
    "Incorrect Prisma folder placement caused NestJS compilation error and Prisma schema location failure",
    "Reading Prisma 8 documentation helped resolve issues and improve future project navigation"
  ],
  "editors_take": "Relying solely on AI suggestions without understanding underlying tools and technologies can lead to problems, making foundational knowledge and documentation crucial for successful software development.",
  "illustration": null,
  "coverage": {
    "outlets": 1,
    "also_reported_by": []
  },
  "ai_generated": true,
  "disclaimer": "Summaries, key points and the editor’s take are written by software from other outlets’ reporting and may contain errors — always check the linked original."
}