메뉴
Pull the latest framework version from upstream, rebuild Docker if needed, rebuild the listener, and restart PM2. Use when the user says "update framework", "update", "pull updates", "upgrade", or asks if there's a new version.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
First-run setup for ginnie-agents — verifies prerequisites, asks the user to pick an auth mode (subscription OAuth or Anthropic API key) and configures it, scaffolds .env, installs git hooks, builds the Docker image, builds the listener, and starts PM2. Use when the user clones the repo and says "set up", "set me up", "first run", "install", or invokes this directly.
Canonical schema and workflow for editing your own scheduled routines (./schedules.json). The listener watches the file and hot-reloads on save. Invalid entries are silently rejected by the scheduler — get the schema right or your routine will never fire.
Create a new ginnie-agents agent end-to-end — generates files from the template, walks the user through Slack app creation, sets up credentials, registers in the team directory, and restarts the listener. Use when the user says "create agent", "new agent", "add agent", or names an agent role to build (e.g. "build me a sales agent").
Health check for ginnie-agents — verifies prerequisites, environment, hooks, listener, Docker image, agents, memory caps, and disk. Use when the user says "doctor", "health check", "check setup", "is everything ok", or after running setup/update.
Set up the Watcher — a long-running daemon (not an AI agent) that monitors framework health (token expiry, framework updates, PM2 listener state, disk, memory caps) and DMs the operator on Slack with interactive buttons (Update now / Restart / Ack). Use when the user says "set up watcher", "set up the watcher", "install watcher", "watchdog", "monitor framework", "alert me if something breaks", "/watcher".
Tail, search, or download logs for the listener and individual agents. Use when the user says "show logs", "tail logs", "what did agent X do", "search logs for X", "download logs", or is debugging agent behavior.
| name | update-framework |
| description | Pull the latest framework version from upstream, rebuild Docker if needed, rebuild the listener, and restart PM2. Use when the user says "update framework", "update", "pull updates", "upgrade", or asks if there's a new version. |
User content (agents/, shared/, config/, .env) is never touched by git pull because it lives in directories the framework doesn't write to. This skill performs the predictable update sequence safely.
Run from repo root.
git fetch
git log HEAD..origin/main --oneline
If no new commits, tell the user "Already up to date" and stop.
If commits exist, summarize them (subjects only, max 10 lines) and ask the user to confirm before proceeding. Look for words like BREAKING: or MIGRATION: in commit messages — flag those prominently.
git status --porcelain -- listener/ docker/ framework/ scripts/ templates/ .claude/skills/
If output is non-empty, the user has local changes to framework code. Ask: do they want to (a) stash, (b) commit first, or (c) abort? Don't pull on top of dirty framework state — merge conflicts in framework code are confusing.
User content (agents/, shared/, config/, .env) appearing in git status is fine — the pull won't touch those.
git pull --ff-only origin main
If --ff-only fails (their main has diverged from origin), surface it. Don't auto-merge; let the user decide.
# Compare what changed against the previous HEAD (saved by git pull's reflog)
git diff --name-only HEAD@{1} HEAD
Decide:
docker/ or framework/skills/ changed → rebuild imagelistener/ changed → rebuild listenerdocker build -t ginnie-agent -f docker/Dockerfile .
cd listener && npm install && npm run build && cd ..
If the changes touched listener/package.json, npm install is required (not just ci).
pm2 restart ecosystem.config.cjs --update-env
--update-env re-reads the launching shell's env (so a refreshed CLAUDE_CODE_OAUTH_TOKEN or TZ change takes effect).
Invoke the doctor skill. Report any new failures. If listener fails to start, surface the last 30 lines of pm2 logs ginnie-agents-listener --nostream.
Print the relevant CHANGELOG.md section for the new version range so the user knows what changed in their framework.