Repository navigation
feat(capsule): state completeness at the top of every capsule - #46
Merged
Merged
Conversation
An AI reading a capsule had to find gaps in a warnings list below the header, mixed with notes that are not gaps (video bytes kept in the companion file, duplicate hashes) and with repeated lines. A model asked to summarize would usually skip it. The .llm.md now opens with a Completeness section: COMPLETE, or INCOMPLETE with counts of what was not captured and what may be truncated, plus one sentence asking the reader to tell the user. The HTML shows the same status as a visible banner, only when incomplete. It is written as a stated fact and not hidden, so agents that treat file contents as data still see it. Only real gaps count. A video kept as poster plus source link, a quote tombstone and a missing avatar do not. The Warnings list is deduplicated and informational lines move to a separate Notes list; the manifest warnings array is unchanged. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Merged
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.
Capsules now say up front whether they are complete, so an AI reading one can tell the user.
.llm.md: a new## Completenesssection under the header. It readsStatus: COMPLETEorStatus: INCOMPLETEwith counts, plus one sentence asking the reader to tell the user and name what's missing.Noteslist. The manifestwarningsarray is unchanged.Tests: new smoke check covering the incomplete and clean cases;
npm test, lint and format check pass. The banner was checked by screenshot in the regenerated sample.🤖 Generated with Claude Code