Clarify pattern boundaries - #42
Open
devill wants to merge 4 commits into
Open
Conversation
… and User Reminders Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
devill
marked this pull request as ready for review
July 29, 2026 14:49
devill
marked this pull request as draft
July 29, 2026 14:56
devill
marked this pull request as ready for review
July 29, 2026 15:03
|
|
||
| This is what we've always done for humans: good error messages guide you to the solution. It works equally well for AI agents. | ||
|
|
||
| This needs no agent integration — the guidance lives in the output of scripts you own. When the trigger comes from a tool you can't modify (a linter, a test runner), see Habit Hooks, which delivers the same just-in-time guidance through agent lifecycle Hooks. |
There was a problem hiding this comment.
"the guidance comes from the output"?
The sentence starting "When the trigger comes..." doesn't need the comma after the closing parens. Is it saying "when the trigger comes from a tool you can't modify (...) consider Habit Hooks [pattern]..."
|
|
||
| This approach reduces context bloat while improving compliance by providing precise, relevant guidance exactly when violations occur, rather than front-loading massive instructions that AI forgets or misapplies. | ||
|
|
||
| Habit Hooks is Contextual Prompts applied to tools you can't modify: a deterministic detector provides the trigger, Hooks provide the delivery, and the prompt provides actionable coaching. |
There was a problem hiding this comment.
"Habit Hooks are Contextual Prompts..."
| - Provide just-in-time guidance when specific conditions are detected | ||
| - Inject reminders before the agent forgets your preferences | ||
|
|
||
| Hooks are the delivery mechanism — what you deliver through them is a separate choice. User Reminders (see Reminders) re-inject your most important rules; Habit Hooks pairs hooks with quality detectors to coach specific fixes. When the guidance belongs in a script you own, you may not need hooks at all — see Contextual Prompts. |
There was a problem hiding this comment.
"Habit Hooks pair..." (shouldn't be plural)
"... coach specific fixes..." feels as if it's missing a "that result in ..." conclusion to the sentence.
andrewharmellaw
approved these changes
Jul 30, 2026
andrewharmellaw
left a comment
andrewharmellaw
left a comment
There was a problem hiding this comment.
Made a few suggestions - feel free to ignore any you disagree with.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012EjEPvjHK2SVy9jjzwMSRm
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.
Hooks, Contextual Prompts, Habit Hooks and User Reminders read as near-duplicates. One boundary line in each says how they differ.
Also here: a link to the Habit Hooks open-source implementation, and Workflows added to Orchestrator's tool list.