---
name: add-team-source
description: >
  Register a git URL as a team-profile source so nyann can periodically
  sync and expose its profiles under a namespace.
  TRIGGER when the user says "add a team profile source", "register a
  team profile source", "set up team profiles from <url>", "wire up
  our team's shared profiles at <repo>", "add profile source named
  X at <url>", "install team profiles from <git repo>",
  "/nyann:add-team-source".
  Do NOT trigger on "sync team profiles now" (that's
  `sync-team-profiles` — the pull operation). Do NOT trigger on
  "save my setup as a profile" (that's `learn-profile` — writes to
  user root, not a team source). Do NOT trigger on generic "add a
  repo" or "add a remote" — those are git operations unrelated to
  profile distribution.
---

# add-team-source

Wraps `bin/add-team-source.sh`. Updates
`~/.claude/nyann/config.json` to declare a new team-profile source.
Idempotent — passing the same `--name` updates the entry in place.

## 1. Collect inputs

- **`--name <id>`** — required. Short slug, `^[a-z0-9][a-z0-9-]*$`.
  Will also become the namespace prefix for team profiles (e.g.
  `platform-team/base` when name is `platform-team`). When the user
  gives a name with spaces or caps, propose a slug and confirm.
- **`--url <git-url>`** — required. Any URL git can clone
  (https://, git@, file:// for testing).
- **`--ref <branch-or-tag>`** — default `main`. Override when the
  team pins a specific branch or tag.
- **`--interval <hours>`** — default `24`. How often
  `sync-team-profiles` will re-pull from this source without
  `--force`. Decrease only when the user says "we update these
  often" or similar.

## 2. Pre-flight

- Config path defaults to `~/.claude/nyann/config.json`. Override
  only when the user explicitly names a different user root.
- The backend upserts on `--name` collision. Warn the user if
  they're replacing an existing source with a different URL —
  that's usually unintentional. Read current config first if unsure.

## 3. Invoke

```
bin/add-team-source.sh \
  --name <id> \
  --url <git-url> \
  [--ref <branch>] \
  [--interval <hours>] \
  [--user-root <dir>]
```

Exit 0 on success; config path is logged to stderr.

## 4. Report back

- Name, URL, ref, interval.
- Tell the user "Run `/nyann:sync-team-profiles` (or ask 'sync my
  team profiles') to actually pull them". `add-team-source` only
  registers — the pull is a separate operation on purpose (no
  surprise network calls here).

## When to hand off

- "Now pull them" → `sync-team-profiles` skill.
- "Apply a team profile to this repo" → `bootstrap-project` with
  the namespaced profile name (e.g. `platform-team/base`).
- "Show what the team profile does" → `inspect-profile` with the
  namespaced name.