docs(efficient-fable,efficient-frontier): add four delegation prompting practices#39
Open
remotesensei wants to merge 1 commit into
Open
Conversation
…ng practices
Both skills tell an orchestrator how to write handoff packets and vet
delegated work, but they were missing four practices that materially
improve subagent output:
- State the "why": one line of operational intent per handoff so the
subagent makes correct micro-decisions instead of guessing.
- Explicit negative scope ("don'ts"): keeps cheaper models from
refactoring beyond the ask, adding features, or fixing unrelated code.
- Act once you have enough info: don't loop on planning/re-delegating,
and match effort/model tier to the task.
- Make it prove it: require the command + its output, the diff, or
file:line evidence before accepting "done".
efficient-frontier mirrors efficient-fable, so both get the same edits
to stay in parity. Prose-only; no frontmatter or structure changes.
Contributor
|
Thanks, @remotesensei, this is great One thing to fix before merge: this branch still has the old Once that is cleaned up I'm happy to merge |
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
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
Add four prompting practices to the
/efficient-fableand/efficient-frontierskills that make delegated subagent work more reliable.Why
Both skills already tell an orchestrator how to write handoff packets and vet delegated work, but they leave out four practices that materially change the quality of what cheaper subagents return. In practice, subagents guess intent, over-reach scope, and report "done" without evidence — the additions close those gaps directly.
What changed
efficient-frontieris the explicit mirror ofefficient-fable, so both get the same edits to stay in parity. Prose-only — no frontmatter or structure changes.How to test
npm run check(withAGENT_NATIVE_FRAMEWORK_PATH=../agent-native) passes — the change touches only SKILL.md body prose, no skill structure or config.Notes
No migrations, no breaking changes. Two skills in one PR because they are maintained as a mirrored pair; happy to split if you'd prefer one skill per PR.