Skip to content

feat: simplify templates to agent-first prompt gallery#101

Draft
pkosiec wants to merge 6 commits into
mainfrom
pkosiec/remove-human-instructions
Draft

feat: simplify templates to agent-first prompt gallery#101
pkosiec wants to merge 6 commits into
mainfrom
pkosiec/remove-human-instructions

Conversation

@pkosiec
Copy link
Copy Markdown
Member

@pkosiec pkosiec commented May 25, 2026

Summary

Shifts templates from step-by-step human guides to an agent-first prompt gallery. Users copy a prompt; agent skills handle implementation.

  • Remove human step-by-step instructions from all recipes and rag-chat example
  • Replace multi-mode usage banner with a single hero-integrated "Copy prompt for your agent" CTA
  • Switch to single-column centered layout, remove TOC sidebar
  • Deduplicate recipe descriptions (hero vs goal.md) and add service badges
  • Simplify cookbook composition to goal-only mode
  • Update content validation, plugin infrastructure, and tests

Screenshots

image image

Test plan

  • npm run typecheck && npm run build && npm run test all pass
  • Visual verification of recipe, cookbook, and example detail pages
  • Copy-to-clipboard produces valid agent prompts with description in frontmatter

This pull request and its description were written by Isaac.

@pkosiec pkosiec force-pushed the pkosiec/remove-human-instructions branch from ce414b1 to 05b45bc Compare May 25, 2026 20:44
@pkosiec pkosiec changed the title Remove human step-by-step instructions from templates feat: simplify templates to agent-first prompt gallery May 26, 2026
@pkosiec pkosiec force-pushed the pkosiec/remove-human-instructions branch from 9e7915a to 8eda52d Compare May 26, 2026 15:23
pkosiec added 6 commits May 27, 2026 09:20
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
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 pkosiec force-pushed the pkosiec/remove-human-instructions branch from 8022985 to ba1ff06 Compare May 27, 2026 07:21
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