AGENTS.md git:20260911.1af4ed8A

Immutable. This exact content never changes and is served at /api/v1/blob/7cc20199ca8cc47e.

<!--
Copyright (c) 2026 JG Systems Consulting Ltd. All Rights Reserved.
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`.

<!-- repo-cold-start:index:start -->
## Agent index (repo-cold-start)

See root [ARCHITECTURE.md](./ARCHITECTURE.md) for purpose, parts, boundaries, and entry points.
<!-- repo-cold-start:index:end -->

<!-- repo-cold-start:arch-link:start -->
[ARCHITECTURE.md](./ARCHITECTURE.md)
<!-- repo-cold-start:arch-link:end -->