Repository navigation
Conversation
- The current roadmap step carries a checkpoint (next, done, open) that brief shows first and keeps when the budget is tight. - check --diff fails when the current step's paths change but its checkpoint does not, so every commit leaves a resume point (ADR-0018). - hook install --platform claude adds a SessionStart hook that runs brief in every new, resumed, cleared or compacted session; platforms without such a hook are refused (ADR-0019). - Skill, AGENTS.md contract and README now describe repository memory. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
`hook install --platform opencode` now writes a managed .opencode/plugins/steadfast-brief.js on OpenCode's experimental.session.compacting hook. The plugin runs the project's own brief and pushes it into output.context, so the summary a compacted session continues from carries the current step and its checkpoint; if brief fails it tells the agent to run it. `hook remove --platform opencode` deletes only that file, `--check` reports it, and a plugin file steadfast did not write is never overwritten or removed. ADR-0020 supersedes ADR-0019 with the OpenCode rule. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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.
Why
Large projects outlive a single context window. When the context fills and a new session starts, the work in progress is lost: what is done, what comes next, and which assumptions are still unproven. Agents also skip memory they are expected to fetch for themselves. This PR shifts steadfast from "normative docs" to repository memory that survives a context reset.
What changed
Roadmap checkpoint (ADR-0018)
checkpointwith three fields:next(the next concrete action), up to 3doneitems and up to 2openitems. It is rewritten in place, never appended to, so it cannot grow into another doc that goes stale.briefshows the checkpoint under the current step. If the brief runs over budget, the checkpoint is the last section to be cut.check --diffwarns, and fails under--strict(which the pre-commit hook uses), when the current step's paths changed but its checkpoint did not. Every commit therefore leaves a point to resume from, even if the context runs out mid-task.Session-start wiring (ADR-0019 → ADR-0020)
hook install --platform claudeadds aSessionStarthook to.claude/settings.jsonthat runsbrief. Every new, resumed, cleared or compacted Claude Code session starts with the current step and its checkpoint.hook install --platform opencodewrites a managed.opencode/plugins/steadfast-brief.js, which uses OpenCode'sexperimental.session.compactinghook to add the brief to the compaction context.hook removedeletes only what steadfast wrote, and--checkreports whether each hook is installed.Agent contract and docs
AGENTS.mdcontract written byinit, and the README now describe the resume loop. The skill still fits its 1200-token budget.Reviewer notes
AGENTS.mdinstruction to runbrief. The plugin covers compaction only, and its hook is marked experimental upstream.SessionStarthook or the OpenCode plugin in a live harness. The behavior follows each tool's docs and is covered by CLI tests.verified_by) were refreshed for existing records whose governed files changed. ADR-0019 is superseded by ADR-0020, not edited.npm test: 187/187 pass.steadfast check --strict: 0 errors, 0 warnings.🤖 Generated with Claude Code