Skip to content

AGENTS.md: one-source instruction file (MX-846) - #4

Merged
MGrin merged 1 commit into
mainfrom
agents-md-one-source
Sep 9, 2026
Merged

MGrin merged 1 commit into
mainfrom
agents-md-one-source

Conversation

@MGrin

@MGrin MGrin commented Sep 9, 2026

Copy link
Copy Markdown
Owner

AGENTS.md is the only instruction source; CLAUDE.md is the byte-exact 11-byte pointer @AGENTS.md; there is no .bb/AGENTS.md; the ceiling is stamped at the file's current line count.

New AGENTS.md; no instruction file before.

Verified by running, 2026-09-09

  • npm install (rc=0)
  • npm test — 32 tests, 0 fail

Found, not fixed

  • npm run typecheck fails with 7 errors on a clean clone: @get-bb/plugin-sdk is missing from devDependencies, so TS2307: Cannot find module '@bb/plugin-sdk' cascades into implicit anys. The README lists the command as though it passes.

mx instructions lint on this tree

$ mx instructions lint .
repo         . (own)
  imports      1 seen, deepest 1 hop(s) of 4 — 0 seen is a pass, not a blind
  size-lines   58 of 58 (ceiling from the stamp)
  size-bytes   3102 of 4194304
  pair-no-bb   .bb/ present: false — the directory is fine, .bb/AGENTS.md is not
  overlap      0.0%  0 of 490 shingles also in ~/.bb/AGENTS.md
  nested       none below the root
exit 0

🤖 Generated with Claude Code

AGENTS.md is the only instruction source; CLAUDE.md is the 11-byte
pointer `@AGENTS.md`; no `.bb/AGENTS.md`; the ceiling is stamped at the
file's current line count (MX-846).

New AGENTS.md; no instruction file before.

Verified by running, 2026-09-09:
  - npm install (rc=0)
  - npm test — 32 tests, 0 fail

Found, not fixed (out of scope for this pass):
  - `npm run typecheck` fails with 7 errors on a clean clone: `@get-bb/plugin-sdk` is missing from devDependencies, so `TS2307: Cannot find module '@bb/plugin-sdk'` cascades into implicit `any`s. The README lists the command as though it passes.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@MGrin
MGrin merged commit 106a098 into main Sep 9, 2026
1 check passed
@MGrin
MGrin deleted the agents-md-one-source branch September 9, 2026 07:35
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