OpeItcLoc03/claude-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
e5839bd072f0f271788736f543c5899bf917bebd
claude-skills/.wiki/index.md
vitya e5839bd072 feat(wiki): document session-handoff skill design rationale 
Capture the design decisions behind the session-handoff skill in a dedicated
`.wiki/concepts/session-handoff-skill-design.md` page, indexed and logged per
Karpathy LLM Wiki conventions. Covers the problem statement (cold-start fog
between CC sessions), the sliding-overwrite contract for `.tasks/NEXT_SESSION.md`,
the phrase whitelist + anti-pattern guards + ambiguity-asks-not-guesses rule,
the substantive-commit heuristic (prefix exclude AND (body>200 OR files>3) +
first-non-trivial-commit-always exception), the opt-in PostToolUse hook that
replaces agent-side memory with harness-side determinism, the orient+ask read
mode default, project scope guarantee, the five-section handoff content contract,
secret-detect abort, staleness-7d query, mid-task capture, precedent comparison
against using-tasks / MEMORY.md / log.md / Karpathy diary, and the closure
record of cluster 7/7 (install / hermes-mapping / bootstrap-template-extend /
posttooluse-hook / existing-projects-upgrade / test-trigger / review). Source
buffer: `~/projects/.workshop/.archive/2026-05-24-session-handoff-skill.md`
Round 1 design + Round 2 Q1–Q10 resolution.

Also serves as the live-hook e2e smoke artifact for the deferred follow-up from
`[session-handoff-posttooluse-hook]` — substantive commit (feat: prefix, body
well above 200 chars) should trigger the PostToolUse `commit-detector.ps1` hook
just enabled in `~/.claude/settings.json` and emit `hookSpecificOutput.additionalContext`
on the next agent turn.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-25 00:20:17 +03:00

5.1 KiB
Raw Blame History

Wiki Index

Catalog of all wiki pages. One line per page, organized by type. Updated on every ingest / new page.

Overview

  • overview.md — what claude-skills is, layout, how to navigate

Entities

Concepts

  • active-platform-decision.md — why active-platform is a skill (not a memory entry); why default = Windows; how it's wired into project-bootstrap
  • bootstrap-claude-md-merge.md — project-bootstrap@1.3.0 — Step 5 upgrade path becomes idempotent merge (read → diff vs template → confirm → append missing); fixes silent gap where pre-1.2.0 projects never picked up new canonical triggers (check across all projects, we're on Windows)
  • bootstrap-skill-deps-check.md — project-bootstrap@1.7.0 — Step 5.6 collapses the per-skill "detect-and-recommend" mirror shape into one generic trigger → fulfiller table walker (skill vs plugin kind, never auto-install); subsumes the deferred [bootstrap-recommend-projects-meta] and the existing superpowers-only detector
  • bootstrap-manifest.md — record of which project-bootstrap / setup-wiki / setup-tasks versions initialized this project's .wiki/ and .tasks/ layout (overwritten on re-bootstrap; history in git)
  • build-notes.md — why build.ps1 exists alongside build.sh; PS 5.1 backslash-in-zip gotcha; how to extract a .skill
  • install-portability.md — install.sh / build.sh rewritten to drop mapfile (bash 4+) and find -printf (GNU only) so stock macOS (bash 3.2 + BSD find) works
  • context7-setup.md — switched context7 from manual MCP entries to the official plugin; API key in .mcp.json as --api-key; now also captured as setup-context7 skill (one-time install/migrate flow with key discovery)
  • projects-meta-skills.md — setup-projects-meta + using-projects-meta skill pair for the local projects-meta-mcp stdio server (cross-project tasks + shared Gitea wiki); local-first rule + two-step mutation pattern
  • project-discipline-design.md — design for project-discipline (four cross-project rules: conventions-over-defaults, master-only, semver-bumping, ask-before-push)
  • pulling-before-work-design.md — design for the pulling-before-work skill (mode-3 + skip-on-dirty)
  • repo-layout.md — flat skills/, committed dist/, bash + PowerShell scripts; install model
  • skill-versioning.md — why infra skills carry version: <semver> in frontmatter and how project-bootstrap records them in a per-project manifest
  • skill-vs-plugin.md — when a bare SKILL.md is enough vs when you actually need a plugin (slash commands, hooks, sub-agents, MCP servers); concrete breakdown of superpowers
  • wiki-realignment.md — fixing project-bootstrap to create the Karpathy-canonical wiki layout
  • interns-design — interns-design
  • compress-dedup.md — skills/compress/ deleted as a byte-identical dupe of skills/caveman-compress/; canonical kept for README + SECURITY + caveman-toolkit branding; better Process-step wording ported across; version: 1.0.0 added to caveman-compress frontmatter
  • active-platform-eval-design.md — spec for eval-driven tuning of active-platform: combine the two ⚪ tasks into one workstream, 20-query cross-platform eval set (≥3 per OS + near-miss negatives), run_loop.py autoloop in parallel with manual body sweep (WSL / BSD / ambiguity), version 1.0.0 → 1.1.0 (MINOR). Status: paused after design + pre-flight check, before eval-set authorship
  • interns-repo-read-design — interns-repo-read-design
  • hermes-skills-rollout-design — hermes-skills-rollout-design
  • tdd-criteria-design — tdd-criteria-design
  • project-bootstrap-meta-isolation.md — project-bootstrap@1.11.0 — Step 1 ships meta-isolation block in .gitignore (!.claude/, !.tasks/, !.wiki/, ...) so own greenfield/upgrade projects re-enable agent meta-paths against global core.excludesFile cutter. Marker-based append-only on existing files; smoke-tested with negative control
  • interns-grep-audit-design — interns-grep-audit-design
  • session-handoff-skill-design.md — design rationale for the session-handoff skill (sliding overwrite into .tasks/NEXT_SESSION.md, phrase whitelist + substantive-commit heuristic, optional PostToolUse hook for harness-side determinism, orient+ask default, project scope, cluster 7/7 closure)

Packages

Sources

Reference in New Issue View Git Blame Copy Permalink