<aside> 📋 DRAFT template for the /log Claude Code skill (https://github.com/swastij/claude-log-skill). Duplicate this whole page into your own private space, then point ~/.notion-learnings.json at the three databases below. Property names must stay exactly as they are: the script addresses them by name.

</aside>

What this is

A personal knowledge base, one row per task from your tracker (ClickUp, Jira, Linear, GitHub issues; the script only needs an id): what surprised you, how the thing actually works, the decisions you made (with alternatives rejected) and the questions you asked or should have asked. The PR records what changed; this records why, and what you would do differently. Not team-facing.

Setup (once, ~10 minutes)

  1. Duplicate this page (··· → Duplicate) into your private space and rename it "Engineering learnings".
  2. Create an internal integration at notion.so/profile/integrations with Read, Insert and Update content. Copy the secret.
  3. On each of the three databases below (in YOUR copy): ··· → Connections → add the integration. All three must be connected or relations fail.
  4. Write the two config files. The database id is the 32-hex segment in each database URL, before ?v=.
printf '%s' 'ntn_...' > ~/.notion-token && chmod 600 ~/.notion-token
cat > ~/.notion-learnings.json <<'JSON'
{ "tasks": "<tasks db id>", "decisions": "<decisions db id>", "questions": "<questions db id>" }
JSON
  1. Install the skill and script from https://github.com/swastij/claude-log-skill: copy skills/log to ~/.claude/skills/log and scripts/notion-log.py to ~/.claude/scripts/. Python 3.9+, standard library only.
  2. Smoke test, writes nothing:
python3 -I ~/.claude/scripts/notion-log.py --dry-run entry.json

Daily use

Type /log in Claude Code when a PR is opened or a ticket reaches Done. The skill:

  1. Finds the task id from the branch name, PR body, or asks you; collects PR URLs for every repo touched.
  2. Drafts the entry from the session and shows it as a readable summary (JSON saved as log-<task_id>.json in a temp dir).
  3. If Done: adds 3–5 quiz questions with the correct answer filled and your answer empty; sets Shipped on to today.
  4. Waits for your edits. Nothing is sent until you confirm.
  5. Sends and reports the script output verbatim.

<aside> 🔁 Re-running is safe: the task is upserted by Task ID, and Decision / Question rows whose title already exists for that task are skipped. To change an existing row, edit it in Notion.

</aside>