Two files, one repository
thangaram611/second-brain ships 6 formats across 25 indexed files. The question worth asking is whether the second one says anything the first does not.
CompareAGENTS.md ↔ CLAUDE.mdAGENTS.md ↔ Windsurf rulesAGENTS.md ↔ Cline rulesAGENTS.md ↔ Copilot instructionsAGENTS.md ↔ Cursor rulesCLAUDE.md ↔ Windsurf rulesCLAUDE.md ↔ Cline rulesCLAUDE.md ↔ Copilot instructionsCLAUDE.md ↔ Cursor rulesWindsurf rules ↔ Cline rulesWindsurf rules ↔ Copilot instructionsWindsurf rules ↔ Cursor rulesCline rules ↔ Copilot instructionsCline rules ↔ Cursor rulesCopilot instructions ↔ Cursor rules
| Dimension | Shared | Only in A | Only in B | Overlap |
|---|---|---|---|---|
| Sections | 0 | 6 | 1 | 0% |
| Commands | 0 | 1 | 0 | 0% |
| Section tags | 1 | 6 | 0 | 14% |
What each file covers
Sections
0 shared · 6 only in A · 1 only in B- − Second Brain — Agent Instructions
- − Monorepo Map
- − Commands
- − Conventions
- − Data Model
- − Docs
- + CLAUDE.md
Commands
0 shared · 1 only in A · 0 only in B- − pnpm install / build / test / check-types / lint / dev / clean
Section tags
1 shared · 6 only in A · 0 only in B- − setup
- − test
- − code-style
- − types
- − monorepo
- − docs
- agent-behaviour
Line diff
thangaram611/second-brain · AGENTS.md
@@ −1 @@
1# Second Brain — Agent Instructions
2
3Developer knowledge graph — shared engineering memory for teams ("git remembers the code; Second Brain remembers why"). pnpm monorepo, Turborepo, Node.js 24+, TypeScript 5.8+ strict, ESM only.
4
5Each package/app has its own AGENTS.md with package-specific instructions.
6
7## Monorepo Map
8
9```
10packages/types → Shared TS types
11packages/core → Graph engine (SQLite + Drizzle + FTS5 + sqlite-vec)
12packages/collectors → Data collectors + streaming providers
13packages/ingestion → LLM extraction + embedding pipeline
14packages/sync → Yjs CRDT sync bridge
15packages/mcp-server → MCP tools (32 tools, stdio + HTTP)
16apps/server → Express 5 REST + WebSocket (:7430)
17apps/ui → React 19 + Cytoscape.js + Zustand (:5173)
18apps/relay → Hocuspocus CRDT relay (:7421)
19tools/cli → brain CLI (Commander.js)
20```
21
22## Commands
23
24```bash
25pnpm install / build / test / check-types / lint / dev / clean
26```
27
28Per-package: `cd <pkg> && pnpm test|build|dev`
29
30## Conventions
31
32- ESM only (`"type": "module"`), `.mjs`/`.d.mts` output, `tsdown` for builds
33- ULIDs via `ulidx` for IDs — never UUID
34- ISO 8601 strings for timestamps — never unix/Date
35- SQLite (better-sqlite3) + Drizzle ORM, WAL mode
36- Zod v4 for external input validation
37- Namespace on all entities/relations: `'personal'` = local, project ID = synced
38- Vitest + in-memory SQLite (`:memory:`) for tests
39- Named exports, re-export from package `index.ts`
40- Workspace imports (`@second-brain/core`, `@second-brain/types`)
41- Strict mode, no `any`, no path aliases
42
43## Data Model
44
45- **15 entity types**: concept, decision, pattern, person, file, symbol, event, tool, fact, conversation, reference, pull_request, merge_request, branch, review
46- **20 relation types**: relates_to, depends_on, implements, supersedes, contradicts, derived_from, authored_by, decided_in, uses, tests, contains, co_changes_with, preceded_by, blocks, reviewed_by, merged_in_mr, merged_in_pr, touches_file, owns, parallel_with
47
48Defined in `packages/types/src/entity.ts` and `packages/types/src/relation.ts`.
49
50## Docs
51
52- [docs/architecture.md](./docs/architecture.md) — Full technical architecture
53- [docs/getting-started.md](./docs/getting-started.md) — Usage guide
54- [docs/api-reference.md](./docs/api-reference.md) — REST API + MCP + CLI reference
55
thangaram611/second-brain · CLAUDE.md
@@ +1 @@
1# CLAUDE.md
2
3Second Brain — a developer knowledge graph: shared engineering memory for teams ("git remembers the code; Second Brain remembers why"). pnpm monorepo, Turborepo, Node.js 24+, TypeScript 5.8+ strict, ESM only.
4
5All conventions, monorepo map, data model, architecture decisions, and common tasks are in [AGENTS.md](./AGENTS.md) (auto-loaded alongside this file).
6
7Deep-dive docs:
8- [docs/architecture.md](./docs/architecture.md) — Full technical architecture
9- [docs/getting-started.md](./docs/getting-started.md) — End-to-end usage guide
10- [docs/api-reference.md](./docs/api-reference.md) — REST API + MCP tools + CLI reference
11
@@ −1 +1 @@
1−# Second Brain — Agent Instructions
1+# CLAUDE.md
22
3−Developer knowledge graph — shared engineering memory for teams ("git remembers the code; Second Brain remembers why"). pnpm monorepo, Turborepo, Node.js 24+, TypeScript 5.8+ strict, ESM only.
3+Second Brain — a developer knowledge graph: shared engineering memory for teams ("git remembers the code; Second Brain remembers why"). pnpm monorepo, Turborepo, Node.js 24+, TypeScript 5.8+ strict, ESM only.
44
5−Each package/app has its own AGENTS.md with package-specific instructions.
5+All conventions, monorepo map, data model, architecture decisions, and common tasks are in [AGENTS.md](./AGENTS.md) (auto-loaded alongside this file).
66
7−## Monorepo Map
8−
9−```
10−packages/types → Shared TS types
11−packages/core → Graph engine (SQLite + Drizzle + FTS5 + sqlite-vec)
12−packages/collectors → Data collectors + streaming providers
13−packages/ingestion → LLM extraction + embedding pipeline
14−packages/sync → Yjs CRDT sync bridge
15−packages/mcp-server → MCP tools (32 tools, stdio + HTTP)
16−apps/server → Express 5 REST + WebSocket (:7430)
17−apps/ui → React 19 + Cytoscape.js + Zustand (:5173)
18−apps/relay → Hocuspocus CRDT relay (:7421)
19−tools/cli → brain CLI (Commander.js)
20−```
21−
22−## Commands
23−
24−```bash
25−pnpm install / build / test / check-types / lint / dev / clean
26−```
27−
28−Per-package: `cd <pkg> && pnpm test|build|dev`
29−
30−## Conventions
31−
32−- ESM only (`"type": "module"`), `.mjs`/`.d.mts` output, `tsdown` for builds
33−- ULIDs via `ulidx` for IDs — never UUID
34−- ISO 8601 strings for timestamps — never unix/Date
35−- SQLite (better-sqlite3) + Drizzle ORM, WAL mode
36−- Zod v4 for external input validation
37−- Namespace on all entities/relations: `'personal'` = local, project ID = synced
38−- Vitest + in-memory SQLite (`:memory:`) for tests
39−- Named exports, re-export from package `index.ts`
40−- Workspace imports (`@second-brain/core`, `@second-brain/types`)
41−- Strict mode, no `any`, no path aliases
42−
43−## Data Model
44−
45−- **15 entity types**: concept, decision, pattern, person, file, symbol, event, tool, fact, conversation, reference, pull_request, merge_request, branch, review
46−- **20 relation types**: relates_to, depends_on, implements, supersedes, contradicts, derived_from, authored_by, decided_in, uses, tests, contains, co_changes_with, preceded_by, blocks, reviewed_by, merged_in_mr, merged_in_pr, touches_file, owns, parallel_with
47−
48−Defined in `packages/types/src/entity.ts` and `packages/types/src/relation.ts`.
49−
50−## Docs
51−
7+Deep-dive docs:
528 - [docs/architecture.md](./docs/architecture.md) — Full technical architecture
53−- [docs/getting-started.md](./docs/getting-started.md) — Usage guide
54−- [docs/api-reference.md](./docs/api-reference.md) — REST API + MCP + CLI reference
9+- [docs/getting-started.md](./docs/getting-started.md) — End-to-end usage guide
10+- [docs/api-reference.md](./docs/api-reference.md) — REST API + MCP tools + CLI reference
5511
