Commit Graph

230 Commits

Author SHA1 Message Date
04886036ed tasks: open setup-interns-fix-paths
Mirror of done [using-projects-meta-fix-paths] for the sister skill.
setup-interns/SKILL.md still uses <project-root>/.common/... (cwd-
relative); should be ~/projects/.common/... like setup-projects-meta.
Surfaced during factory-bootstrap field-test (Phase 1 STOP because
claude inherited cwd C:\Windows\System32, no .common/ child there).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-06 15:26:45 +03:00
ecaa73bfe1 tasks: open setup-projects-meta-token-leak
Surfaced during factory-bootstrap field-test on Win11 laptop.
Phase 4 of /setup-projects-meta retries clone with USER:TOKEN@host
URL on auth-failure, which git persists in .git/config of the
cloned repo. Replace with per-invocation extraheader form:

  git -c http.extraheader="Authorization: token $T" clone <url>

Field-test artefact: .factory/L0/install-log.md шаг 11c-1.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-06 15:18:38 +03:00
ef14594a9f Add scripts/install.ps1 — PowerShell port of install.sh
Native cmdlet equivalent of install.sh: same behavior (copy each
skills/<name>/ into ~\.claude\skills\<name>\, skip if SKILL.md is
missing, support $env:CLAUDE_SKILLS_DIR override and -Names filter).

Removes bash dependency on Windows — no need to invoke git-bash from
pwsh, mirrors the existing build.sh / build.ps1 pair.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-06 11:48:04 +03:00
81af7825b6 feat(interns): add repo_read routing to using-interns + Node/repomix checks to setup-interns [v0.2.0]
using-interns: overview table 2→3 interns, routing hints for repo_read
vs bulk_text_read, tool quick reference row. setup-interns: Phase 0
adds node --version check + optional repomix pre-warm.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-06 07:02:42 +03:00
daf33391c0 meta(tasks): create [interns-repo-read-skill-updates] in claude-skills 2026-05-05 20:05:08 +00:00
93a450076c meta(wiki): log += ingest concepts/interns-repo-read-design 2026-05-05 20:05:03 +00:00
b7943a3c43 meta(wiki): index += concepts/interns-repo-read-design 2026-05-05 20:05:00 +00:00
3400102248 meta(wiki): ingest concepts/interns-repo-read-design in claude-skills 2026-05-05 20:04:58 +00:00
d9728ef2e7 meta(tasks): pause [active-platform-eval] after design + pre-flight
Combined the two backlog tasks [active-platform-tuning] +
[active-platform-eval] into a single workstream. Eval IS the tuning
mechanism; "wait for 5 real signals" was a placeholder replaced by
a 20-query synthetic eval set balanced across Win/Lin/Mac.

Spec written at .wiki/concepts/active-platform-eval-design.md
(~150 lines): 20 queries (>=3 should-trigger per OS + near-miss
negatives), run_loop.py 5-iter autoloop 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 on PATH 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 to manual single-pass.

Per-task file at .tasks/active-platform-eval.md (Goal, Key files,
Decisions log, Open questions, Notes). STATUS.md collapsed the two
original blocks into one paused block; resume point is Q2
(write 20 queries solo vs run skill-creator HTML-review template).

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]).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 22:35:55 +03:00
6e4f3f481b refactor(skills): dedup compress -> caveman-compress [v1.0.0]
skills/compress/ was a byte-identical dupe of skills/caveman-compress/
(SHA256 match across all 7 scripts/ files; SKILL.md diff was name: +
Process step 2 only; descriptions textually identical = arbitrary
harness tie-break + double-counted listing budget).

Kept caveman-compress canonical: it carries README.md (benchmarks +
caveman-toolkit branding) and SECURITY.md (Snyk false-positive writeup),
and matches the caveman-* prefix invariant.

Ported the better Process-step wording from compress
(`cd <directory_containing_this_SKILL.md>`) into caveman-compress;
the prior `cd caveman-compress` form assumed cwd was the parent dir
and broke when invoked from ~/.claude/skills/caveman-compress/.

Added version: 1.0.0 to caveman-compress frontmatter
(first versioned release; aligns with skill-versioning concept).

Removed: skills/compress/, dist/compress.skill,
~/.claude/skills/compress/ (manual prune; install.sh has no prune step
yet -- future [install-ps1] task should add --prune).

Slash-command impact: /compress gone; /caveman-compress and
/caveman:compress (toolkit-canonical) remain.

Wiki: .wiki/concepts/compress-dedup.md (rationale + rejected
alternatives), index.md + log.md updated.

Tasks: [compress-dedup] flipped active -> done in same commit
(per-task file .tasks/compress-dedup.md created with full decisions
log).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 21:49:44 +03:00
8c547d73af feat(project-bootstrap): generic Step 5.6 skill-deps check
Collapse Step 5.6 from a single-skill detector (only the
superpowers@claude-plugins-official plugin) into a generic
`trigger -> fulfiller` table walker that scales to every canonical
CLAUDE.md trigger.

Inline 9-row map in SKILL.md covers: caveman, superpowers (kind: plugin),
using-wiki, using-tasks, using-projects-meta, pulling-before-work,
project-discipline, using-interns, active-platform. The `kind` flag
(skill | plugin) drives which install command is emitted in the chat-only
recommendation block. Detection paths: ~/.claude/skills/<name>/SKILL.md
for skills, plugins.<id> in ~/.claude/plugins/installed_plugins.json
for plugins.

Algorithm: read project's CLAUDE.md -> match each non-comment line vs
map (substring + tolower, mirrors Step 5 idempotent merge) -> for each
canonical match check disk -> print one chat block listing every missing
fulfiller with copy-pasteable install commands, OR a single
"all dependencies satisfied" line. User-custom lines and removed
canonical lines are silently skipped. Hard rule "never auto-install"
preserved verbatim.

version: 1.6.0 -> 1.7.0 (MINOR per project-discipline Rule 3 -- adds
capability, absorbs prior superpowers-only detector cleanly).

Closes [bootstrap-skill-deps-check] (.tasks/STATUS.md done).
Closes [bootstrap-recommend-projects-meta] by absorption -- the deferred
mirror task was the seed of this generalization; the generic walker now
handles using-projects-meta along with everything else, no per-skill
mirror needed.

Design rationale at .wiki/concepts/bootstrap-skill-deps-check.md:
- why generic over per-skill mirrors (5x mirror explosion)
- skill vs plugin kind distinction
- MCP-server-backed skills (only check using-X policy skill;
  setup-X self-fires via Prerequisites pointer)
- source-of-truth invariant: SKILL map + assets/CLAUDE.md.template
  must stay in sync (a future CI lint could enforce)
2026-05-05 21:21:19 +03:00
2f7943f06f fix(setup-projects-meta): canon path table -> .common/lib
SKILL.md Phase 5 platform-path table (lines 152-154) had stale
~/.local/projects-meta-mcp; replace with ~/projects/.common/lib/
projects-meta-mcp to match real install canon (body Phase 4 clone
target + ~/.claude.json mcpServers.projects-meta.args[0]).

version: 1.0.0 -> 1.0.1 (PATCH, doc consistency).

Closes [using-projects-meta-fix-paths] (.tasks/STATUS.md done).
Sibling task [migrate-to-common-lib] in projects-meta-mcp closed
the same day with matching path migration.
2026-05-05 21:14:06 +03:00
66f39e7ec8 add [using-projects-meta-fix-paths]: fix stale ~/.local/ refs
Skill prescribes `node ~/.local/projects-meta-mcp/dist/sync.js` for the
Step 0 freshness gate, but the real install (per ~/.claude.json) lives
at ~/projects/.common/lib/projects-meta-mcp/. setup-projects-meta likely
needs the same audit.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 20:59:52 +03:00
001f4c566b feat(skills): update setup-projects-meta paths for .common/lib/
- Replace ~/.local/projects-meta-mcp → ~/projects/.common/lib/projects-meta-mcp
- Update setup-projects-meta and using-projects-meta skills
- Rebuild dist/ with new paths

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 20:35:59 +03:00
05ea501683 meta(tasks): create [bootstrap-skill-deps-check]; supersede [bootstrap-recommend-projects-meta]
New  ready task to refactor project-bootstrap Step 5.6 from a per-skill
mirror shape (superpowers detector + deferred projects-meta detector) into
a single generic "skill dependencies check" that walks the canonical
CLAUDE.md template, maps each trigger line to its fulfiller (skill or
plugin), and prints one chat-only recommendation block with install
commands. Hard rule "never auto-install" carries over verbatim.

Decision driven by the [interns-skills-mvp] commit (0eb7dd1): adding
`delegate to interns when allowed` made it visible that every new
canonical trigger would otherwise need its own Step 5.X mirror — doesn't
scale.

[bootstrap-recommend-projects-meta] marked superseded — that task was the
seed of this generalization; it stays in STATUS.md for archaeology and
will be closed once [bootstrap-skill-deps-check] ships.

.tasks/bootstrap-skill-deps-check.md carries the full spec: scope,
key files, decisions log (5 entries), open questions, initial
trigger→fulfiller seed table.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 19:41:04 +03:00
0eb7dd1d7c feat(interns-skills-mvp): ship setup-interns + using-interns v0.1.0; project-bootstrap 1.5.0 -> 1.6.0
setup-interns (v0.1.0) — 8-phase install of the local `interns` MCP server:
detect `.common/lib/interns-mcp/` source, `pip install -e`, write
`.common/secrets/interns.env` with endpoint API keys (gitignored), register
`mcpServers.interns` in `~/.claude.json` with absolute Python interpreter
path + `cwd` so the runtime resolves config relative to project root.
Mirrors setup-projects-meta / setup-context7 confirmation-gate shape.
Description 899 chars (under the 900 budget per
feedback_skill_description_length_limit).

using-interns (v0.1.0) — runtime policy for `mcp__interns__*`. Per-session
permission grant mirrors project-discipline Rule 4: ask-mode default,
conversational grant ("разреши интернов" / "allow interns"), conversational
revoke, always-ask paths for `**/.env`, `**/secrets/**`, `**/*.key`,
`**/.ssh/**`, `**/.aws/credentials` etc with transitive rule (Claude can't
bypass by reading the file with the local Read tool and forwarding content),
cost-cap >$0.10 always asks, session-end automatic reset. Routing hints for
`bulk_text_read` (3+ files or one file >400 lines) and `transcript_distill`
(before .wiki/log.md updates / session summaries). Description 814 chars.

project-bootstrap (1.5.0 -> 1.6.0, MINOR — capability added):
* assets/CLAUDE.md.template: insert `delegate to interns when allowed`
  between `follow project discipline` and `we're on Windows`.
* SKILL.md Step 5: same insertion in inline template + new commentary
  paragraph explaining the trigger, no-op semantics, install pointer.
* SKILL.md Step 5.5: bootstrap-manifest table extended with
  `setup-interns`, `using-interns`, `project-discipline` rows.
* README.md: Workflow Step 5.5 description + See also section both pick up
  the new skills.

Root CLAUDE.md dogfood: `delegate to interns when allowed` line added.
.wiki/log.md decision entry. .tasks/STATUS.md task moved to 🟢 done.
.tasks/interns-skills-mvp.md per-task file with goal / key-files /
decisions log / open questions.

Build + install verified: `dist/{setup-interns,using-interns,
project-bootstrap}.skill` rebuilt; `bash scripts/install.sh ...` succeeded;
harness skill listing shows full descriptions for all three (no H1
fallback) — confirms the description budget held.

Versioning per project-discipline Rule 3:
* setup-interns: 0.1.0 (first edit of unversioned artifact, MAJOR=0).
* using-interns: 0.1.0 (first edit of unversioned artifact, MAJOR=0).
* project-bootstrap: 1.5.0 -> 1.6.0 (MINOR — adds capability without
  breaking existing CLAUDE.md merge or manifest consumers).

Server runtime itself (`.common/lib/interns-mcp/`) is out of scope for this
task — the skills land lifecycle, policy, and bootstrap integration so any
machine where the MCP server is later installed already has Claude's
policy in place.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 17:41:11 +03:00
7464ae4bc4 meta(tasks): create [interns-skills-mvp] in claude-skills 2026-05-05 13:59:09 +00:00
3deaa357c2 meta(wiki): log += ingest concepts/interns-design 2026-05-05 13:59:05 +00:00
035e4dd5ac meta(wiki): index += concepts/interns-design 2026-05-05 13:59:03 +00:00
30c329fdf2 meta(wiki): ingest concepts/interns-design in claude-skills 2026-05-05 13:59:00 +00:00
96dd6d1cb6 refactor: update setup-projects-meta for simplified wiki pathing
- Changed from ~/projects/projects-wiki/.wiki to ~/projects/.wiki/
- Removed legacy migration logic (no longer needed)
- Updated all script references and documentation
- Simplified Phase 4 detection (single canon path)

This aligns with projects-wiki repo changes where nested .wiki/
was removed and content now lives in root.
2026-05-03 17:55:06 +03:00
7419c946e5 docs(wiki): publish packages/claude-skills catalog to shared projects-wiki
All 20 skills grouped by purpose (bootstrap / wiki+tasks / MCP / caveman / discovery+platform); cross-linked with setup-using-skill-pair pattern and packages/projects-meta-mcp; published via knowledge_ingest (Gitea commits ae2cc9a3 + 14bdd863 + 001cdd0e on projects-wiki). Local-side: log entry + task closed.
2026-05-01 12:10:07 +03:00
483f6ac3e1 meta(tasks): create [refresh-project-bootstrap] in claude-skills 2026-05-01 09:03:52 +00:00
0c39729123 tasks: close [project-discipline-skill] 2026-05-01 11:36:20 +03:00
7f0e61ba91 docs(wiki): log + index — project-discipline@0.1.0 2026-05-01 11:35:47 +03:00
b8b6acb091 build: project-discipline@0.1.0 + project-bootstrap@1.5.0 archives 2026-05-01 11:35:01 +03:00
059cdf41e1 chore(claude-skills): dogfood 'follow project discipline' trigger 2026-05-01 11:34:31 +03:00
b72fc72577 docs(wiki): skill-versioning — Rule 3 of project-discipline extends scope to all skills 2026-05-01 11:34:15 +03:00
d0a450ce40 feat(project-bootstrap): v1.5.0 — add 'follow project discipline' canonical trigger [v1.5.0] 2026-05-01 11:33:46 +03:00
88d533b362 feat(project-bootstrap): template gains 'follow project discipline' trigger 2026-05-01 11:33:10 +03:00
ca75124324 docs(project-discipline): README 2026-05-01 11:32:59 +03:00
560f15571e feat(project-discipline): skill body — four rules + activation + out-of-scope [v0.1.0] 2026-05-01 11:32:38 +03:00
7c63c6080f feat(project-discipline): scaffold skill frontmatter [v0.1.0] 2026-05-01 11:31:22 +03:00
df8f1cb72b docs(project-discipline): design spec + implementation plan + STATUS active block
Spec: .wiki/concepts/project-discipline-design.md — four cross-project
rules (conventions-over-defaults, master-only, semver-bumping with
first-edit-unversioned clause, session-scoped ask-before-push with
grant/revoke and force/delete/non-ff exceptions); architecture: single
policy skill activated by 'follow project discipline' line in CLAUDE.md
template (added by project-bootstrap v1.5.0); 12-task implementation
plan tracked in .tasks/project-discipline-skill.md.
2026-05-01 11:30:38 +03:00
021bc2b6b7 tasks: tighten scenario-coverage wording in [pulling-before-work-skill] Done block
Per final code review: Done block claimed scenarios 1/2/4/8 verified
manually, but controller actually ran 1/2/3/4/5/8/9 + the inline
bootstrap-merge check. Scenarios 6 (diverged remote) and 7 (re-sync
trigger via fresh session) were not live-tested. Now stated honestly.
2026-05-01 10:41:20 +03:00
772f047c0a build: pulling-before-work@1.0.0 + project-bootstrap@1.4.0 archives 2026-05-01 10:36:00 +03:00
838b33c46b tasks: close [pulling-before-work-skill] 2026-05-01 10:34:34 +03:00
cffed70a05 docs(wiki): log + index — pulling-before-work@1.0.0 2026-05-01 10:34:23 +03:00
2bf640b6dc chore(claude-skills): dogfood 'pull remote before work' trigger 2026-05-01 10:33:58 +03:00
dcad95069f feat(project-bootstrap): v1.4.0 — add 'pull remote before work' canonical trigger 2026-05-01 10:29:12 +03:00
c8c6b04c6f feat(project-bootstrap): template gains 'pull remote before work' trigger 2026-05-01 10:28:49 +03:00
6a3c6c5203 docs(pulling-before-work): README 2026-05-01 10:23:50 +03:00
1aa1f35ca6 feat(pulling-before-work): skill body — pull cycle, recovery hints, rationale 2026-05-01 10:23:39 +03:00
7a834f2a9a feat(pulling-before-work): scaffold skill frontmatter 2026-05-01 10:22:54 +03:00
8c7e17edcb tasks: open [pulling-before-work-skill] with implementation plan 2026-05-01 10:20:08 +03:00
5212c303ee docs(wiki): pulling-before-work — design spec for pull-before-work skill 2026-05-01 10:15:55 +03:00
0c8ee69e90 chore: upgrade project structure (bootstrap re-run) 2026-04-30 15:17:46 +03:00
68fe9a8c1c feat(project-bootstrap): v1.3.0 — idempotent CLAUDE.md merge on upgrade
Step 5 was binary on upgrade (append whole template / leave alone), so
projects bootstrapped before v1.2.0 silently missed new canonical triggers
(`check across all projects`, `we're on Windows`) on re-run. Now upgrade
reads existing CLAUDE.md, substring-diffs vs template, preserves a
deliberately-pinned platform line, and appends only missing lines after
explicit confirm. Re-runs are no-ops.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-30 15:06:06 +03:00
0b1b0555d1 docs(wiki): reflect Step 5.7 stance change — accepted as future work
projects-meta-skills.md "Bootstrap trigger" section + log decision entry
now show Step 5.7 (projects-meta-mcp dependency detector) as accepted
future work rather than a deliberate non-decision. Tracked as  Ready
task [bootstrap-recommend-projects-meta].

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-30 01:26:18 +03:00
7771b97b75 meta(tasks): open [bootstrap-recommend-projects-meta] as ready
Follow-up to [bootstrap-projects-meta-trigger] (commit b120397). Mirrors
Step 5.6 (superpowers recommendation) for projects-meta-mcp. Deferred
until we see a real fresh-machine bootstrap silently miss the dep.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-30 01:10:03 +03:00