ai-memory-setuplisted
Install: claude install-skill fabioc-aloha/Alex_ACT_Edition
# AI-Memory Setup
Alex_ACT_Memory is a shared git repo (sibling clone at `../Alex_ACT_Memory`) where ACT heirs exchange feedback, announcements, knowledge, and profile data. This skill covers resolution, bootstrapping, and ongoing read/write operations.
## Resolution Algorithm (3-state)
The `_registry.cjs` script resolves the memory bus in this order:
1. **Sibling exists**: `../Alex_ACT_Memory/.git` is present → use it, pull updates (best-effort)
2. **Clone from remote**: sibling absent, remote URL configured → `git clone`
3. **Scaffold**: clone fails or no remote → create minimal local repo
Resolution always succeeds (scaffold is the floor). Heirs never need to configure cloud drives or pin paths.
## Folder Structure
```text
../Alex_ACT_Memory/
README.md
announcements/ # Fleet-wide release notes and guidance
README.md
feedback/ # Heir friction reports
README.md
knowledge/ # Shared knowledge packages
index.json
README.md
profile/ # Per-user profiles
default/README.md
<username>/user-profile.json
insights/ # Analytical insights
docs/
MIGRATION.md # OneDrive → git migration guide
```
## Operations
### Detect (session start)
On every session start, resolve the memory bus via `resolveMemoryBus(repoRoot)`. If found:
1. Check `announcements/` for unread files
2. Report any new announcements to the user (one line each)
3. Do NOT read or report feedback