vitya
6d503b16dc
Step 1 now ships agent meta-paths inversions (`!.claude/`, `!.tasks/`, `!.wiki/`, `!.brainstorm/`, `!.archive/`, `!.mcp/`, `!.mcp.json`, `!MEMORY.md`) so own greenfield/upgrade projects re-enable visibility against the global `core.excludesFile` cutter (`~/.config/git/ignore`) that hides obvyaska from forks of upstream open-source. Without it any fresh bootstrap landed an empty first commit on machines with the global configured: setup-wiki/setup-tasks/Step 5 created .wiki/.tasks/CLAUDE.md but git ignored them. Two cases handled in Step 1: - no .gitignore → write template (block included unconditionally) - existing .gitignore → marker-based (`# AI обвеска — слой 2:`) append-if-missing; idempotent on re-run Smoke-tested in %TEMP%\test-bootstrap-meta-iso: all 3 acceptance criteria pass + negative control (strip block → global hides) + idempotency (re-run with marker present skips). Source concept: workshop wiki concepts/meta-out-of-repo.md. Closes board task [meta-isolation-bootstrap-skill-update]. MINOR bump (1.10.1 → 1.11.0) — new feature, backward-compat. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
3.0 KiB
3.0 KiB
title, type, updated
| title | type | updated |
|---|---|---|
| project-bootstrap meta-isolation block | concept | 2026-05-10 |
project-bootstrap meta-isolation block
project-bootstrap v1.11.0 ships a meta-isolation block in the local .gitignore it creates / appends. Block contains !-inversions for .claude/, .tasks/, .wiki/, .brainstorm/, .archive/, .mcp/, .mcp.json, MEMORY.md.
Why
The global core.excludesFile (~/.config/git/ignore) hides agent meta-paths from forks of upstream open-source — see workshop wiki concepts/meta-out-of-repo.md (sections "Слой 2", "Новые проекты"). Without slой 2 in own repos, setup-wiki / setup-tasks / Step 5 produce .wiki/, .tasks/, CLAUDE.md, but git ignores them and the bootstrap commit lands empty of obvyaska. Empirically reproduced before the fix; smoke test in assets/.gitignore.template greenfield confirms.
In-skill design choices
- Marker comment —
# AI обвеска — слой 2:(case-sensitive substring) used to detect the block on upgrade-case append. Comment text matches workshop wiki concept; chosen over checking for!.tasks/line because users may add their own ad-hoc!-rules unrelated to this block. - Append-only on upgrade — never rewrite or reorder existing
.gitignore. Same discipline as Step 5's CLAUDE.md merge (idempotent, append missing). - Block applied unconditionally in current modes. Bootstrap's three modes (greenfield-full, add-remote, upgrade) all assume the user owns the repo. Greenfield-full creates a fresh Gitea repo; add-remote and upgrade operate on user repos. There is no fork-of-upstream mode today — if added, the block must be omitted there (putting
!.claude/into a fork's.gitignorewould diverge from upstream's ignore semantics). - Template change is the load-bearing edit — greenfield projects pick up the block by template copy. Upgrade-case append handles existing repos that bootstrapped before v1.11.0 (or were created without bootstrap).
Acceptance proven
Smoke test on greenfield (%TEMP%\test-bootstrap-meta-iso):
.gitignorefrom template contains the block — ✓..tasks/_smoke.mdshows as untracked ingit status— ✓.- First-commit candidate set includes
.tasks/,.wiki/,.claude/,.brainstorm/,MEMORY.md— ✓. - Negative control — strip block, status hides all meta-paths (only
.gitignoreitself remains visible). Confirms global excludesFile is the cutter and slой 2 is what restores visibility — ✓. - Upgrade-case append idempotent — second run with marker present skips — ✓.
Pointers
- Source concept:
~/projects/.workshop/.wiki/concepts/meta-out-of-repo.md - Sister action-item:
[meta-isolation-existing-repos-migration]inOpeItcLoc03/workshop— one-off migration of existing own repos. - Long-term:
[meta-isolation-mcp-sync-extension]inOpeItcLoc03/common— extendprojects-meta-mcpto sync.wiki/+.claude/skills/so meta-paths can leave repo entirely.