Run this file only once, immediately after cloning the CenterOS template.
If this operating system has already been initialized, do not run this process again. Check root LOG.md for a first-run setup entry before proceeding.
After this setup is complete, future AI sessions should start with BOOTSTRAP.md, not this file.
This file turns the generic CenterOS template into a personalized AI operating system. It gathers a small amount of setup information, replaces identity placeholders across the repo, and leaves the system ready for normal use.
Do not ask for secrets, passwords, API keys, private addresses, or anything the user would not want stored in local Markdown files.
Replace these identity tokens during first-run setup:
[AI_NAME]- the AI's chosen or assigned name. If the user does not want to name the AI, useCenterOS.[PRINCIPAL]- the user's name.[PRINCIPAL_NICKNAME]- what the AI should call the user in normal conversation.
Keep CenterOS when the text refers to the public template/framework itself, not this user's personalized instance.
Do not replace double-brace scaffold tokens such as {{WORKFLOW_NAME}}, {{WIKI_NAME}}, {{DATE}}, or {{TIMESTAMP}}. Those belong to reusable workflow and wiki templates.
Before asking questions, tell the user:
I’m going to ask a few setup questions so I can personalize this CenterOS install. You can answer each one as briefly or as fully as you want.
Ask these questions before making any changes. Ask one question at a time and wait for the user's answer before asking the next question. When asking each question, copy the full question exactly as written below, including examples. Do not shorten, summarize, paraphrase, or omit the examples.
- What is your name?
- What should your AI call you day to day?
- Do you want to name your AI? If yes, what name? If not, I’ll call the AI
CenterOS. - What is the main purpose of this operating system? Examples: business ops, personal knowledge base, writing system, household admin, research hub.
- How do you want the AI to communicate with you? Examples: direct, warm, terse, detailed, skeptical, creative.
- Are there any writing rules the AI should always follow? Examples: no em dashes, no corporate fluff, match my voice.
- Is there anything else you want me to know about you, or what you want my purpose to be?
- Read
SOUL.md,PRINCIPAL.md,BOOTSTRAP.md,AGENTS.md,CLAUDE.md,SYSTEM_INDEX.md, andmemory/CONTEXT.md. - Ask the questionnaire above one question at a time. Wait for the user's answer after each question before continuing to the next question. Copy each question exactly, including examples.
- Summarize the exact placeholder replacements you intend to make and wait for confirmation.
- Replace identity placeholders across Markdown files in this repo, except inside
.obsidian/if that directory exists. - Populate
SOUL.mdwith the AI name (defaultCenterOSunless the user names the AI), principal name, principal nickname, purpose, disposition, responsibilities, and production writing rules. - Populate
PRINCIPAL.mdwith the user's identity, work/life areas, operating preferences, and collaboration style. Leave unknown sections marked clearly as empty rather than guessing. - Update
SYSTEM_INDEX.mdwhere it describes this specific cloned instance. LeaveREADME.mdempty unless the user asks to create public GitHub-facing copy. - Search for unresolved identity placeholder tokens in Markdown files and report any that intentionally remain. Ignore double-brace scaffold tokens such as
{{WORKFLOW_NAME}}and{{WIKI_NAME}}. - Append a
modifiedentry to rootLOG.mdstating that first-run setup was completed. - Read
BOOTSTRAP.mdand load its operating context. Do not send the normal bootstrap greeting yet; continue to the startup completion message below. - Tell the user:
Startup complete. CenterOS is installed and ready to use.
To begin future sessions, tell me to read `BOOTSTRAP.md` and follow its instructions.
Would you like to create your first workflow? Just describe what you want it to do and I'll create it!
- Run once only.
- Do not guess. Ask when an answer is needed.
- Do not store secrets or credentials.
- Do not modify files in
.obsidian/. - Keep paths relative to the repo root in all file content.
- Preserve CenterOS as the template/framework name unless the sentence is clearly about the user's personalized operating system.
- After startup, use
BOOTSTRAP.mdfor every normal session.