Skip to content

Correct and extend CLAUDE.md agent guidance#54

Merged
richardmhope merged 1 commit into
mainfrom
claude-md-curation
Jul 4, 2026
Merged

Correct and extend CLAUDE.md agent guidance#54
richardmhope merged 1 commit into
mainfrom
claude-md-curation

Conversation

@richardmhope

Copy link
Copy Markdown
Collaborator

Session-learnings curation for the agent instructions file:

  • Fix: the documented pre-push command lacked --extra dev — bare uv run re-syncs the venv without extras and uninstalls ruff/mypy/pytest, so the command as written failed. Both occurrences corrected, with the reason noted.
  • Fix: supported-agents list was stale (missing Copilot and Cursor since Add Cursor and GitHub Copilot adapters #44).
  • Add: shipping convention (squash-merge + branch-protection/update-branch flow) and the skill-authoring bar (lint-enforced template, fetched authoritative sources cited in the body, eval fixture per skill) — both were re-derivable only from tests/history.

Net +12 lines, all agent-facing. No code changes.

🤖 Generated with Claude Code

- Fix the documented check commands: bare `uv run` re-syncs the venv
  without extras and uninstalls the dev tools, so every invocation
  needs --extra dev (the old command failed in practice)
- Update the supported-agents list, stale since the Copilot/Cursor
  adapters landed
- Document the shipping convention (squash-merge, branch protection
  requires up-to-date-with-main) and the skill-authoring bar
  (structural template, fetched authoritative sources, eval fixture)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@richardmhope
richardmhope merged commit fd0f6b4 into main Jul 4, 2026
11 checks passed
@richardmhope
richardmhope deleted the claude-md-curation branch July 4, 2026 03:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant