Files
claude-skills/.wiki/log.md

12 KiB
Raw Blame History

Wiki Log

Append-only operation log. One entry per operation. Format:

## [YYYY-MM-DD] <op> | <one-line description>

Operations: init, ingest, query, lint, refactor, decision.

Parseable: grep "^## \[" .wiki/log.md | tail -20.


[2026-04-28] init | bootstrap empty wiki via project-bootstrap (old layout)

[2026-04-28] decision | repo-layout — flat skills/, committed dist/, bash + PS scripts

[2026-04-28] decision | build-notes — PS 5.1 Compress-Archive backslash bug; build.ps1 via .NET ZipArchive

[2026-04-28] decision | active-platform — skill chosen over global CLAUDE.md / project memory; default Windows; wired into project-bootstrap

[2026-04-28] refactor | wiki-realignment — fixed project-bootstrap Step 3 to create Karpathy-canonical layout

[2026-04-28] refactor | this repo's .wiki/ migrated to canonical layout (SUMMARY.md→index.md, source/→concepts/, added log.md/overview.md/CLAUDE.md schema, raw/README.md)

[2026-04-28] decision | context7-setup — switched to official plugin; --api-key injected into plugin's .mcp.json; three manual MCP entries removed

[2026-04-28] decision | setup-context7 skill — formalized the install/migrate algorithm; using-context7 gets a Prerequisites pointer; build.sh PS multi-arg bug fixed (loop instead of comma-joined -Names)

[2026-04-28] verify | setup-context7 — Vitya ran using-context7 in a session that needed setup; Prerequisites pointer triggered setup-context7; full flow worked end-to-end. Pattern (policy + setup split) validated.

[2026-04-28] decision | skill-vs-plugin — documented when a bare skill suffices vs when a plugin is required (slash commands, hooks, sub-agents, MCP via marketplace)

[2026-04-28] decision | skill-versioning — added version: 1.0.0 to 6 infra skills' frontmatter; project-bootstrap now writes .wiki/concepts/bootstrap-manifest.md per project

[2026-04-28] refactor | wiki split — wiki-maintainer renamed to using-wiki (policy); new setup-wiki skill owns greenfield creation and canon migration; project-bootstrap Step 3 delegates

[2026-04-28] refactor | tasks split — task-status-wiki renamed to using-tasks (policy); new setup-tasks skill owns greenfield + interactive migration (no auto-parsing of old flat STATUS.md); project-bootstrap Step 4 delegates

[2026-04-28] refactor | this repo's .tasks/ migrated to canonical layout — flat ## Done/## Backlog replaced by emoji-status board (7 Ready blocks); historical Done entries dropped (preserved in git log); .bak ignored via .gitignore

[2026-04-28] cleanup | removed stale ~/.claude/skills/{wiki-maintainer,task-status-wiki}/ installs (replaced by using-wiki/using-tasks); 16 skills installed, no duplicates; context7 plugin (mcp__plugin_context7_context7__*) confirmed live after restart

[2026-04-28] decision | install-portability — install.sh/build.sh patched to drop mapfile+find -printf; stock macOS (bash 3.2 + BSD find) now works; verified on git-bash (16 skills discovered, sorted, installed; build.sh produces archive)

[2026-04-29] decision | projects-meta-skills — built setup-projects-meta (8-phase install of projects-meta-mcp + auth.toml + MCP registration) and using-projects-meta (runtime policy with local-first rule and two-step mutation); skill pair pattern applied for the 4th time (context7 / wiki / tasks / projects-meta); both built + installed; visible to the harness

[2026-04-30] refactor | projects-meta-skills — wiki path canon corrected: ~/projects/.wiki~/projects/projects-wiki/ (clone root), content at ~/projects/projects-wiki/.wiki/. Old path caused write/read mismatch bug (fixed upstream in commit 621a69f of projects-meta-mcp). Setup-projects-meta Phase 1 now detects legacy clone, Phase 4 re-clones to canon. Lesson: pull shared resources before relying on cached anchors

[2026-04-30] decision | using-projects-meta v1.1.0 — added mandatory Step 0 freshness gate: probe meta_status; if cache_age > 10min or errors > 0, node dist/sync.js; for shared-wiki writes unconditional git -C ~/projects/projects-wiki pull --ff-only; 401/403 → loud failure to user. Codifies the same-session lesson — projects-meta is a multi-machine bus, stale cache breaks read accuracy and write atomicity

[2026-04-28] doc | README.md + README.ru.md — new "Using skills in projects" / "Использование в проектах" section after install quick-start; describes project-bootstrap workflow (git, .gitignore, README, .wiki/, .tasks/, CLAUDE.md, manifest, superpowers-plugin check) and the init/upgrade modes

[2026-04-30] refactor | project-bootstrap re-run on this repo (upgrade mode) — setup-wiki noop, setup-tasks noop, CLAUDE.md unchanged (matches template), bootstrap-manifest.md written: project-bootstrap@1.1.0 / setup-wiki@1.0.0 / setup-tasks@1.0.0

[2026-04-30] decision | project-bootstrap@1.2.0 — CLAUDE.md template gains check across all projects (verbatim trigger from using-projects-meta description); installs auto-load cross-project tasks + shared-wiki access in every bootstrapped repo; no Step 5.7 dependency-check mirror — Prerequisites pointer in using-projects-meta is self-correcting; local CLAUDE.md, both READMEs, dist/.skill, projects-meta-skills concept page synced

[2026-04-30] decision | Step 5.7 mirror of Step 5.6 (projects-meta-mcp dependency detector / setup-projects-meta recommendation) accepted as future work; tracked as Ready task [bootstrap-recommend-projects-meta]; deferred until first observed fresh-machine miss so detector signal is informed by real failure mode; concept page projects-meta-skills.md updated to reflect new stance

[2026-04-30] decision | project-bootstrap@1.3.0 — Step 5 upgrade path turned idempotent: read existing CLAUDE.md → substring-diff vs template → confirm → append-only-missing; closes silent gap where pre-1.2.0 projects never picked up new canonical triggers (check across all projects, we're on Windows); platform line preserved if user pinned a non-host one; concept page bootstrap-claude-md-merge.md written; README CLAUDE.md row updated to note idempotent merge

[2026-05-01] decision | pulling-before-work — new policy skill (v1.0.0): one git pull --ff-only at session start + on-demand re-sync; bootstrap template gains canonical trigger; project-bootstrap 1.3.0→1.4.0

[2026-05-01] decision | project-discipline — new policy skill (v0.1.0): four cross-project rules (conventions-over-defaults, master-only, semver-bumping, ask-before-push); bootstrap template gains canonical trigger; project-bootstrap 1.4.0→1.5.0; skill-versioning concept extended to all skills

[2026-05-05] ingest | concepts/interns-design

[2026-05-05] decision | interns-skills-mvp — shipped setup-interns v0.1.0 (8-phase install: detect .common/lib/interns-mcp/, pip install -e, .common/secrets/interns.env write, mcpServers.interns registration with absolute Python interpreter + cwd) and using-interns v0.1.0 (runtime policy mirroring project-discipline Rule 4: ask-mode default, conversational grant/revoke, always-ask paths for .env/secrets/keys/SSH/credentials with transitive rule, cost-cap >$0.10, session-end reset; routing hints for bulk_text_read + transcript_distill); project-bootstrap 1.5.0→1.6.0 with canonical CLAUDE.md trigger delegate to interns when allowed between follow project discipline and we're on Windows, Step 5 commentary paragraph, manifest table extended with both new skills + project-discipline row; root CLAUDE.md dogfood updated; both READMEs written; descriptions verified (setup-interns 899 chars, using-interns 814 chars, both under 900 budget); all three rebuilt + installed + listed by harness with full descriptions (no H1 fallback)

[2026-05-05] ingest | concepts/bootstrap-skill-deps-check

[2026-05-05] decision | bootstrap-skill-deps-check — project-bootstrap 1.6.0→1.7.0 collapses Step 5.6 from a single-skill detector (only superpowers plugin) into a generic trigger → fulfiller table walker. Map embedded in SKILL.md (9 rows: caveman, superpowers plugin, using-wiki, using-tasks, using-projects-meta, pulling-before-work, project-discipline, using-interns, active-platform); kind: skill vs kind: plugin flag drives the install command emitted in the recommendation block. Algorithm: read project's CLAUDE.md → match each line vs map (substring + tolower, mirrors Step 5 idempotent merge) → for each canonical match check disk (~/.claude/skills/<name>/SKILL.md or installed_plugins.json key); print one chat-only block listing every missing fulfiller + install commands, or one line if all satisfied. User-custom lines silently skipped; removed canonical lines silently skipped (respects user opt-out). Hard rule "never auto-install" carries over verbatim. Subsumes the deferred [bootstrap-recommend-projects-meta] task (closed by absorption — generic step handles using-projects-meta along with everything else). MCP-server-backed skills only check the using-X policy skill; setup-X self-fires on first use via Prerequisites pointer, bootstrap doesn't duplicate.

[2026-05-05] decision | compress-dedup — skills/compress/ was a stripped-down byte-for-byte dupe of skills/caveman-compress/ (scripts/ identical SHA256 across all 7 files; SKILL.md diff = name: + Process step 2; descriptions textually identical = arbitrary harness tie-break + double-counted listing budget). Kept caveman-compress canonical: it carries README.md (benchmarks table + caveman-toolkit branding) and SECURITY.md (Snyk false-positive writeup), and matches the caveman-* prefix invariant. Ported the better Process-step wording from compress into caveman-compress (cd <directory_containing_this_SKILL.md> instead of brittle cd caveman-compress which assumes cwd). Added version: 1.0.0 to caveman-compress frontmatter (first versioned release; aligns with skill-versioning concept). Deleted: skills/compress/, dist/compress.skill, ~/.claude/skills/compress/ (manual prune — install.sh has no prune step; future [install-ps1] task should add --prune flag). Rebuilt + reinstalled caveman-compress. Slash-command impact: /compress removed; /caveman-compress + /caveman:compress (toolkit-canonical) remain. Concept page concepts/compress-dedup.md written (rationale + rejected alternatives: alias-stub has no harness mechanism; "keep both" wastes listing budget; "delete caveman-compress" loses README + SECURITY).

[2026-05-05] design | active-platform-eval (paused) — combined [active-platform-tuning] + [active-platform-eval] into one workstream (eval is the tuning mechanism; "wait for 5 real signals" was a placeholder). Spec written at .wiki/concepts/active-platform-eval-design.md: 20-query trigger eval set balanced ≥3 should-trigger per OS (Win/Lin/Mac) + near-miss negatives, run in skill-creator/scripts/run_loop.py (5 iter, train/test split, model claude-opus-4-7) in parallel with manual body sweep (WSL clarity, BSD/macOS expansion, ambiguity policy). Workspace at .tasks/active-platform-eval/ (eval-set.json committed, iterations gitignored). Version bump 1.0.0 → 1.1.0 planned (MINOR). Pre-flight verified: claude CLI at C:\nvm4w\nodejs\claude.ps1 (Claude Code 2.1.128) + run_loop.py present in skill-creator install — both autoloop deps satisfied, no fallback needed. Per-task file at .tasks/active-platform-eval.md. Paused at user request before eval-set authorship; resume point is Q2 (write 20 queries solo vs run skill-creator HTML-review template for user edits first). Also fixed in same pause: [install-ps1] STATUS scope expanded to "paired install.sh + install.ps1, cross-platform parity, --prune flag" (lesson from [compress-dedup]).

[2026-05-05] ingest | concepts/interns-repo-read-design

[2026-05-06] ingest | concepts/hermes-skills-rollout-design

[2026-05-07] ingest | concepts/tdd-criteria-design