Add: the hi habit, so intent gets written before the work - #80
Merged
Merged
Conversation
Tells an agent working here to draft the criteria for a feature, show them to the person, capture only what they confirm, and then build. No criteria are captured here. Writing intent for a product from its own code reverse-engineers the want from the implementation and makes what is missing invisible. The first real criterion should come from a person asking for something, in their words. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
corvid-agent
approved these changes
Sep 17, 2026
corvid-agent
left a comment
Contributor
There was a problem hiding this comment.
CoS APPROVE — HI habit scaffold (first-pass)
Matches the org HI-first pattern already approved on trust#42 / let#10 / augur#56 / attest#50 / arcron#257 / corvid-verify#69: Human intent section in agent guidance, draft→show human→capture confirmed lines only, explicit refuse of reverse-engineered bulk criteria.
Treated as first-pass draft for human edit — Leif may rewrite/retire/replace; not requesting changes for imperfect scaffold wording.
No secrets; no merge from CoS.
CI (Ruby matrix + Spec Sync + trust + CodeQL) green on this tip.
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
Adds a short Human intent section to this repository's agent guidance, pointing at hi.
This repo has no
hi/yet. The block tells an agent working here to draft the criteria for a feature, show them to you, capture only what you confirm, and then build — before every feature, not just the first.What this deliberately does not do
No criteria are captured here. Writing intent for a product by reading its own code reverse-engineers the want from the implementation, and makes whatever is missing invisible — which is the part worth having. The first real criterion should come from a person asking for something, in their words.
The block says so explicitly, because the tempting next step is to generate a hundred plausible sentences nobody ever said. Ids are permanent and never reused, so one spent on a wrong sentence is spent forever.
Installing
brew install corvidlabs/tap/hiorcargo install human-intent(currently 0.5.0).Once the first criterion is captured, hi writes a
hi/AGENTS.mdof its own, so this block is only needed until then.🤖 Generated with Claude Code