phygital-brain 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "phygital-brain",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "A second brain that thinks with you. Builds a folder of notes that works as your knowledge base and as your agent's operating system, through four short forms, then keeps it tidy every day.",
5
5
  "author": {
6
6
  "name": "Phygital-Brain",
package/README.md CHANGED
@@ -7,8 +7,9 @@
7
7
  <p align="center">
8
8
  <a href="#open-source-and-credit"><img src="https://img.shields.io/badge/-open%20source-F05AB8" alt="Open source"></a>
9
9
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue" alt="License: Apache-2.0"></a>
10
- <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-0.1.0-5AC8FA" alt="Version 0.1.0"></a>
10
+ <a href="https://www.npmjs.com/package/phygital-brain"><img src="https://img.shields.io/npm/v/phygital-brain?color=5AC8FA" alt="npm version"></a>
11
11
  <a href="#quick-start"><img src="https://img.shields.io/badge/Claude-plugin-D97757?logo=anthropic&logoColor=white" alt="Claude plugin"></a>
12
+ <a href="docs/install.md"><img src="https://img.shields.io/badge/MCP-connector-F05AB8" alt="MCP connector"></a>
12
13
  <a href="CONTRIBUTING.md"><img src="https://img.shields.io/badge/PRs-welcome-5AC8FA" alt="Pull requests welcome"></a>
13
14
  </p>
14
15
  <p align="center">
@@ -18,11 +19,11 @@
18
19
  <a href="#languages"><img src="https://img.shields.io/badge/languages-11%20ready%20%C2%B7%20add%20yours-0B0D12?labelColor=5AC8FA" alt="11 languages ready, add yours"></a>
19
20
  <a href="SECURITY.md#what-you-share-with-your-ai"><img src="https://img.shields.io/badge/telemetry-none-0B0D12?labelColor=F05AB8" alt="No telemetry"></a>
20
21
  </p>
21
- <!-- Turn these on when the repository is public (GitHub can't show them for a private repository):
22
+ <p align="center">
22
23
  <a href="https://github.com/Phygital-Brain/phygital-brain/stargazers"><img src="https://img.shields.io/github/stars/Phygital-Brain/phygital-brain?style=flat" alt="GitHub stars"></a>
23
24
  <a href="https://github.com/Phygital-Brain/phygital-brain/commits/main"><img src="https://img.shields.io/github/last-commit/Phygital-Brain/phygital-brain" alt="Last commit"></a>
24
- <a href="https://github.com/Phygital-Brain/phygital-brain/releases/latest"><img src="https://img.shields.io/github/v/release/Phygital-Brain/phygital-brain" alt="Latest release"></a>
25
- -->
25
+ <a href="https://www.npmjs.com/package/phygital-brain"><img src="https://img.shields.io/npm/dm/phygital-brain" alt="npm downloads per month"></a>
26
+ </p>
26
27
 
27
28
  <p align="center">
28
29
  <a href="#what-it-is">What it is</a> ·
@@ -171,9 +172,9 @@ You need an AI agent that can work in a folder, a cloud drive your agent can con
171
172
  <p align="center">
172
173
  <a href="https://github.com/Phygital-Brain/phygital-brain/releases/latest/download/phygital-brain.mcpb"><img src="docs/images/buttons/claude-desktop.png" width="240" alt="Add to Claude desktop"></a>
173
174
  <a href="docs/install.md#claude-code"><img src="docs/images/buttons/claude-code.png" width="240" alt="Install in Claude Code"></a>
174
- <a href="https://cursor.com/en/install-mcp?name=phygital-brain&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImdpdGh1YjpQaHlnaXRhbC1CcmFpbi9waHlnaXRhbC1icmFpbiJdfQ=="><img src="docs/images/buttons/cursor.png" width="240" alt="Add to Cursor"></a>
175
+ <a href="https://cursor.com/en/install-mcp?name=phygital-brain&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInBoeWdpdGFsLWJyYWluIl19"><img src="docs/images/buttons/cursor.png" width="240" alt="Add to Cursor"></a>
175
176
  <br>
176
- <a href="https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522phygital-brain%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522github%253APhygital-Brain%252Fphygital-brain%2522%255D%257D"><img src="docs/images/buttons/vscode.png" width="240" alt="Add to VS Code"></a>
177
+ <a href="https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522phygital-brain%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522phygital-brain%2522%255D%257D"><img src="docs/images/buttons/vscode.png" width="240" alt="Add to VS Code"></a>
177
178
  <a href="docs/install.md#codex"><img src="docs/images/buttons/codex.png" width="240" alt="Set up in Codex"></a>
178
179
  <a href="docs/install.md#hermes-agent-and-openclaw"><img src="docs/images/buttons/other-agents.png" width="240" alt="Set up in Hermes Agent or OpenClaw"></a>
179
180
  </p>
@@ -184,9 +185,9 @@ You need an AI agent that can work in a folder, a cloud drive your agent can con
184
185
  npx skills add Phygital-Brain/phygital-brain
185
186
  ```
186
187
 
187
- It asks which of your agents to add it to. Needs Node.js.
188
+ It asks which of your agents to add it to. Claude desktop and Claude Code need nothing more. The other ways need [Node.js](https://nodejs.org), a free one-time install.
188
189
 
189
- Every way, step by step, and for other agents: [Install](docs/install.md).
190
+ Every way, step by step: [Install](docs/install.md).
190
191
 
191
192
  ```mermaid
192
193
  flowchart LR
@@ -238,7 +239,7 @@ Phygital Brain is ready in **11 languages**. Pick yours at the start of the setu
238
239
  | Deutsch (German) | Profil, Tagebuch, Projekte |
239
240
  | 日本語 (Japanese) | プロフィール, 日記, プロジェクト |
240
241
 
241
- **Your language isn't here?** Any other language still works: your agent translates the forms and messages as it goes, and the folders keep English names. To make a full set for your language, with translated folders, say:
242
+ **Your language isn't here?** Pick Other and type it. Your agent translates the whole brain during the setup, folder names included, without asking you anything. To make a checked set that everyone who speaks your language can use, say:
242
243
 
243
244
  > Translate Phygital Brain into my language.
244
245
 
@@ -270,9 +271,17 @@ Your notes are read by your AI agent and stored in your cloud drive. Phygital Br
270
271
  The full list is in [Limits](docs/limits.md).
271
272
 
272
273
  - **No app.** There's nothing to run. Your AI agent does the work, following the files in this repository.
273
- - **No lock.** The rules work only because your agent follows them. Keep truly secret things outside the brain folder.
274
+ - **No lock yet.** The rules work only because your agent follows them. Keep truly secret things outside the brain folder. Locked folders are on the [roadmap](#roadmap).
274
275
  - **Not always on, unless you move it to the cloud.** On your computer, the Brain Keeper and the morning brief run only while your agent's app is open. As a cloud routine, they run with the computer off.
275
- - **An early version.** This is version 0.1.0, and the setup hasn't been tested with many people yet.
276
+ - **An early version.** This is version 0.1.2, and the setup hasn't been tested with many people yet.
277
+
278
+ ## Roadmap
279
+
280
+ Planned, not built yet:
281
+
282
+ - **Locked folders.** You choose which folders to lock, like `Memory/finances/`. Their notes are encrypted in your drive, so no app or agent can read them without you. You unlock them with your password or fingerprint, from the agent you already use, and only for what you approve.
283
+
284
+ Ideas are welcome: open an issue on GitHub.
276
285
 
277
286
  ## Updating and leaving
278
287
 
@@ -325,7 +334,7 @@ Phygital Brain is free and open source. You pay for your AI agent and, if you ne
325
334
  | [Install](docs/install.md) | One click for Claude desktop, Cursor and VS Code, and steps for Claude Code, Codex, Hermes Agent, OpenClaw and others |
326
335
  | [Getting started](docs/getting-started.md) | Every step from nothing to a working brain, with checks and fixes |
327
336
  | [Connect your apps](docs/connect-your-apps.md) | Gmail, Calendar, Drive and other services, read only, and running fully online |
328
- | [Add more skills](docs/add-skills.md) | Adding any skill to your brain, and making videos with HyperFrames and Keyframes |
337
+ | [Add more skills](docs/add-skills.md) | Adding any skill to your brain, making videos with [HyperFrames](https://github.com/heygen-com/hyperframes) and editing images with [PhotoCraft](https://github.com/storytold/photocraft) |
329
338
  | [Teams](docs/teams.md) | Sharing one brain through Baalda's cloud |
330
339
  | [Bringing in your old notes](docs/importing.md) | Exporting from Notion, Google Docs, Apple Notes and others, and filing it all |
331
340
  | [Example brain](docs/example-brain/README.md) | A few made-up notes, so you can see the files before you build yours |
@@ -352,7 +361,8 @@ Phygital Brain is free and open source. You pay for your AI agent and, if you ne
352
361
  | `scripts/` | The checks to run before a change (`python3 scripts/check.py`) |
353
362
  | `.claude-plugin/` | The plugin files, for installing it in Claude |
354
363
  | `mcp/` | The connector (an MCP server, no dependencies) for agents that take MCP servers |
355
- | `package.json` | Lets `npx` run the connector straight from GitHub |
364
+ | `package.json` | The npm package, so `npx -y phygital-brain` runs the connector |
365
+ | `.github/workflows/` | Releases each new version: npm, and the GitHub release with the Claude desktop file |
356
366
 
357
367
  <p align="center"><img src="docs/images/ownership.png" alt="Your notes. Any AI. It remembers you. Your brain folder in your drive, plain text and yours, sits in the middle, linked to Claude, Codex, Hermes Agent, OpenClaw, Cursor and the next AI you pick. Switch to another AI any time: it reads the same notes, so you never start over. Free and open source." width="100%"></p>
358
368
 
package/mcp/server.mjs CHANGED
@@ -6,7 +6,7 @@
6
6
  // this package's own skills/ folder and never touches the person's files: the agent writes
7
7
  // the brain with its own file tools, in the folder the person chose.
8
8
  //
9
- // Run it with: npx -y github:Phygital-Brain/phygital-brain
9
+ // Run it with: npx -y phygital-brain
10
10
 
11
11
  import { readFileSync, readdirSync, statSync, existsSync } from "node:fs";
12
12
  import { dirname, join, normalize, relative, sep } from "node:path";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "phygital-brain",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "A second brain that thinks with you. The Phygital Brain connector: an MCP server that gives your agent the setup, forms, templates and Brain Keeper.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -5,7 +5,7 @@ description: Make a full Phygital Brain set in a new language (forms, rule files
5
5
 
6
6
  # Phygital Brain: Add a language
7
7
 
8
- Version 0.1.0. Everything below is for the agent. Follow it step by step, and check each step before moving on.
8
+ Version 0.1.2. Everything below is for the agent. Follow it step by step, and check each step before moving on.
9
9
 
10
10
  Two jobs:
11
11
 
@@ -5,7 +5,7 @@ description: Set up, update, pause or run the Brain Keeper, which looks after a
5
5
 
6
6
  # Phygital Brain: Brain Keeper
7
7
 
8
- Version 0.1.0. Everything below is for the agent. Follow it step by step, and check each step before moving on.
8
+ Version 0.1.2. Everything below is for the agent. Follow it step by step, and check each step before moving on.
9
9
 
10
10
  The Brain Keeper looks after the brain in two ways:
11
11
 
@@ -14,7 +14,7 @@ The Brain Keeper looks after the brain in two ways:
14
14
 
15
15
  Templates, in this skill's folder: `templates/daily.md`, `templates/check-up.md`, `templates/queue.md`, `templates/root-CLAUDE-section.md`.
16
16
 
17
- **Language:** if the root `CLAUDE.md` has a `## Folder map` and the brain's language has a ready set (`../brain-setup/i18n/{code}/keeper/`, code from the version line), use those templates instead, and the brain's own folder and note names for every path in this file. Otherwise use the English templates and write in the brain's language.
17
+ **Language:** if the root `CLAUDE.md` has a `## Folder map` and the brain's language has a ready set (`../brain-setup/i18n/{code}/keeper/`, code from the version line), use those templates instead, and the brain's own folder and note names for every path in this file. If it has a `## Folder map` but no ready set, translate the English templates as you write them, following `../brain-setup/translating.md`, with the brain's names from the Folder map (choose any missing ones the same way, without asking). With no Folder map, use the English templates and write in the brain's language.
18
18
 
19
19
  **Called from the brain setup** (`../brain-setup/SKILL.md` 3.8): start at Step 2 with the run time and fix mode the setup gives you, skip Step 1, and skip Step 5 (the setup's finish message covers it).
20
20
 
@@ -5,7 +5,7 @@ description: Build a Phygital Brain second brain in the selected folder through
5
5
 
6
6
  # Phygital Brain: Setup
7
7
 
8
- Version 0.1.0. Everything below is for the agent. Follow it step by step, and check each step before moving on.
8
+ Version 0.1.2. Everything below is for the agent. Follow it step by step, and check each step before moving on.
9
9
 
10
10
  ## What you are building
11
11
 
@@ -60,7 +60,7 @@ Ask one question with click options, in the language of their first message (Eng
60
60
 
61
61
  `English` (en) · `中文` (zh-CN) · `हिन्दी` (hi) · `Español` (es) · `العربية` (ar) · `Français` (fr) · `Português (Brasil)` (pt-BR) · `Русский` (ru) · `Bahasa Indonesia` (id) · `Deutsch` (de) · `日本語` (ja) · Other
62
62
 
63
- If the click tool takes only 4 options, offer the 3 most likely from their first message plus Other, and accept any of the names above typed in.
63
+ If the click tool takes only 4 options, offer the 3 most likely from their first message plus Other. A ready language typed in counts the same as a click, whether they type its own name, its English name (German, Japanese) or its code (de, ja).
64
64
 
65
65
  ### A ready language (a folder `i18n/{code}/` exists in this skill)
66
66
 
@@ -74,7 +74,12 @@ The brain is built fully in that language, once, from files that are already tra
74
74
 
75
75
  ### Any other language
76
76
 
77
- Use the English `forms/` and `templates/`, and translate as you go: before showing a form, translate only the text people see (questions, option labels, placeholders, the header and the buttons). Write every message and note in their language. Folder and note names stay in English, and no Folder map is needed. Say once: "Your brain's folders will have English names. To make a full set for your language, say 'translate Phygital Brain into my language'."
77
+ The brain is still built fully in their language, folder and note names included. You translate it yourself, while you build it, following `translating.md` in this skill's folder: read it now. Don't ask anything about the translation; choose every word yourself.
78
+
79
+ - **Forms, templates and messages:** use the English `forms/` and `templates/`, and translate each one as `translating.md` says.
80
+ - **Brain Keeper:** pass the English `../brain-keeper/templates/` to the Brain Keeper (3.8), and tell it to translate them the same way, with your names.
81
+ - **Folder map:** add it at the end of the root `CLAUDE.md`, as `translating.md` says.
82
+ - **In the finish message** (Step 4), add one line: "Your agent translated your brain during the setup. To make a checked set that others can use too, say 'translate Phygital Brain into my language'."
78
83
 
79
84
  ### In every language
80
85
 
@@ -314,7 +319,7 @@ When Step 0 found an older Phygital Brain and they picked `Upgrade my brain`.
314
319
  - Keep their own routing rows, folders and anything else they wrote that isn't in the templates.
315
320
  - Never rewrite notes to new info blocks. Old notes get them the next time they're edited.
316
321
  - Replace the version line at the top of the root `CLAUDE.md` with this skill's version: `<!-- Phygital Brain, version X, language: {lang} -->`.
317
- - **Folder names.** If the root `CLAUDE.md` has a `## Folder map`, use it for every path in the new templates, and the matching `i18n/{code}/` set if one exists. Add map rows for any new folders or notes in this version (from `i18n/{code}/strings.json`, or ask once what to call them).
322
+ - **Folder names.** If the root `CLAUDE.md` has a `## Folder map`, use it for every path in the new templates, and the matching `i18n/{code}/` set if one exists. Add map rows for any new folders or notes in this version: from `i18n/{code}/strings.json`, or, with no ready set, choose the names yourself following `translating.md`. With no ready set, translate the new parts the same way.
318
323
  - **Brain Keeper.** Update it (follow `../brain-keeper/SKILL.md`, its Step 0.4 keeps `queue.md` and the reports). If it isn't installed, install it from its Step 1.
319
324
  6. **Check:** the same number of their own rules as in step 2, word for word; every check in 3.9 that applies; nothing deleted.
320
325
  7. **Finish:** one line in today's daily note, then 2 or 3 lines on what changed.
@@ -6,7 +6,7 @@
6
6
  - Rule 12: write their style choice from form 1 into it (for example, "By default: detailed explanations" if they picked `Detailed`).
7
7
  -->
8
8
 
9
- <!-- Phygital Brain, version 0.1.0, language: {lang} -->
9
+ <!-- Phygital Brain, version 0.1.2, language: {lang} -->
10
10
 
11
11
  # العقل الثاني لـ{Name}
12
12
 
@@ -6,7 +6,7 @@
6
6
  - Rule 12: write their style choice from form 1 into it (for example, "By default: detailed explanations" if they picked `Detailed`).
7
7
  -->
8
8
 
9
- <!-- Phygital Brain, version 0.1.0, language: {lang} -->
9
+ <!-- Phygital Brain, version 0.1.2, language: {lang} -->
10
10
 
11
11
  # Das zweite Gehirn von {Name}
12
12
 
@@ -6,7 +6,7 @@
6
6
  - Rule 12: write their style choice from form 1 into it (for example, "By default: detailed explanations" if they picked `Detailed`).
7
7
  -->
8
8
 
9
- <!-- Phygital Brain, version 0.1.0, language: {lang} -->
9
+ <!-- Phygital Brain, version 0.1.2, language: {lang} -->
10
10
 
11
11
  # El segundo cerebro de {Name}
12
12
 
@@ -6,7 +6,7 @@
6
6
  - Rule 12: write their style choice from form 1 into it (for example, "By default: detailed explanations" if they picked `Detailed`).
7
7
  -->
8
8
 
9
- <!-- Phygital Brain, version 0.1.0, language: {lang} -->
9
+ <!-- Phygital Brain, version 0.1.2, language: {lang} -->
10
10
 
11
11
  # Le second cerveau de {Name}
12
12
 
@@ -6,7 +6,7 @@
6
6
  - Rule 12: write their style choice from form 1 into it (for example, "By default: detailed explanations" if they picked `Detailed`).
7
7
  -->
8
8
 
9
- <!-- Phygital Brain, version 0.1.0, language: {lang} -->
9
+ <!-- Phygital Brain, version 0.1.2, language: {lang} -->
10
10
 
11
11
  # {Name} का सेकंड ब्रेन
12
12
 
@@ -6,7 +6,7 @@
6
6
  - Rule 12: write their style choice from form 1 into it (for example, "By default: detailed explanations" if they picked `Detailed`).
7
7
  -->
8
8
 
9
- <!-- Phygital Brain, version 0.1.0, language: {lang} -->
9
+ <!-- Phygital Brain, version 0.1.2, language: {lang} -->
10
10
 
11
11
  # Otak Kedua {Name}
12
12
 
@@ -6,7 +6,7 @@
6
6
  - Rule 12: write their style choice from form 1 into it (for example, "By default: detailed explanations" if they picked `Detailed`).
7
7
  -->
8
8
 
9
- <!-- Phygital Brain, version 0.1.0, language: {lang} -->
9
+ <!-- Phygital Brain, version 0.1.2, language: {lang} -->
10
10
 
11
11
  # {Name}さんのセカンドブレイン
12
12
 
@@ -6,7 +6,7 @@
6
6
  - Rule 12: write their style choice from form 1 into it (for example, "By default: detailed explanations" if they picked `Detailed`).
7
7
  -->
8
8
 
9
- <!-- Phygital Brain, version 0.1.0, language: {lang} -->
9
+ <!-- Phygital Brain, version 0.1.2, language: {lang} -->
10
10
 
11
11
  # Segundo Cérebro de {Name}
12
12
 
@@ -6,7 +6,7 @@
6
6
  - Rule 12: write their style choice from form 1 into it (for example, "By default: detailed explanations" if they picked `Detailed`).
7
7
  -->
8
8
 
9
- <!-- Phygital Brain, version 0.1.0, language: {lang} -->
9
+ <!-- Phygital Brain, version 0.1.2, language: {lang} -->
10
10
 
11
11
  # Второй мозг: {Name}
12
12
 
@@ -6,7 +6,7 @@
6
6
  - Rule 12: write their style choice from form 1 into it (for example, "By default: detailed explanations" if they picked `Detailed`).
7
7
  -->
8
8
 
9
- <!-- Phygital Brain, version 0.1.0, language: {lang} -->
9
+ <!-- Phygital Brain, version 0.1.2, language: {lang} -->
10
10
 
11
11
  # {Name} 的第二大脑
12
12
 
@@ -6,7 +6,7 @@
6
6
  - Rule 12: write their style choice from form 1 into it (for example, "By default: detailed explanations" if they picked `Detailed`).
7
7
  -->
8
8
 
9
- <!-- Phygital Brain, version 0.1.0, language: {lang} -->
9
+ <!-- Phygital Brain, version 0.1.2, language: {lang} -->
10
10
 
11
11
  # {Name}'s Second Brain
12
12
 
@@ -0,0 +1,62 @@
1
+ # Translating during the setup
2
+
3
+ For a language with no ready set in `i18n/`. You translate the whole brain yourself, once, while you build it. Don't ask the person anything about the translation: choose every word yourself, following these rules. The brain then reads only its own files, already in their language.
4
+
5
+ ## 1. Choose the names first
6
+
7
+ Before the first form, choose a name in their language for every English name in the list at the end of this file. Write the list down for yourself and use exactly the same spelling in every file you write, so every path and `[[link]]` matches.
8
+
9
+ - Short, everyday words a person would use for that folder. Not a dictionary translation if people say it differently.
10
+ - Safe as file names on Mac, Windows and phones: no `/ \ : * ? " < > |`, no spaces at the start or end. Letters with accents and non-Latin scripts are fine. Use the NFC form (composed letters).
11
+ - The 7 top folders start with a capital letter where the language has capitals. Subfolders and note names are lowercase where the language has case, with hyphens between words.
12
+ - One name per idea: `research` is the same word in Projects and in Memory.
13
+ - Two names keep their marks: `_Leads` keeps the `_` at the start, and `PAUSED` stays in capitals where the language has them.
14
+ - Every name is different from the others in the same folder.
15
+
16
+ Choose the feature names too, the same way: Brain Keeper, morning brief, meeting prep, thinking tools, check-up, Writing Check and second brain. Phygital Brain stays in English.
17
+
18
+ ## 2. What you translate
19
+
20
+ - **Forms:** before you show each form, the text people see: questions, option labels, placeholders, the header and the buttons.
21
+ - **Messages:** everything you say during the setup.
22
+ - **Files:** every file you write from `templates/`, and the Brain Keeper's files from `../brain-keeper/templates/`, as you write them. Swap every English brain path for your names: `About/me.md`, `Skills/brain-keeper/daily.md`, `[[goals]]`, `` `Projects` ``.
23
+
24
+ ## 3. What stays English
25
+
26
+ - The file names `CLAUDE.md`, `README.md` and `.claudeignore`, and the `.backups/` and `Skills/no-ai-slop/` folders, and everything inside `no-ai-slop/`.
27
+ - Placeholders in curly braces until you fill them in: `{Name}`, `{Time zone}`, `{name}`, `{title}` and the rest.
28
+ - Info blocks (the lines between `---`): keys and values (`type: daily`, `status: active`, `day: Monday`, every tag). Only the `description:` sentence is translated.
29
+ - YAML and other code examples, and every `data-name` and `data-value` in the forms.
30
+ - Names the person gives (their projects, people, companies), exactly as they wrote them.
31
+
32
+ ## 4. Trigger phrases
33
+
34
+ Sentences a person says to their agent, in quotes, like "check up my brain" or "prep me for {name}". Write what a person would naturally say in their language, then keep the English one after it, so both work: `"{in their language}", "check up my brain", or the same in {Language}`.
35
+
36
+ ## 5. Writing
37
+
38
+ - Natural, everyday speech. Adapt, don't translate word for word. If a native speaker wouldn't say a sentence that way, rewrite it.
39
+ - About an 8th-grade reading level. Plain and clear, never childish.
40
+ - One register all through: what popular consumer apps in that language use, often the informal "you".
41
+ - "your agent", never a product name, in anything a person sees.
42
+ - No long dashes (the em dash). Use periods, commas, colons or parentheses.
43
+ - Keep every fact, rule, number and step. Don't add or remove rules.
44
+
45
+ ## 6. Folder map
46
+
47
+ At the end of the root `CLAUDE.md`, add a `## Folder map` section, the same as a ready language gets: a two-column table, English name and the brain's name, for every name in the list below, with one line above it: "For Phygital Brain upgrades and skills only. Daily work uses the names in this brain." Write that line and the heading in their language. This is the only place the English names appear in the brain.
48
+
49
+ ## 7. Check
50
+
51
+ Before the setup's own checks (3.9):
52
+
53
+ - No English name from the list is left in a path or `[[link]]`, outside the Folder map and the things that stay English.
54
+ - Every `[[link]]` and path points to a name in your list, spelled the same.
55
+ - Every folder you named in a `CLAUDE.md` exists.
56
+
57
+ ## The names
58
+
59
+ These are every folder and note name a new brain can have.
60
+
61
+ - **Top folders:** `About`, `Daily`, `Projects`, `Relationships`, `Memory`, `Library`, `Skills`
62
+ - **Subfolders and notes:** `Clients`, `Collaborators`, `Team`, `Partners`, `decisions`, `research`, `finances`, `archive`, `applications`, `competitors`, `notes`, `briefs`, `drafts`, `ideas`, `feedback`, `assets`, `prompts`, `templates`, `frameworks`, `brain-keeper`, `morning-brief`, `meeting-prep`, `thinking`, `import`, `connected-apps`, `reports`, `me`, `goals`, `business`, `services`, `customers`, `pain-points`, `brand`, `tools`, `cv`, `biography`, `tasks`, `_Leads`, `daily`, `check-up`, `queue`, `PAUSED`