Skip to content

Commit 7f5721c

Browse files
Theaxiomclaude
andcommitted
bootstrap: replace the AEGIS symlink with a thin AGENTS.md
AGENTS.md was a committed symlink to ../aegis-architecture/AGENTS.md, which resolved only because every 100monkeys repository is cloned side by side in one directory; in a lone clone it dangled and this repository carried no contract at all. It is now a real file naming the AEGIS Architecture workspace, its UUID, its readme landing slug, the pre-alpha rule with its stored-state carve-out, and the two additions to the human-only floor. ADR-119 phase B. The contract the old symlink pointed at now lives in that workspace's grounding and operations pages, with the shared half referenced by permalink from the project-management process library. CLAUDE.md is unchanged and still symlinks to AGENTS.md. Evidence: git ls-files -s AGENTS.md CLAUDE.md before 120000 13db908 0 AGENTS.md 120000 47dc3e3 0 CLAUDE.md readlink AGENTS.md before: ../aegis-architecture/AGENTS.md after: (not a symlink) readlink CLAUDE.md before and after: AGENTS.md Workflows on push to main, read from .github/workflows before pushing: ci.yml Node lint, build and test. GATING. security.yml npm audit on push to main; also scheduled weekly. Green on the pre-landing tip 5f1a1fb on 2026-08-31, 08-24 and 08-17. npm-publish.yml Tags only ('*.*.*'); not triggered by a push to main. Nothing deploys, applies infrastructure, restarts a service, or writes to anything a running system reads. Not verified: no build, test, lint or formatter was run locally; the change is one Markdown file that no test reaches. Signed-off-by: Jeshua ben Joseph <jeshua@100monkeys.ai> Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WgN1NGd8aD6oA1aeCwMxbB
1 parent 5f1a1fb commit 7f5721c

1 file changed

Lines changed: 27 additions & 1 deletion

File tree

AGENTS.md

Lines changed: 0 additions & 1 deletion
This file was deleted.

AGENTS.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
# AGENTS.md — Bootstrap for aegis-sdk-typescript
2+
3+
This file is a **bootstrap**, not the engineering contract. The contract — architecture, decisions, operating principles, testing, commit workflow, the autonomy boundary, every lesson already learned — lives in the AEGIS Architecture workspace of the cortex at `https://100monkeys-ai.cortex.page/aegis-architecture/`. Read this file once, ground against that workspace, and work from there. **Where this file and the workspace disagree, the workspace wins and this file is stale.**
4+
5+
## Ground first
6+
7+
1. `cortex_ground` with `workspace: "c8b0fadf-176c-418a-a8a4-a148dcf9fd1d"`. Read the instance grounding and the workspace grounding it returns, in full.
8+
2. Read the workspace landing page `readme`. It is the navigation table: which page to read for which kind of work.
9+
3. Read the pages `readme` names for your task before writing code — the process pages it links in the `project-management` workspace, then the ADR itself: the record, not a summary of it.
10+
11+
**Pass `workspace: "c8b0fadf-176c-418a-a8a4-a148dcf9fd1d"` on every cortex call** — page, atom, search, tag, comment, knowledge graph, reads and writes alike. The MCP token has one current-workspace pointer, shared by every session presenting that token; any of them can move it between two of your calls, and a call that omits `workspace` resolves against wherever the pointer happens to be, with no error. Prefer the UUID over the slug `aegis-architecture`.
12+
13+
## The rules you must see before you connect
14+
15+
**AEGIS is pre-alpha in its code paths and published in its artefacts.** No backward-compatibility shims, no legacy code paths, no deprecation cycles inside a repository — remove any you find. The carve-out is anything holding state a real tenant depends on: user volumes, tenant records, billing state, and the Postgres schemas underneath them. A change there is a forward-only migration, never a removal.
16+
17+
**Never bump a version string, create a tag, or push a tag without Jeshua's exact trigger phrase.** See `guidelines/version-management` in the workspace. If you are not sure whether versioning was requested, it was not.
18+
19+
**An agent's job ends at commit and push.** CI builds and publishes the image. Jeshua handles every deployment, dev and production alike.
20+
21+
## The repository map is one directory up
22+
23+
`../CLAUDE.md` in the local monorepo directory maps every 100monkeys-ai repository to the workspace that governs it, and carries the instructions for attaching the cortex MCP server if it is not present in your session. **`zaru-client` and `zaru-marketing` are governed by the `zaru` workspace, not by this one.**
24+
25+
## Modifying this file
26+
27+
Keep it to "where to look, how to attach, and what an agent must see before connecting". Anything longer belongs in a page in the AEGIS Architecture workspace, not here.

0 commit comments

Comments
 (0)