shiplog

The captain's log for your codebase. Every decision, discovery, and trade-off — captured in GitHub as you ship.

Quick Install

npx skills add devallibus/shiplog --skill shiplog

Works with Claude Code, Codex, and Cursor. Only requires gh CLI.

---

Your AI assistant forgets everything between sessions

You brainstormed a design with Claude yesterday. Today, a new session starts from scratch. The reasoning behind that auth middleware? Gone. The three alternatives you rejected? Nowhere to be found. Last week's architectural decision? Buried in a chat log you can't search.

shiplog makes your git history remember everything. Not just what changed — but why it changed, what you considered, and what you discovered along the way.

Brainstorm → Issue → Branch → Commits → PR
    ↑                           ↑
    |         Discoveries → New Issues / Stacked PRs
    |
    └── Search it all later: issues, PRs, commits, memory

What you get

Every brainstorm becomes a GitHub Issue. Design decisions, alternatives considered, and a task list — all searchable forever.

Every commit carries context. Not just "add JWT validation" — but why JWT over sessions, what you tried first, and what to watch out for.

Every PR tells the full story. A timeline of the entire journey: what was planned, what was discovered mid-work, what changed and why.

Nothing falls through the cracks. Find a sub-problem while coding? shiplog routes it — fix inline, stack a prerequisite PR, or spin off a new issue. Your discovery is never lost.

Any model can pick up where another left off. Every artifact is signed with who wrote it (which AI model, which tool). Context handoffs between models are first-class — not copy-paste.

---

How it works

You say "let's brainstorm auth middleware" and shiplog captures the result as a GitHub issue. When you say "work on #42", it creates an isolated branch in a git worktree. As you commit, it logs the reasoning. When you open the PR, it writes a timeline of the whole journey.

Your existing workflow, with a knowledge trail that persists across sessions, models, and tools.

Step	What happens
Brainstorm	Design discussion becomes a GitHub Issue with tasks
Branch	Isolated worktree created, timeline started, plan loaded
Discover	Sub-problems routed: inline fix, stacked PR, or new issue
Commit	Conventional commits with context comments on significant changes
Ship	PR with full journey timeline, decisions, and lessons learned
Search	Find any past decision across issues, PRs, and commits

Two modes

Full Mode (default) — Knowledge goes directly into issues and PRs. Perfect for personal projects and open source.

Quiet Mode — Your team sees clean PRs. The full reasoning lives in a separate --log branch, one click away.

main
  └── feature/auth-middleware            ← Clean PR (team sees this)
        └── feature/auth-middleware--log  ← Knowledge trail (one click away)

---

Features

Cross-model review

No PR merges without review from a different AI model or a human. A single model authoring, reviewing, and merging its own work is the anti-pattern shiplog prevents. Reviews carry signed Reviewed-by: lines, support four dispositions (approve, approve-with-follow-ups, request-changes, comment), and generate self-contained review contracts when spawning a reviewer isn't possible.

Agent identity signing

Every artifact carries a provenance signature — Authored-by: claude/opus-4.6 (claude-code). The signing system auto-detects the current model from the platform and makes everything searchable:

gh issue list --search "Authored-by: claude/"   # all Claude artifacts
gh pr list --search "Reviewed-by:"              # all reviews

Model-tier routing

---

GitHub에서 전체 내용 보기