feat: simplify templates to agent-first prompt gallery#101
Merged
Conversation
pkosiec
force-pushed
the
pkosiec/remove-human-instructions
branch
from
ce414b1 to
05b45bc
Compare
pkosiec
changed the title
pkosiec
force-pushed
the
pkosiec/remove-human-instructions
branch
2 times, most recently
from
8022985 to
ba1ff06
Compare
Templates are now an inspirational gallery — not a manual guide. Agent skills handle implementation; templates provide goals and prerequisites only. - Delete all content.md files (22 step-by-step instruction files) - Deduplicate prerequisites: remove CLI auth boilerplate (handled by localBootstrap recipe), keep workspace-specific checks - Simplify TemplateUsageBanner to agent-only CTA (remove "Read step-by-step" split) - Remove TOC sidebar from recipe/cookbook/example detail pages - Remove "human" composition mode from cookbook-composition - Simplify cookbook pages to render only goal.md - Update content-entries plugin, content-sections, content-markdown - Update gallery subtitle to agent-first copy - Update validate-content script and all tests - Update author-recipes-and-cookbooks skill Co-authored-by: Isaac
Merge the title, description, and copy-prompt into a centered hero section on every template detail page. The CTA is now the most visible element — large, centered, with a rounded pill button. - Remove TemplateUsageBanner component (inlined into detail pages) - Update recipe-detail, cookbook-detail, example-detail with hero layout - Add className and label props to CopyPromptButton for flexible sizing - Cookbook component list comes from goal.md (no programmatic duplicate) Co-authored-by: Isaac
- Add explicit type predicates for .filter(Boolean) in example-detail.tsx - Add null guard for sectionsBySlug access in content-entries plugin - Remove dead CONTENT_SECTION_FILES const, use direct union type - Remove ExampleSections identity alias, use ContentSections directly - Reject whitespace-only goal.md in content validator - Add test for buildCookbookMarkdownDocument empty-body branch - Replace raw hex gradient with brand tokens in cookbook-detail Co-authored-by: Isaac
Remove the first paragraph from each recipe goal.md since it duplicates the registry description shown in the hero. The agent prompt still carries the description via the YAML frontmatter summary field. Add service badges (e.g. "Lakebase Postgres", "Databricks Apps") to the recipe detail hero for at-a-glance technology context. Co-authored-by: Isaac
Co-authored-by: Isaac
Replace the standalone CTA button with a bordered card that explains the 3-step agent workflow (copy, paste, build). Shared AgentUsageCard component used across recipe, cookbook, and example detail pages. Co-authored-by: Isaac
pkosiec
force-pushed
the
pkosiec/remove-human-instructions
branch
from
ba1ff06 to
e74a70f
Compare
Member
Author
Template Prompt Testing SummaryMethodologyAll 32 DevHub template prompts (21 recipes, 5 cookbooks, 6 examples) were tested end-to-end by:
Results
Examples (6/6 PASS)
Cookbooks (5/5 PASS)
Recipes (21/21 PASS)
PARTIAL ExplanationThe 2 PARTIAL verdicts are not real gaps — they are metadata classification artifacts:
ConclusionAll 32 template prompts produce working, buildable apps that correctly use their declared Databricks services. The removal of human step-by-step instructions is validated — coding agents can one-shot build every template from the prompt alone using Databricks agent skills. |
thisistonydang
approved these changes
May 31, 2026
thisistonydang
added a commit
that referenced
this pull request
May 31, 2026
…tail pages PR #101 accidentally dropped the per-template `TemplatePreviewImage` from recipe-detail.tsx and replaced cookbook-detail.tsx's preview with a generic placeholder SVG. Restore the original pattern (still used by example-detail.tsx) so each recipe and cookbook shows its own previewImageLight/DarkUrl, with the `FallbackCardArt` art as the empty state. Drops the now-orphan `static/img/template-detail-hero.svg`.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Shifts templates from step-by-step human guides to an agent-first prompt gallery. Users copy a prompt; agent skills handle implementation.
Screenshots
Test plan
npm run typecheck && npm run build && npm run testall passThis pull request and its description were written by Isaac.