Skip to content

feature: UI spec prompt for the overdue inbound dashboard card demo - #5

Closed
matthewguerra-cog wants to merge 1 commit into
spec-demo-basefrom
devin/1787241412-ui-spec-prompt
Closed

matthewguerra-cog wants to merge 1 commit into
spec-demo-basefrom
devin/1787241412-ui-spec-prompt

Conversation

@matthewguerra-cog

@matthewguerra-cog matthewguerra-cog commented Aug 20, 2026 •

Copy link
Copy Markdown
Collaborator

✨ Description of Change

Link to GitHub issue or Jira ticket: n/a (spec-driven-development demo material)

Description:

Adds docs/demo/ui-spec-prompt.md — the prompt used in the demo to have Devin produce a UI spec (as opposed to the OpenAPI contract in openapi/specs/shipment-exceptions-api.yaml), plus the reasoning for why that prompt is shaped the way it is.

Documentation only: one new markdown file, no code, config, or spec changes.

The feature the prompt targets is an "Overdue inbound" card on the warehouse dashboard, fed by the GET /api/shipments/exceptions/overdue endpoint that already exists on this branch — so it is deliberately UI-only, with no backend query, domain change, or migration. The prompt points at the repo's real conventions so the generated spec is grounded rather than generic:

  • widgets are declared in openboxes.dashboardConfig in grails-app/conf/runtime.groovy (enabled / title / info / type / graphType / endpoint, and dashboards list widgets by widgetId + order)
  • cards are rendered by src/js/components/dashboard/ (NumberCard, TableCard, NumbersTableCard, GraphCard)
  • titles and info tooltips resolve to react.dashboard.* keys in grails-app/i18n/messages.properties
  • per-user card layout is persisted through UserService.getDashboardConfig

The file contains both a short version of the prompt (for presenting live) and a fuller version (for a more predictable result), and it asks for numbered acceptance criteria in the style of openapi/specs/shipment-exceptions-acceptance-criteria.md so a UI spec — which no linter can check — still ends up verifiable by a Playwright test under characterization/tests/.

Devin-Org: engineering

Link to Devin session: https://app.devin.ai/sessions/c3eddd41a03445f3afc7922b3579bddc
Requested by: @matthewguerra-cog


Devin Review

Status Commit
🟢 Reviewed 44749f2
Open in Devin Review (Staging)

…d demo

Co-Authored-By: Matthew Guerra <matthew.guerra@cognition.ai>
@devin-ai-integration

Copy link
Copy Markdown

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

Open in Devin Review

@staging-devin-ai-integration staging-devin-ai-integration Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

Open in Devin Review (Staging)
Debug

Playground

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant