Skip to content

docs: codify commit message and code comment conventions - #405

Merged
imantsk merged 1 commit into
core-betafrom
docs/agent-conventions
Jun 11, 2026
Merged

docs: codify commit message and code comment conventions#405
imantsk merged 1 commit into
core-betafrom
docs/agent-conventions

Conversation

@imantsk

@imantsk imantsk commented Jun 11, 2026

Copy link
Copy Markdown
Member

Adds two sections to AGENTS.md (the single source of truth all tool shims point to):

  • Commit Messages — single-line conventional commits starting with fix:/feat:/chore:/docs: only, no scope parentheses, no co-author or other trailers, one concern per commit.
  • Code Comments — comments state current constraints the code cannot show; no narration, no change-justification, no arguing with previous implementations — history belongs in the commit message.

Codifies conventions already practised in review so all agents (Claude Code, Codex, Cursor, Copilot) inherit them from one place.

@imantsk
imantsk merged commit 2970e04 into core-beta Jun 11, 2026
9 checks passed
@sheabunge
sheabunge deleted the docs/agent-conventions branch July 29, 2026 05:20
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