update-cog

1# COG Update Skill
2 
3## Purpose
4Help the user update their COG framework files (skills, documentation, scripts) from the official upstream repository without risking their personal content (braindumps, profiles, notes).
5 
6## When to Invoke
7- User asks to "update COG", "check for updates", or "get latest COG version"
8- User mentions wanting new skills or features from upstream
9- User asks about their COG version
10 
11## Process Flow
12 
13### 1. Check Current Version
14Read `COG-VERSION` from the vault root. If it doesn't exist, inform the user they may be on an older version that predates version tracking.
15 
16### 2. Ensure Upstream Remote
17```bash
18# Add the upstream remote if not already present
19git remote get-url cog-upstream 2>/dev/null || \
20  git remote add cog-upstream https://github.com/huytieu/COG-second-brain.git
21 
22# Fetch latest
23git fetch cog-upstream main --quiet
24```
25 
26### 3. Compare Versions
27```bash
28# Local version
29cat COG-VERSION
30 
31# Upstream version
32git show cog-upstream/main:COG-VERSION
33```
34 
35If versions match, tell the user they're up to date.
36 
37### 4. Show What Changed
38For each framework file, compare local vs upstream:
39```bash
40git diff HEAD..cog-upstream/main -- <file>
41```
42 
43**Framework files** (safe to update — never contain user content):
44- Core docs: `README.md`, `SETUP.md`, `AGENTS.md`, `GEMINI.md`, `CHANGELOG.md`, `CONTRIBUTING.md`
45- Skills: `.claude/skills/*/SKILL.md`
46- Powers: `.kiro/powers/*/POWER.md`
47- Gemini: `.gemini/commands/*.toml`, `.gemini/skills/*.md`
48…