Files
claude-skills/.wiki/index.md
vitya ffeb95b9cc feat(build): add --prune flag to build.{sh,ps1} [skip-tdd: wrapper]
Symmetric to install-side --prune (e871c20). Removes
dist/<name>.skill files whose <name> is not in skills/*.

Design choices match install:
- Combined flag (build + prune in one run)
- Global scan, ignores -Names / positional filter
- Default off, print-and-delete, no confirmation

Bash wrinkle: when build.sh delegates to powershell.exe -File
build.ps1 (Windows-without-zip case), --prune is NOT forwarded.
Bash runs prune itself at the end of the script against the
shared dist/. Keeps the delegation surface narrow and the prune
logic single-sourced per shell.

[skip-tdd: wrapper] — same carve-out as install-side, smoke-test
evidence: fake dist/fake-stale-{sh,ps}.skill files created in real
dist/, ran build.{sh,ps1} --prune, verified fakes removed, real
caveman.skill etc. left intact.

Wiki .wiki/concepts/install-cross-platform.md extended:
- title broadened (Install → Install / Build)
- new "Build-side --prune" section
- scope note: dist-hermes/ is separate (managed by build-hermes.py)

Closes [install-ps1-build-prune-followup].
2026-05-25 13:38:34 +03:00

5.4 KiB

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-cross-platform.md — paired-script parity contract for install.{ps1,sh} AND build.{ps1,sh}; rationale for the --prune / -Prune flag (combined-with-action, global-scan, default-off); install-side prunes target dirs, build-side prunes dist/*.skill files
  • install-portability.mdinstall.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.mdsetup-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.mdskills/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.mdproject-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