Skip to content

fix: keep Claude install source out of skill root#1204

Open
ofnullable wants to merge 4 commits intogarrytan:mainfrom
ofnullable:fix/claude-runtime-root
Open

fix: keep Claude install source out of skill root#1204
ofnullable wants to merge 4 commits intogarrytan:mainfrom
ofnullable:fix/claude-runtime-root

Conversation

@ofnullable
Copy link
Copy Markdown

@ofnullable ofnullable commented Apr 25, 2026

Summary

  • Move global Claude source installs out of ~/.claude/skills/gstack and into ~/.gstack/repos/gstack so Claude does not recursively discover host-specific generated skills.
  • Recreate ~/.claude/skills/gstack as a runtime-only sidecar for shared binaries/assets, including browse, design, make-pdf, review, and QA resources.
  • Preserve contributor/dev-mode behavior where project-local .claude/skills/gstack remains a symlink to the working tree, and document the source-checkout vs sidecar split.

Fixes #1202.

Commit structure

  1. fix: keep Claude install source out of skill root — installer, resolver, host config, and regression coverage.
  2. chore: regenerate skill docs — generated SKILL.md output only.
  3. docs: explain Claude source checkout and sidecar — README/contributor/maintainer docs only.

Verification

  • bash -n setup && bash -n bin/dev-setup && bash -n bin/dev-teardown && bash -n bin/gstack-team-init
  • bun test test/gen-skill-docs.test.ts --test-name-pattern "setup script validation"
  • bun test test/setup-codesign.test.ts
  • bun test test/host-config.test.ts
  • bun test test/team-mode.test.ts
  • bun run gen:skill-docs --host all --dry-run
  • bun run build

Move the global Claude source checkout to ~/.gstack/repos/gstack and keep ~/.claude/skills/gstack as a runtime-only sidecar so Claude does not recursively discover host-specific generated skills.
Refresh generated skill docs after the Claude source/root resolver changes so checked-in outputs match the templates.
Document the split between the ~/.gstack/repos/gstack source checkout and the ~/.claude/skills/gstack runtime sidecar for users and contributors.
@ofnullable ofnullable force-pushed the fix/claude-runtime-root branch from 93d5c60 to 34fe7c6 Compare April 25, 2026 05:52
@ofnullable ofnullable force-pushed the fix/claude-runtime-root branch from 3ab41bb to 6c576f5 Compare April 25, 2026 14:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Claude install exposes full repo under skill discovery root

1 participant