Skip to content

Commit 5738436

Browse files
chore: scope published .claude bundle + housekeeping (#25)
* chore: scope published .claude bundle, fix changelog date, ignore local lock - package.json files[]: replace the broad ".claude" entry with the supaschema bundle subpaths (.claude/hooks, .claude/rules, .claude/settings.json, .claude/skills/supaschema). The broad entry shipped 6 unrelated .claude/skills/gitnexus/** SKILL.md files (local dev tooling) in the npm tarball; the consumer-facing agent bundle is unchanged. - CHANGELOG.md: 0.1.1 was published 2026-06-14, not 2026-06-12. - .gitignore: ignore .claude/scheduled_tasks.lock and .claude/plans (local runtime artifacts) so they never enter a commit or local pack. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * chore: keep packaged agent docs consistent with the scoped bundle The shipped AGENTS.md/CLAUDE.md carried an auto-injected GitNexus block referencing .claude/skills/gitnexus/** — now excluded from the tarball — so a consumer following the bundled guidance hit missing skill files. - Strip the GitNexus 'Code Intelligence' block from AGENTS.md (it is local dev tooling for this repo, not consumer-facing operator guidance). - Drop CLAUDE.md from files[]: it is just '@AGENTS.md' plus the same local GitNexus block — not consumer content. Consumers get AGENTS.md and the .claude/.codex/.agents supaschema bundle directly. npm pack --dry-run now ships zero gitnexus/CLAUDE.md references. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
1 parent a51d293 commit 5738436

4 files changed

Lines changed: 7 additions & 47 deletions

File tree

.gitignore

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,3 +10,5 @@ benchmarks/results
1010
.envrc
1111
.mcp.json
1212
.gitnexus
13+
.claude/scheduled_tasks.lock
14+
.claude/plans

AGENTS.md

Lines changed: 0 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -89,47 +89,3 @@ npm run docs:check # Mintlify validation, links, accessibility
8989
- For package, release, or bundled agent-surface changes, run `npm run check:package` or `npm pack --dry-run` as appropriate.
9090
- For docs-only changes, run `npm run docs:check` when Mintlify pages or navigation are touched.
9191
- Before merge or release, `npm run check`, `npm run check:package`, `npm run fixture:verify`, `npm run corpus:check`, and the relevant benchmark/docs checks should be clean.
92-
93-
<!-- gitnexus:start -->
94-
# GitNexus — Code Intelligence
95-
96-
This project is indexed by GitNexus as **supaschema** (3480 symbols, 6337 relationships, 300 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.
97-
98-
> If any GitNexus tool warns the index is stale, run `npx gitnexus analyze` in terminal first.
99-
100-
## Always Do
101-
102-
- **MUST run impact analysis before editing any symbol.** Before modifying a function, class, or method, run `gitnexus_impact({target: "symbolName", direction: "upstream"})` and report the blast radius (direct callers, affected processes, risk level) to the user.
103-
- **MUST run `gitnexus_detect_changes()` before committing** to verify your changes only affect expected symbols and execution flows.
104-
- **MUST warn the user** if impact analysis returns HIGH or CRITICAL risk before proceeding with edits.
105-
- When exploring unfamiliar code, use `gitnexus_query({query: "concept"})` to find execution flows instead of grepping. It returns process-grouped results ranked by relevance.
106-
- When you need full context on a specific symbol — callers, callees, which execution flows it participates in — use `gitnexus_context({name: "symbolName"})`.
107-
108-
## Never Do
109-
110-
- NEVER edit a function, class, or method without first running `gitnexus_impact` on it.
111-
- NEVER ignore HIGH or CRITICAL risk warnings from impact analysis.
112-
- NEVER rename symbols with find-and-replace — use `gitnexus_rename` which understands the call graph.
113-
- NEVER commit changes without running `gitnexus_detect_changes()` to check affected scope.
114-
115-
## Resources
116-
117-
| Resource | Use for |
118-
|----------|---------|
119-
| `gitnexus://repo/supaschema/context` | Codebase overview, check index freshness |
120-
| `gitnexus://repo/supaschema/clusters` | All functional areas |
121-
| `gitnexus://repo/supaschema/processes` | All execution flows |
122-
| `gitnexus://repo/supaschema/process/{name}` | Step-by-step execution trace |
123-
124-
## CLI
125-
126-
| Task | Read this skill file |
127-
|------|---------------------|
128-
| Understand architecture / "How does X work?" | `.claude/skills/gitnexus/gitnexus-exploring/SKILL.md` |
129-
| Blast radius / "What breaks if I change X?" | `.claude/skills/gitnexus/gitnexus-impact-analysis/SKILL.md` |
130-
| Trace bugs / "Why is X failing?" | `.claude/skills/gitnexus/gitnexus-debugging/SKILL.md` |
131-
| Rename / extract / split / refactor | `.claude/skills/gitnexus/gitnexus-refactoring/SKILL.md` |
132-
| Tools, resources, schema reference | `.claude/skills/gitnexus/gitnexus-guide/SKILL.md` |
133-
| Index, status, clean, wiki CLI commands | `.claude/skills/gitnexus/gitnexus-cli/SKILL.md` |
134-
135-
<!-- gitnexus:end -->

CHANGELOG.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Changelog
22

3-
## 0.1.1 (2026-06-12)
3+
## 0.1.1 (2026-06-14)
44

55
- Documentation site at supaschema.com: the Mintlify site moves to monorepo mode with the content root at `docs/`, an expanded information architecture (per-command reference pages, concept deep-dives, environments/database-URL resolution, Supabase integration guide, library API reference), and redirects from every legacy `/docs/*` URL.
66
- Agent auto-run diff hooks: a PostToolUse hook for Claude Code and Codex senses a write to a schema-tree `.sql` file, runs `supaschema diff` then `supaschema check` to completion, and returns the generated migration name — or the blocking `SUPA_*` diagnostic — back to the agent as context. Wired in `.claude/settings.json` and `.codex/hooks.json`; the rules, skills, and `AGENTS.md` bundle describes the behavior.

package.json

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,10 +24,12 @@
2424
},
2525
"files": [
2626
".agents",
27-
".claude",
27+
".claude/hooks",
28+
".claude/rules",
29+
".claude/settings.json",
30+
".claude/skills/supaschema",
2831
".codex",
2932
"AGENTS.md",
30-
"CLAUDE.md",
3133
"benchmarks/README.md",
3234
"benchmarks/compare.js",
3335
"benchmarks/fixtures",

0 commit comments

Comments
 (0)