Separate agent goal from human instructions#97
Draft
pkosiec wants to merge 4 commits into
Draft
Conversation
Agent prompts now receive only goal.md (outcome description) while human pages keep the full step-by-step content. This eliminates contradictions between recipe content and installed agent skills. - Add goal.md to all 21 recipes, 6 examples, and 5 cookbooks - Agent prompt builder uses goalOnly() — sends goal when present, falls back to full content for backward compat - Cookbook composition gains mode parameter: "agent" (goals only) vs "human" (full inline content) - Update intent blocks to direct agents to use skills for implementation - Update preamble text to reference goals instead of step-by-step content - Rename example content.md -> goal.md (already outcome-only) - Rename cookbook intro.md -> goal.md - Delete redundant rag-chat/deployment.md Co-authored-by: Isaac
Co-authored-by: Isaac
pkosiec
force-pushed
the
pkosiec/agent-skills-unification-2
branch
from
871a758 to
19d3586
Compare
buildFullPrompt() now uses sections.goal when present, skipping prerequisites/content/deployment. The agent gets the outcome description + scaffold entry point; skills handle implementation. Only rag-chat was affected (the sole example with prerequisites.md). Renamed its prerequisites.md to content.md so the human page still shows the Lakebase provisioning steps. Co-authored-by: Isaac
pkosiec
changed the title
- plugins/cookbooks.ts now reads goal.md (falls back to intro.md) - use-cookbook-markdown.ts passes mode: "agent" for copy prompt - All 5 cookbook pages import and render Goal component - Strip headings from cookbook goal.md files - Remove unused joinGoalAndContent() - Update stale REQUIRED_CONTENT_SECTION_FILE comment Co-authored-by: Isaac
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
1 participant
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
Agent prompts now receive only outcome descriptions (
goal.md), while human-facing pages keep full step-by-step instructions (content.md). This eliminates contradictions between recipe content and installed agent skills.What changed
goal.mdfile for all recipes (21), examples (6), and cookbooks (5) — describes WHAT to buildgoal.md; skills handle implementationCo-authored-by: Isaac