AGENTS.md · diff

git:20260909.7a107eb to git:20260911.29757b6

5 added, 0 removed. Audit A to A.

<!--

See LICENSE for terms.

-->

# AGENTS.md — JGS SysML v1 Read Skills

Agent-facing index for this repository. A coding agent dropped into a clone should start here.

## What this repo is

18 free, read-only analysis skills for SysML v1 models in CATIA Magic

(MSOSA), driven by the `/jgs-v1` dispatcher over the `jgs-magic-sysmlv1-mcp` bridge

(FREE tier). Proprietary of JG Systems Consulting Ltd, free of charge; see `LICENSE`.

## Install (copy-paste)

```bash

python install.py --dry-run # preview: lists skills and target

python install.py # install for Claude Code (default)

python install.py --agent all # all user-global agents (ZCode, Claude Code, OpenClaw, Copilot, Codex, Gemini)

```

Then restart the agent and invoke `/jgs-v1 <request>`. Flat install for short-name

discovery; `--target PATH` and `$CLAUDE_CONFIG_DIR` override locations.

## Verify

```bash

python install.py --list-agents # supported agents and paths

python scripts/check_release.py # release gate (required files, leaks, versions)

```

## Where things live

- `SKILLS.md` — generated index of every skill (name + description).

- `skills/jgs-v1*/SKILL.md` — the skills themselves; each has `## When to use` and `## Prerequisites`.

- `docs/skill-usage.md` — invoke guide: dispatcher, direct invocations, PRO boundary, troubleshooting.

- `docs/other-agents.md` — per-agent install targets and invoke syntax.

- `README.md` — full product overview, agent-install prompt, feedback channels.

- `RELEASE-INFO.txt` — version and tag for this staged release.

## Rules for agents working in this clone

- Read `README.md` and `docs/skill-usage.md` before changing anything user-facing.

- Never edit `SKILLS.md` or `RELEASE-INFO.txt` by hand; they are generated at release time.

- Do not add model content, file paths, or credentials to any file; the release gate scans for leaks.

- Report gaps via `/jgs-v1-feedback` (in-pack) or the issue forms; do not open pull requests

against this release repo (fixes are applied upstream by the maintainer).

+ - Documentation ownership:

+ - `docs/skill-usage.md`, `docs/other-agents.md` — durable in this pack; edit here.

+ - `docs/index.html`, `docs/guide.html`, `docs/site.css`, `docs/DISTRIBUTION.md` — generated by the upstream release stager (template path lives in the monorepo, not this clone); edit upstream only; restage refreshes this clone.

+ - `SKILLS.md`, `RELEASE-INFO.txt` — generated at release time; never hand-edit.

+ - Before each public restage or tag, the maintainer checks staged site version and skill count against README and `SKILLS.md`.