ai-memory-setuplisted
Install: claude install-skill fabioc-aloha/Alex_ACT_Edition
# AI-Memory Setup
Alex_ACT_Memory is a local-first repo (sibling clone at `../Alex_ACT_Memory`) where ACT heirs exchange feedback, announcements, knowledge, and optional encrypted profile data. A remote is optional and sharing is the user's decision. This skill covers resolution, bootstrapping, and ongoing read/write operations.
## Resolution Modes
`resolveMemoryBus(repoRoot)` is read-only by default: it returns the existing
`../Alex_ACT_Memory` sibling or `null`. It does not pull, clone, or scaffold.
Explicit setup callers may pass `{ mutate: true }`, enabling this sequence:
1. **Sibling exists**: use it and pull updates (best-effort)
2. **Clone from remote**: sibling absent and remote configured → `git clone`
3. **Scaffold**: clone fails or no remote → create a minimal local repo
The mutation gate preserves user control. Session checks do not create a remote,
clone, scaffold, or pull merely because Memory was mentioned.
## 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/ # Protected encrypted profiles
<username>/user-profile.encrypted.json
insights/ # Analytical insights
docs/
MIGRATION.md # OneDrive → git migration guide
```
## Operations
### Detect (session start)