待翻译：Show HN: Log-decisions – an append-only decision journal for AI agents

AI 服务暂时不可用，以下为来源正文，待恢复后补全翻译。

Uh oh! There was an error while loading. Please reload this page. Notifications You must be signed in to change notification settings Fork 0 Star 0 BranchesTags Open more actions menu Folders and files NameName Last commit message Last commit date Latest commit History 3 Commits 3 Commits .claude-plugin .claude-plugin skills/log-decisions skills/log-decisions LICENSE LICENSE README.md README.md Repository files navigation An append-only DECISIONS.md journal recording the consequential calls a spec didn't settle — what was chosen, by whom, and why, with decide / assume / escalate rules for what an agent may settle alone. General-purpose. The journal isn't coding-specific: any agent-assisted work — research, writing, ops, data — produces judgment calls someone will later ask "why was it done this way?" about. This skill gives those calls one durable, grep-able home at the repo root. It ships as an Agent Skill — pure markdown, no scripts — so it runs on Claude Code, Codex, Gemini CLI, Cursor, and any other skills-compatible agent. Install Universal (any skills-compatible agent) npx skills add swe-workflow/log-decisions Claude Code (plugin) /plugin marketplace add swe-workflow/log-decisions /plugin install log-decisions@log-decisions What it does The skill (skills/log-decisions/SKILL.md) defines: The bar — if the spec already authorized the call it's not journal-worthy; if the agent had to invent the authorization, it is. The 2×2 — classify each call as determinable × reversible, then decide (grounded by an artifact), assume (safe default, logged for async review), or escalate (stop and ask). A catastrophic floor — data loss, destructive migration, irreversible spend, public-interface breaks — always escalates. The entry — one append-only block per decision: Question, Options considered, Chosen, Decided-by, Justification, Outcome, with Supersedes: for revisions. Never edited, never reordered. Links Discussion — Show HN thread Claude Code plugin — install with the commands above; submitted to Anthropic's Plugin Directory (pending review) Used by swe-workflow — the idea → PRD → issues → ship suite — orchestrates this skill across every stage: spec-layer grills journal their assumed answers through it, and ship builds stage entries to a per-worktree DECISIONS.staged.md promoted at close-out. It was extracted from that repo (≤ v2.0.2) into this standalone one. License MIT MIT license Activity Custom properties Stars 0 stars Watchers 0 watching Forks 0 forks Report repository