# Install Guide — AI‑Chats Memory Pack Drop these files into your **repo root**, then: ```bash chmod +x scripts/*.sh # Optional: install commitlint + husky npm i -D @commitlint/cli @commitlint/config-conventional husky npx husky install npx husky add .husky/commit-msg 'npx --no -- commitlint --edit "$1"' ``` ## Files & Folders - `.traycer/PLAYBOOK.md` — repo‑level fallback memory (read on task start) - `templates/_bootstrap/{PLAYBOOK.md,HANDOFF.md,COMMIT_TEMPLATE.md}` — session seeding templates - `scripts/ai-chats-session.sh` — creates/reuses today’s session folder and seeds `_bootstrap/` + `--00.md` - `scripts/ai-chats-bootstrap.sh` — ensures `.traycer` + seeds the current session’s `_bootstrap/` - `.vscode/tasks.ai-chats.json` — VS Code tasks you can merge into `.vscode/tasks.json` - `commitlint.config.cjs` — Conventional Commits config (optional but recommended) ## VS Code - If you already have `.vscode/tasks.json`, **merge** the tasks from `.vscode/tasks.ai-chats.json` into it. - Otherwise, you can rename it to `.vscode/tasks.json`. ## .gitignore Ensure `ai-chats/` is **NOT** ignored so the documentation history is committed. Add (or verify) these lines: ```gitignore # AI-Chats documentation should be committed !ai-chats/ !ai-chats/**/* ``` ## Quick Start 1) Run: `./scripts/ai-chats-session.sh repo-deep-dive` → prints `ai-chats/YYYY-MM-DD-XX-repo-deep-dive` 2) In Traycer, use that path for `{SESSION_FOLDER_PATH}` and run your Deep Dive task. 3) When Traycer proposes handoffs, paste `_bootstrap/HANDOFF.md` as the preface. 4) After each verified step, use `_bootstrap/COMMIT_TEMPLATE.md` to craft the commit and commit ai‑chats updates (+ any relevant source changes that already exist and pass checks). ## Safety - Assistants write **only** under `ai-chats/**`. - Source code changes must be proposed as diffs/snippets unless a human or another tool has already made them. - Every step ends with a verified commit and is recorded under `--00.md > Commits`.