---
created: 2026-04-30
modified: 2026-04-30
type: feature_flag_manifest
status: active
ontology_id: laws-of-ux-v1
isolation: strict
revertible: true
tags: [ontology, design-system, isolation-manifest, laws-of-ux]
---

# FEATURE_FLAGS — Laws of UX Ontology v1

This manifest lists every artifact added by the Laws of UX ontology integration. To revert: delete every path listed below and `git revert` the integration commit. No design-system files outside this manifest are modified.

## Isolation guarantees

1. **No mutation of existing skills.** New skills live in their own folders.
2. **No mutation of existing InfraNodus graphs.** New graph is namespaced `shuriq-design-ontology-v1`.
3. **No mutation of `shuriq-motion`.** Cavalry recreations live under this ontology folder, referencing shuriq-motion's validated API only as a read-only dependency.
4. **No mutation of existing report-studio code.** The skills are loaded by name only when the user invokes them; they have no global hooks.

## Tracked artifacts

### New skills (~/.dotfiles/ai/skills/)
- `laws-of-ux/` — 30-card UX ontology skill
- `design-rubric-complex-apps/` — supplemental NN/g 8-guidelines rubric

### New ontology folder (this folder)
- `cards/` — 30 concept cards as structured markdown
- `graphs/` — InfraNodus graph exports (`shuriq-design-ontology-v1.json`)
- `cavalry-scenes/` — `.scn` files, one per concept
- `svg-fallbacks/` — inline animated SVG, one per concept
- `research/` — video-frame captions, motion cadence notes
- `site/` — Perceptagon-style gallery + blog post
- `FEATURE_FLAGS.md` — this file

### New InfraNodus graphs
- `shuriq-design-ontology-v1` (created via mcp__infranodus__create_knowledge_graph)

## Revert procedure

```bash
# 1. Remove skill folders
rm -rf ~/.dotfiles/ai/skills/laws-of-ux
rm -rf ~/.dotfiles/ai/skills/design-rubric-complex-apps

# 2. Remove ontology folder
rm -rf /Users/jonnydubowsky/Documents/totem-terminal/projects/shur/shuriq-design-system/ontology-laws-of-ux-v1

# 3. Delete InfraNodus graph (manual via UI or API)
# graph: shuriq-design-ontology-v1

# 4. Revert git commit
git log --grep="laws-of-ux ontology v1" --oneline
git revert <SHA>
```

## Inheritance & boundaries

- **Reads from:** `~/.dotfiles/ai/skills/shuriq-motion/references/cavalry-api.md` (validated API surface)
- **Writes to:** Only paths listed above
- **Does not touch:** `shuriq-motion`, `infranodus-viz-designer`, existing report studio code, existing graphs

## Status log

| Date | Phase | Status | Notes |
|---|---|---|---|
| 2026-04-30 | Phase 1 | in-progress | Ontology + skills + rubric |
| 2026-04-30 | Phase 2 | pending | Cavalry recreation of 30 concepts |
| 2026-04-30 | Phase 3 | pending | Perceptagon site + comparative eval |