brain-team-setup

Set up or reconfigure the team knowledge vault. The team vault is a git-backed directory that holds decisions, patterns, and gotchas shared across the team.

Steps

1. Read current config

cat ~/.claude/brain/config.json

If team is already configured, show current settings and ask:

"Team vault already configured. What would you like to do?

1. Update settings
2. Re-clone or reinitialize vault
3. Disable team mode
4. Exit"

2. Team vault configuration

Team name:

"Short team name (e.g. fiale-plus, used for identification):"

Team vault path:

"Team vault path? Default: ~/brain-team"

Create team repo on GitHub:

After team name is entered, suggest a naming convention and offer to create the repo:

"For a dedicated team brain repo, the convention is: <org>/<org>-brain (e.g., fiale-plus/fiale-plus-brain) <org>/<team>-brain (e.g., acme/platform-brain)

Create it now? [Y/n] (requires gh CLI + appropriate GitHub permissions)"

If Y and gh is available:

• Ask: "Repo name? (e.g., fiale-plus/fiale-plus-brain)" — pre-fill with <team_name>/<team_name>-brain
• Run: gh repo create <name> --private --description "Team knowledge vault"
• Use the returned clone URL as the git remote (skip the manual URL prompt below)

If N or gh not available:

• Continue to the manual URL prompt

Git remote URL:

"Git remote URL? (blank = local-only, no remote sharing)"

Skip this prompt if the GitHub repo was just created above.

Team repos for auto-routing:

Ask:

"How do you want to specify which repos route knowledge to the team vault?

1. Org folder — all repos under a directory (with optional exclude list) [default]
2. Discover — scan a folder and pick specific repos"

If option 1 (org folder):

• Ask: "Folder path? (e.g. ~/repos/fiale-plus/)"
• Run: find <folder> -maxdepth 1 -mindepth 1 -type d | sort and show discovered git repos (informational)
• Store as project_paths: ["<expanded_path>"] in config