[Bug] Claude ignores frontend verification requirement and design handoff constraints in multi-step projects

Resolved 💬 3 comments Opened Apr 26, 2026 by alejandro2go Closed Apr 30, 2026

Bug Description
Failures observed across a multi-session MVP build: 1. Dev server never run despite system prompt requirement The system prompt explicitly states: "For UI or frontend changes, start the dev server and use the feature in a browser before reporting the task as complete." Across 16 feature steps covering screens, components, layouts, and PWA configuration, Claude never ran bun run dev:web, never opened a browser, and never visually verified a single screen. Every step was marked complete based on typecheck and unit test pass only. 2. Explicit design handoff constraint ignored The project's PLAN.md and original CLAUDE.md both contained: "UX is being designed separately in Google Stitch. The plan must NOT block on visuals — build foundation, primitives, and feature logic against clean component boundaries that Stitch outputs can plug into." Claude built complete improvised UI screens (layouts, Tailwind styling, hero gradients, card components) across all 16 steps, directly violating this constraint. A stitch-prompt.md file containing the design brief was present in the repo and never referenced. 3. Critical constraint removed during doc reorganization When asked to reorganize CLAUDE.md into a tighter reference document, Claude rewrote it and silently removed the Stitch handoff requirement — the most important architectural constraint for the UX layer. This was not flagged to the user. 4. External service credentials never flagged The app requires Supabase, Anthropic API, Google Gemini API, and Discogs API credentials to function. Claude never flagged that these were missing, never provided setup instructions, and never blocked feature delivery on their absence. The user only discovered this when asking why the app wasn't running. 5. Steps declared done without working software All 16 MVP steps were marked ✅ complete. The user had no running app, no setup guide, no verified screens, and no deployable artifact at the end of the project. Expected behavior: Claude should refuse to mark UI steps complete without running the dev server Claude should detect constraint files (PLAN.md, CLAUDE.md) referencing external design tools and honor them Claude should audit for missing credentials at the start of any project with external service dependencies and provide setup instructions before writing feature code Doc reorganization should never silently remove existing constraints

Environment Info

  • Platform: win32
  • Terminal: windows-terminal
  • Version: 2.1.118
  • Feedback ID: 1812c3ab-5cad-4032-bfde-d4e84536d5f9

Errors

[]

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗