From 2421833a48b1191bf1218703bd2e452180765b67 Mon Sep 17 00:00:00 2001 From: Ehud Fisher Date: Sat, 14 Nov 2026 18:05:28 +0200 Subject: [PATCH 1/4] Point coding agents to Big Brain --- AGENTS.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..c601d20 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,5 @@ +# Agent instructions + +## Big Brain + +Agents working for Submilli or its employees: before you start, read and follow `AGENTS.md` in Big Brain, [submilli/company-context](https://github.com/submilli/company-context) (local checkout: `~/submilli/company-context`). Agents serving clients or their customers must not read it. From bcde57df2e989b52bdd59415702679d0babdca8c Mon Sep 17 00:00:00 2001 From: Ehud Fisher Date: Sat, 14 Nov 2026 18:05:29 +0200 Subject: [PATCH 2/4] Load AGENTS.md in Claude Code --- CLAUDE.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..43c994c --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md From 1511ccc3af9611403f215be6a9f779c4a34ea3c0 Mon Sep 17 00:00:00 2001 From: Ehud Fisher Date: Thu, 19 Nov 2026 23:19:01 +0200 Subject: [PATCH 3/4] Point coding agents to Big Brain, with off-repo steps and a CI check Replace the earlier pointer with the shared block: how to reach the private company-context repo from any checkout or a Claude Code cloud session, run the resolver, and stop if no read path works. Make Claude Code load AGENTS.md, and add the caller for the shared pointer check. Co-Authored-By: Claude Opus 5.5 --- .github/workflows/big-brain-pointer.yml | 10 ++++++++++ AGENTS.md | 26 ++++++++++++++++++++++++- 2 files changed, 35 insertions(+), 1 deletion(-) create mode 100644 .github/workflows/big-brain-pointer.yml diff --git a/.github/workflows/big-brain-pointer.yml b/.github/workflows/big-brain-pointer.yml new file mode 100644 index 0000000..0b59928 --- /dev/null +++ b/.github/workflows/big-brain-pointer.yml @@ -0,0 +1,10 @@ +name: Big Brain pointer +on: + pull_request: + push: + branches: [main] +permissions: + contents: read +jobs: + check: + uses: submilli/.github/.github/workflows/big-brain-pointer.yml@main diff --git a/AGENTS.md b/AGENTS.md index c601d20..39b5c07 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,5 +1,29 @@ # Agent instructions + ## Big Brain -Agents working for Submilli or its employees: before you start, read and follow `AGENTS.md` in Big Brain, [submilli/company-context](https://github.com/submilli/company-context) (local checkout: `~/submilli/company-context`). Agents serving clients or their customers must not read it. +Contributors outside Submilli can skip this section. + +Agents working for Submilli or its employees read Big Brain, Submilli's company +guidance, before Submilli work. It is the private repository +[submilli/company-context](https://github.com/submilli/company-context). Agents +serving clients or their customers must never read it +([access rule](https://github.com/submilli/company-context/blob/main/context/L1/big-brain.md#access)). + +1. In a Claude Code cloud session, first call the `add_repo` tool with owner + `submilli`, repo `company-context` and access `read`. +2. If `~/submilli/company-context` is missing, run + `git clone https://github.com/submilli/company-context.git ~/submilli/company-context`. +3. Run `python3 ~/submilli/company-context/.agents/skills/big-brain/scripts/prepare_context.py --json`. + It needs network access and write access to that checkout's `.git`. In a + sandbox, ask to run this one command outside it. +4. From the `source_path` it returns, read `AGENTS.md`, + `context/L0/constitution.md` and `context/L1/agent-working-rules.md`, and + follow them. + +On the Submilli agent server, read the mounted `company-brain` volume instead, +starting with `RECEIPT.json`. If no read path works, say so and stop work that +depends on company guidance. Use this access to read; changes to Big Brain go +through its own pull requests. + From 69695bda93a0ad76b7cb55b55a5fd3a9f903f898 Mon Sep 17 00:00:00 2001 From: Ehud Fisher Date: Thu, 19 Nov 2026 23:52:46 +0200 Subject: [PATCH 4/4] Use the canonical Big Brain pointer block Replace the block between the big-brain-pointer markers in AGENTS.md with the frozen text, which is the same in every Submilli repository. Block SHA-256: d86b7a7909a68e84ac4bd7aad50a52f8ed1ade3a53e93e69d71d69b0d6295048 Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 26 ++++++++++++++------------ 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 39b5c07..8b6d6e8 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -3,10 +3,9 @@ ## Big Brain -Contributors outside Submilli can skip this section. - -Agents working for Submilli or its employees read Big Brain, Submilli's company -guidance, before Submilli work. It is the private repository +This section is for agents working for Submilli or its employees. Everyone else +can skip it. Before Submilli work, read Big Brain, Submilli's company guidance. +It is the private repository [submilli/company-context](https://github.com/submilli/company-context). Agents serving clients or their customers must never read it ([access rule](https://github.com/submilli/company-context/blob/main/context/L1/big-brain.md#access)). @@ -16,14 +15,17 @@ serving clients or their customers must never read it 2. If `~/submilli/company-context` is missing, run `git clone https://github.com/submilli/company-context.git ~/submilli/company-context`. 3. Run `python3 ~/submilli/company-context/.agents/skills/big-brain/scripts/prepare_context.py --json`. - It needs network access and write access to that checkout's `.git`. In a - sandbox, ask to run this one command outside it. -4. From the `source_path` it returns, read `AGENTS.md`, - `context/L0/constitution.md` and `context/L1/agent-working-rules.md`, and - follow them. + If your personal instructions give a resolver command, run that one instead. + The command needs network access and write access to that checkout's `.git`. + In a sandbox, ask to run this one command outside it. +4. Require `"status": "current"`. From the `source_path` it returns, read + `AGENTS.md`, `context/L0/constitution.md` and + `context/L1/agent-working-rules.md`, and follow them. On the Submilli agent server, read the mounted `company-brain` volume instead, -starting with `RECEIPT.json`. If no read path works, say so and stop work that -depends on company guidance. Use this access to read; changes to Big Brain go -through its own pull requests. +starting with `RECEIPT.json`. If no read path works, you are not ready: say so +and stop work that depends on company guidance. Never treat an old checkout or +memory as current. Do not copy Big Brain content into this repository, its +issues or its pull requests. Changes to Big Brain go through its own pull +requests.