memory

Structured markdown memory files for daily, weekly, monthly, and git logs. Outcome specs and branch review live under work (work:spec, work:audit).

Git Root Detection

Before running any command, detect the git root:

git rev-parse --show-toplevel

All paths (memory: config value, log files) are relative to git root.

Commands

Log Commands

Command	Description
init daily	Create today's daily memory file with start-of-day structure (called from daily start)
log daily	Write daily end log to <memory>/daily/YYYY-MM-DD.md
log weekly	Roll up weekly memory from daily files
log monthly	Roll up monthly memory from daily files
log git	Write git summary to <memory>/git/YYYY-MM-DD-GIT-N.md

Other

Command	Description
install	Create memory directories (daily, weekly, monthly, git, specs, learned)

$ARGUMENTS Routing

$ARGUMENTS	Action
help	→ commands/help.md
doctor	→ commands/doctor.md
init daily	→ commands/init/daily.md
log daily	→ commands/log/daily.md
log weekly	→ commands/log/weekly.md
log monthly	→ commands/log/monthly.md
log git	→ commands/log/git.md
install	→ commands/install.md
(empty)	→ commands/help.md

Bootstrap

If .groove/index.md does not exist, create from skills/groove/templates/index.md before proceeding.

If the memory: path does not exist, create the full directory structure:

mkdir -p <memory>/daily <memory>/weekly <memory>/monthly <memory>/git

File Structure

<memory>/              # default: .groove/memory/
├── daily/
│   └── YYYY-MM-DD.md
├── weekly/
│   └── YYYY-Www.md
├── monthly/
│   └── YYYY-MM.md
├── git/
│   └── YYYY-MM-DD-GIT-N.md
├── specs/
└── learned/

skills/memory/
├── SKILL.md
├── commands/
│   ├── log/
│   │   ├── daily.md
│   │   ├── weekly.md
│   │   ├── monthly.md
│   │   └── git.md
│   ├── init/
│   │   └── daily.md
│   └── install.md
└── templates/
    └── log/
        ├── daily.md
        ├── weekly.md
        ├── monthly.md
        └── git.md