Skip to content

docs: add AGENTS.md - #10

Merged
omercnet merged 2 commits into
mainfrom
docs/agents-md
Nov 21, 2026
Merged

omercnet merged 2 commits into
mainfrom
docs/agents-md

Conversation

@omercnet

Copy link
Copy Markdown
Contributor

What changed

Adds AGENTS.md at the root: set-up, commands that exist on main, where things live, the architecture rules that tests enforce, house rules, pull request rules, the definition of done, Docker safety, and when to stop and ask.

Why

Agents (and people) should get the working rules in one place. Claude Code reads AGENTS.md when there is no CLAUDE.md, and OMP reads it from the repository root, so one file serves both.

How it was verified

On a fresh clone of main, through mise: mise install, then mise exec -- npm ci --ignore-scripts, npm run lint, typecheck, build, npm test (29 passed), test:tools, test:integration, test:container, test:benchmark, both gitleaks scans, and the sleep check. All exit 0. The relative link resolves.

Visuals

Not applicable: documentation only.

Checklist

  • Tests added or updated, or not applicable
  • No secrets or credentials committed
  • Docs updated, or not applicable

@omercnet
omercnet enabled auto-merge (squash) November 21, 2026 10:22
@shuni-bot

shuni-bot Bot commented Nov 21, 2026 •

Copy link
Copy Markdown

🐕 Shuni Review

No new issues found.

🤖 Model: claude-opus-5.5 · Effort: medium


Review scope: Full review

Reviewed files (1)
  • AGENTS.md

🐕 Review complete — View session on Shuni Portal 🐾

🤖 Model: claude-opus-5.5 · Effort: medium

@baz-reviewer

baz-reviewer Bot commented Nov 21, 2026 •

Copy link
Copy Markdown

Review this PR on Baz

Baz Summary

Add a root AGENTS.md that centralizes setup commands, repository architecture, development rules, pull request expectations, verification requirements, Docker safety, and escalation guidance. Document the roles of core packages, adapters, applications, CI tooling, and workflows so agents and contributors can work consistently.

Latest Contributors(1)
UserCommitDate
omercnetdocs: address review o...November 21, 2026


Merger  Activate to get a short verdict whether this PR is good to go or not

Skills  Activate Skill Maintainer to keep your skills up to date

Planner  This PR would have been improved with Baz Planner - Try it now

@omercnet omercnet mentioned this pull request Nov 21, 2026
3 tasks done

@shuni-bot shuni-bot Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🐕 Shuni review: 4 inline findings. Every changed file in this pull request was reviewed.

The full review summary is in Shuni's sticky review comment on this pull request.

Comment thread AGENTS.md Resolved
Comment thread AGENTS.md Resolved
Comment thread AGENTS.md Resolved
Comment thread AGENTS.md Resolved

@shuni-bot shuni-bot Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🐕 Shuni review: no new findings. Every changed file in this pull request was reviewed.

The full review summary is in Shuni's sticky review comment on this pull request.

@omercnet
omercnet merged commit b1958d6 into main Nov 21, 2026
11 checks passed
@omercnet
omercnet deleted the docs/agents-md branch November 21, 2026 10:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant