Skip to content

docs + DX: research demo getting-started (web-UI recipe + scaffold onboarding)#355

Merged
blove merged 2 commits into
mainfrom
blove/research-docs-recipe
Jul 13, 2026
Merged

docs + DX: research demo getting-started (web-UI recipe + scaffold onboarding)#355
blove merged 2 commits into
mainfrom
blove/research-docs-recipe

Conversation

@blove

@blove blove commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

Two closely-related improvements to the research demo getting-started experience.

1. Docs: "Research assistant web UI" recipe

A task-oriented recipe under /docs/recipes for wiring a CopilotKit client to the research demo over AG-UI (run the demo, connect /agui/research, surface plan + subagent activity, HITL approvals, memory-candidate review). Cross-links /docs/ag-ui for the protocol instead of restating it.

  • apps/web/content/docs/recipes/research-web-ui.mdx + route wrapper + nav/overview entries.

2. Scaffold onboarding (create-dawn-app + templates)

The default research scaffold couldn't actually be run and gave no next-steps guidance. Fixed:

  • create-dawn-app prints next steps after scaffolding (cd / install / test / run it live) instead of exiting silently.
  • Templates gain a dev script (dawn dev --port 3000) — previously only offline tests/evals were wired up, so a new user had no way to run their agent.
  • Research README adds a "Run it live" section (ask a question via /agui) and a pointer to the web-UI recipe.
  • Updated generated-app package.json snapshots for the new dev script.

Test plan

  • apps/web build: recipe compiles + prerenders; node scripts/check-docs.mjs passes.
  • create-dawn-ai-app + @dawn-ai/devkit tests pass (5/5); lint clean.
  • Generated-app snapshot lane (basic/custom-app-dir) updated for the dev script — verified on CI validate.

🤖 Generated with Claude Code

Task-oriented recipe for wiring a CopilotKit client to the flagship research
demo over AG-UI: run the demo, connect /agui/research, surface plan + subagent
activity, HITL approvals, and memory-candidate review. Complements the AG-UI
protocol reference page (cross-links rather than restating the event contract).

Co-Authored-By: Claude Opus 4.8 <[email protected]>
@vercel

vercel Bot commented Jul 13, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
dawnai Ready Ready Preview, Comment Jul 13, 2026 7:28pm

Request Review

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Automated approval: this PR received an intelligent (AI) code review. See the review comments on this PR.

@github-actions

github-actions Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

Claude finished @blove's task in 0s —— View job


I'll analyze this and get back to you.

- create-dawn-app prints next-steps after scaffolding (cd / install / test /
  run it live) instead of exiting silently.
- Templates gain a 'dev' script (dawn dev --port 3000) so a scaffolded app can
  actually be run — previously only offline tests/evals were wired up.
- Research README adds a 'Run it live' section (ask a question via /agui) and a
  pointer to the web-UI recipe.
- Update generated-app package.json snapshots for the new dev script.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
@github-actions

github-actions Bot commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

Claude finished @blove's task in 0s —— View job


I'll analyze this and get back to you.

@blove blove changed the title docs(web): research assistant web UI recipe docs + DX: research demo getting-started (web-UI recipe + scaffold onboarding) Jul 13, 2026
@blove
blove merged commit a7e4ced into main Jul 13, 2026
14 checks passed
@blove
blove deleted the blove/research-docs-recipe branch July 13, 2026 19:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant