OpeItcLoc03/claude-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
13d2c09d991c76ad1b0faf9ef16f66cb566d3fdd
claude-skills/.wiki/index.md
vitya afb1d1eb96 feat(using-tasks): done-task archival rule, fix STATUS.md bloat (v1.3.0) 
MINOR bump 1.2.0 -> 1.3.0. Adds a done-task archival rule: when >=10
green done blocks pile up in STATUS.md (checked at Session start step 7
and Task completion step 7), move them verbatim to
.tasks/archive/YYYY-MM.md (append, monthly file, one-time header,
committed on its own), leaving only active/paused/ready/blocked on the
board. This is the root-cause fix for the recurring "huge STATUS.md"
complaint -- orientation still reads the local board, but the board is
kept small so the read stays cheap.

Deliberately did NOT follow the task's literal instruction to swap
Read STATUS.md for tasks_get_status in the orientation flow: that rests
on a factual error. tasks_get_status returns ONE task's live status by a
known slug and cannot enumerate the board; tasks_aggregate is
cross-project + cache-based and does not index ready/done (its docs say
read STATUS.md directly for the current project). So no projects-meta
tool replaces the orientation board-read. The skill now warns against
both tools for board enumeration and points tasks_get_status at its real
single-task use.

Concept page concepts/using-tasks-status-archival.md + index + log
document the deviation for the paired review task. TDD N/A (markdown
policy). hermes/mapping + install untouched (separate baseline tasks).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-09 16:50:37 +03:00

7.4 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-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.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)
  • using-tasks-session-break.md — using-tasks v1.2.0 session_break marker: task-author-set boolean/string flag; after a task closes 🟢, before tasks_claim_next, an autonomous agent prints the verbatim SESSION BOUNDARY line and stops instead of chaining the next task. Absent → unchanged
  • delegate-task-session-break.md — delegate-task v0.2.2 — authoring side of the session_break marker (consumer = using-tasks-session-break): pre-flight Q6 + optional template field session_break: true | "<hint>"; three set-it cases (domain-switch / milestone / heavy infra); not a default
  • using-system-snapshot-design.md — using-system-snapshot v0.1.0 — thin read-only skill wrapping the single mcp__projects-meta__meta_system_snapshot call (poller + local docker + cached task summary); replaces scattered tasklist/docker ps/manual meta_status; core rule = no liveness claim without calling the tool this turn; three-line output; defers deep docker to using-vds-ops and precise tasks to using-projects-meta
  • using-tasks-status-archival.md — using-tasks v1.3.0 done-task archival rule (≥10 🟢 → .tasks/archive/YYYY-MM.md) fixes STATUS.md bloat; documents why tasks_get_status (single-task, by slug) / tasks_aggregate (cross-project cache) can't replace the orientation board-read, so the literal task instruction was not followed
  • delegate-task-negative-trigger-fp.md — delegate-task v0.2.1 FP fix: «создать задачу себе» stem-matched the «создать задачу на агента» positive trigger; abstract "does NOT apply when doing the work yourself" carve-out loses to literal stem-match under the 1%-rule → made the negative literal + routed (→ using-tasks). Verified pos 5/5, neg 4/5 (was 0/5)

Packages

Sources

Reference in New Issue View Git Blame Copy Permalink