docs(skills): add session-hygiene skill and mandatory gate - #424
Open
castrojo wants to merge 2 commits into
Open
docs(skills): add session-hygiene skill and mandatory gate#424castrojo wants to merge 2 commits into
castrojo wants to merge 2 commits into
Conversation
Codifies four working-session rules learned from maintainer course-corrections: disambiguate PR review targets (never substitute the working tree), reviews are read-only, end sessions with a clean working tree, and answer-first communication that separates unrelated workstreams. Assisted-by: Kimi K3 via GitHub Copilot Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Dependency Review✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.Scanned FilesNone |
hanthor
approved these changes
Aug 21, 2026
hanthor
left a comment
hanthor
left a comment
Member
There was a problem hiding this comment.
Docs-only skill addition. The four rules are concrete and each ties back to a specific real incident, which is exactly what makes a skill file worth having rather than generic advice. Routing table entries in docs/SKILL.md and the AGENTS.md gate summary are consistent with the new file's content, and the pattern matches how other skills in this repo are wired in. All 3 checks (dependency review, consumer-validation evidence, secret-reference scan) pass, as expected for a docs-only change with no action/workflow files touched.
Generated by Claude Code
Add When to Use / When NOT to Use / Common Rationalizations / Red Flags / Verification sections per the end-session audit checklist. Assisted-by: Kimi K3 via GitHub Copilot Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.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
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.
What
New
docs/skills/session-hygiene.mdskill + routing indocs/SKILL.md+ a mandatory gate inAGENTS.md.Why
Codifies four working-session rules, each learned from a real maintainer course-correction in session history (
/chronicle improveanalysis):/pullslink means list PRs and confirm; the local working tree is never the review targetDocs-only change — no action or reusable workflow files touched.
Consumer PR: N/A (docs-only; consumer-validation check only enforces on
bootc-build/**/action.ymlandreusable-*.ymlchanges)Consumer CI run: N/A (docs-only)
Out-of-org consumer impact: N/A — no action behavior changes