In this lesson, we put the PRD to work and build out milestone one: the core CRUD, tagging, and search functionality of our bookmarking app. You'll see the full rhythm I use when building with Claude Code — starting with a clean context, dropping into plan mode, reviewing the implementation plan (and asking Claude to explain the parts you don't understand), then letting it cook in auto mode while it works through its own to-do list. Once the build is done, we walk through the running app together, testing real functionality, catching small UX issues, and using quick screenshot-based prompts to refine details like tag input styling and mobile responsiveness. We also peek under the hood at the Postgres database using Table Plus and skim the Rails models to understand how bookmarks, tags, and the bookmark-tags join table all relate. Finally, we commit and push our work to GitHub to lock in milestone one.
In this lesson:
- Using the milestone one prompt generated by the BM PRD Creator skill
- Why I always start in plan mode, even after a detailed PRD
- Reviewing Claude's implementation plan and answering its clarifying questions
- Asking Claude to explain technical concepts (like the title fetcher service) in plain language
- Running the build in auto mode and watching the to-do list progress
- Testing the working app: creating bookmarks, auto-fetching titles, tagging, filtering, search, and editing
- Using screenshots + voice prompts to fix small UX issues quickly
- Verifying dark mode and mobile responsiveness
- Renaming tags globally through the manage tags interface
- Inspecting the Postgres database in Table Plus to see bookmarks, tags, and the join table
- Reading the Rails models to understand associations (
belongs_to,has_many) - Committing and pushing milestone one to GitHub