groove-admin-config
Outcome
.groove/index.md is created or updated with values confirmed by the user. The git strategy is applied immediately. User is ready to run /groove-admin-install.
Acceptance Criteria
.groove/index.mdexists with all config keys populated- Each key was either confirmed by the user or accepted as default
- Git strategy is applied (
.groove/.gitignorewritten) before exiting - User is shown a summary of the final config and told to run
/groove-admin-install
Steps
If --defaults is passed: skip all prompts, apply all defaults, and proceed directly to writing the config (step 1 of "After all keys are confirmed"). Report the defaults being applied.
Otherwise, walk the user through each config key in order. For each key: show the current value (or default if new), explain what it does, and ask to confirm or change.
Keys and defaults
| Key | Default | Options | Question to ask | |||
|---|---|---|---|---|---|---|
tasks.storage | beans | `beans \ | linear \ | github \ | none` | "Which task backend? beans tracks tasks as markdown files in your repo." |
tasks.list_limit | 15 | positive integer | "Max tasks shown by task-list? (default: 15)" | |||
tasks.analyse_limit | 30 | positive integer | "Max tasks shown by task-analyse? (default: 30)" | |||
memory.review_days | 5 | positive integer | "How many recent business days to review at daily start? (default: 5)" | |||
git.memory | ignore-all | `ignore-all \ | hybrid \ | commit-all` | "Git strategy for memory logs? ignore-all keeps them local, hybrid commits logs but ignores sessions, commit-all commits everything." | |
git.tasks | ignore-all | `ignore-all \ | commit-all` | "Git strategy for task files (.groove/tasks/)? ignore-all keeps them local, commit-all tracks them in git." | ||
git.hooks | commit-all | `ignore-all \ | commit-all` | "Git strategy for hooks (.groove/hooks/)? commit-all shares hooks with the team, ignore-all keeps them local." | ||
groovebook | andreadellacorte/groovebook | <owner>/<repo> or blank | "Groovebook repo for sharing learnings? Default: andreadellacorte/groovebook. Leave blank to disable." |
After all keys are confirmed:
- Write
.groove/index.mdwith confirmed values andgroove-version: <installed version> - Apply git strategy — write
.groove/.gitignore(see constraints) - Show summary of written config
- Tell user: "Run
/groove-admin-installto install backends."
Constraints
- If
.groove/index.mdalready exists, pre-fill each question with the current value - Always write
groovebook:(defaultandreadellacorte/groovebook; blank = disabled). Memory path (.groove/memory/) and specs path (.groove/memory/specs/) are hardcoded — do not prompt for them. - If
--defaultsis passed, apply all defaults without any prompting — used bygroove-admin-installfor zero-friction first-time setup - If other arguments are provided (e.g.
tasks=linear git.memory=hybrid), apply them without prompting and use defaults for any unspecified keys - Always write
groove-version:matching the installed version fromskills/groove/SKILL.md
Git strategy → .groove/.gitignore
After writing .groove/index.md, generate .groove/.gitignore from the git.* sub-keys:
| Component | Strategy | Entry added to .groove/.gitignore |
|---|---|---|
git.memory | ignore-all | memory/ |
git.memory | hybrid | memory/sessions/ |
git.memory | commit-all | *(none)* |
git.tasks | ignore-all | tasks/ |
git.tasks | commit-all | *(none)* |
git.hooks | ignore-all | hooks/ |
git.hooks | commit-all | *(none)* |
Write the generated entries to .groove/.gitignore, replacing the file entirely. If no entries are generated (all commit-all), write an empty file with a comment: # groove git strategy: commit-all.
Always append these lines at the end of .groove/.gitignore, regardless of strategy:
# cache — always local
.cache/*
!.cache/.gitkeep- If
.groove/is listed in the root.gitignore, warn the user: "Note:.groove/is in your root.gitignore — any commit-all strategies require removing it." - Do not modify the root
.gitignoreautomatically — flag it for the user to resolve