# Sem Inspect Weave

> Semantic version control workflow: sem (structural truth) -> inspect (review prioritization) -> weave (coordination + merge semantics).

- Skill: `timseriakov/sem-inspect-weave` (Agent Skill, multi-file: 12 files)
- Install (CLI): `npx skillmds@latest add timseriakov/sem-inspect-weave`
- Raw SKILL.md: https://api.skillmd.com/api/skills/timseriakov/sem-inspect-weave/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: timseriakov (https://skillmd.com/u/timseriakov)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/timseriakov/sem-inspect-weave

---


# Sem / Inspect / Weave

This skill teaches a single coherent workflow:

sem -> inspect -> weave

Use it when you need entity-level understanding (functions/classes/properties), risk-focused review prioritization, and safe merge/coordination semantics.

## When to Use

- Semantic or entity-level diff analysis (not just line diffs)
- Impact questions (what else breaks if this entity changes?)
- Risk triage (what deserves careful review first?)
- Branch integration prep / semantic conflict analysis
- Multi-agent overlap (avoid false conflicts)

## When Not to Use

- Trivial changes where direct reading is cheaper
- Any workflow that would mutate repo merge configuration by default

## Reasoning Model

1. Discover changes -> sem
2. Understand impact -> sem impact / sem graph / sem blame
3. Prioritize review -> inspect
4. Coordination + merge semantics -> weave

## Tool Roles

| Tool      | Core Role                      | Notes                                                                                                         |
| --------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------- |
| `sem`     | structural truth               | Entity-level diff/graph/impact/blame. Establishes what changed.                                               |
| `inspect` | review prioritization          | Classifies + risk-scores entities (blast radius, dependents, public API) and groups changes for review order. |
| `weave`   | coordination + merge semantics | Entity-level merge semantics and optional advisory coordination (claims).                                     |

## Trigger Phrases

- semantic diff
- entity-level diff
- use sem to analyze changes
- review this change semantically
- analyze impact of this change
- find risky entities in this diff
- prioritize review for this commit
- prepare safe merge
- detect semantic conflicts

## Typical Workflows

### Review last commit

```bash
sem diff --from HEAD~1 --to HEAD --format json
inspect diff HEAD~1 --format json
```

### Review branch vs main

```bash
sem diff --from origin/main --to HEAD --format json
inspect diff origin/main..HEAD --format json
```

### Analyze refactor impact

```bash
sem impact <entity>
sem graph
```

### Prepare merge safely

```bash
weave preview main
```

## Weave Safety Rules

Run weave only when:

- merge conflicts exist
- multiple agents/branches touched the same entities or adjacent semantic areas
- preparing branch integration
- semantic conflict context is explicitly needed

Never run `weave setup` unless the user explicitly asks (it mutates repo merge-driver configuration).

## Wrapper Policy

Scripts in `scripts/` are optional helpers.

- You may call `sem`, `inspect`, and `weave` directly.
- Use wrappers only to standardize structured output and reduce boilerplate.

## Output Contract

1. Structural changes (entities) from sem.
2. Review hotspots and risk ranking from inspect.
3. Merge/coordination risks from weave (or explicitly state weave was not needed).