You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .claude-plugin/marketplace.json
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -10,8 +10,8 @@
10
10
{
11
11
"name": "okf-graph-eng",
12
12
"source": "./",
13
-
"description": "Graph engineering for OKF repos \u2014impact analysis, agent/harness graphs, progressivedisclosure, typed edges, TicketLink/worklog bridges. Works in Claude Code and Grok Build.",
"description": "Graph engineering for OKF repos \u2014 impact analysis, agent/harness graphs, progressive disclosure, typed edges, TicketLink/worklog bridges, and curation. Works in Claude Code and Grok Build.",
3
+
"version": "0.8.0",
4
+
"description": "OKF graph engine: validate, walk, pack, and impact-analyze Git-native knowledge graphs. Owns Catalog and ContextPack. Domain nouns live in PKC, SAC, DEKC, and AGER.",
"description": "Graph engineering for OKF repositories \u2014 impact analysis, progressive disclosure, typed edges, and fail-closed post-edit validate. Codex-compatible packaging for the same skills and hooks used by Claude Code and Grok Build.",
3
+
"version": "0.8.0",
4
+
"description": "OKF graph engine: validate, walk, pack, and impact-analyze Git-native knowledge graphs. Owns Catalog and ContextPack. Domain nouns live in PKC, SAC, DEKC, and AGER.",
Copy file name to clipboardExpand all lines: .cursor-plugin/plugin.json
+4-4Lines changed: 4 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
{
2
2
"name": "okf-graph-eng",
3
-
"version": "0.7.4",
4
-
"description": "Graph engineering for OKF repositories \u2014impact analysis, agent/harness graphs, progressive disclosure, typed edges, TicketLink/worklog bridges, and write isolation bindings for multi-host agents.",
3
+
"version": "0.8.0",
4
+
"description": "OKF graph engine: validate, walk, pack, and impact-analyze Git-native knowledge graphs. Owns Catalog and ContextPack. Domain nouns live in PKC, SAC, DEKC, and AGER.",
Copy file name to clipboardExpand all lines: .grok-plugin/marketplace.json
+3-3Lines changed: 3 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -1,13 +1,13 @@
1
1
{
2
2
"name": "okf-plugin-marketplace",
3
3
"description": "Optional native Grok marketplace metadata. Grok Build already loads Claude plugins with zero config; this file pins identity for Grok marketplace listings.",
{"actor":"unknown","ev":"01M0SZF33A774M689P869HD5G1","git":"ef1ce4c","item":"01M0SZF33A0WAYMDR6QFEZ2AFH","op":"create","set":{"acceptance_criteria":"Core schemas are BaseConcept+Catalog+ContextPack; README lists those nouns; TicketLink CLI is a stub; tests pass; PR opened.","body":"Make okf-plugin a noun-free graph engine. Domain types move to PKC/SAC/DEKC/AGER. Rewrite README around ContextPack read-path optimization.","estimate":"L","kind":"feature","level":"story","milestone":"v0.8.0","priority":"P1","status":"todo","title":"Split domain nouns out of okf-plugin (Catalog + ContextPack only)"},"ts":"2026-08-24T13:30:56Z"}
- Treat Markdown + YAML as a directed graph (absolute links + optional `links[].rel`)
19
+
-**Validate** the bundle
20
+
- Compute **impact** (blast radius) before structural edits
21
+
- Emit **ContextPacks** — hop-capped, node-capped, outbound-only by default
22
+
23
+
This plugin does **not** own domain nouns. It owns the envelope (`BaseConcept`) and two infrastructure types:
24
+
25
+
| Noun | Role |
26
+
|------|------|
27
+
|`Catalog`| Directory index. Structural. Pack walks skip flooding through hub catalogs by using outbound-only BFS. |
28
+
|`ContextPack`| Generated progressive-disclosure view of a ranked, hop-capped subgraph. |
29
+
30
+
Domain types live in sibling plugins. Unknown `type` values fall back to `BaseConcept` (`type` + `title` only). Validators merge sibling `schemas/okf-concepts/` directories.
|[SAC](https://github.com/SpillwaveSolutions/system-architecture-capture)| System, Service, Component, and the rest of the architecture/runtime topology set |
-**Sample** — `sample-okf/` (Catalog + Knowledge about this engine; not an AGER graph)
30
47
31
48
Plugin root variable in Claude/Grok plugin context: `${CLAUDE_PLUGIN_ROOT}`.
32
49
33
50
## Operating principles
34
51
35
52
1. Prefer **okf / okfcli** for graph ops; fallback to `scripts/okf-graph.py`.
36
-
2. Always consider **impact** before changing high-degree or harness concepts.
37
-
3. Emit **minimal context packs** (2-hop default) for long runs.
53
+
2. Always consider **impact** before changing high-degree or schema-declared high-impact concepts (`x-impact` on the owning plugin’s schema). Isolated, this plugin has no high-impact types.
54
+
3. Emit **minimal context packs** (2-hop default, max 20 nodes, outbound-only) for long runs.
38
55
4. Use **absolute** in-bundle Markdown links.
39
56
5. Complete YAML frontmatter on every concept (`type`, `title`, `description`, `timestamp`).
8. Working in an isolated worktree: verify your base commit with
59
+
8. Do not author domain nouns here. Hand `AgentNode` / `Workflow` to AGER, `TicketLink` / `DecisionRecord` to PKC, architecture types to SAC, data-plane types to DEKC.
60
+
9. Working in an isolated worktree: verify your base commit with
43
61
`git log --oneline -3` before writing code. A worktree may be cut from the
44
62
repo default branch rather than the branch you were told to build on, so the
45
63
commits you depend on can be missing. `git reset --hard <intended-branch>`
46
64
while the tree is clean, then build.
47
-
9. Merge PRs with `gh pr merge --merge`, never `--squash`. Frozen documents are
48
-
stamped with the commit they were written against and `worklog doc-verify`
49
-
resolves their code citations at that commit; a squash keeps that commit off
50
-
the default branch, so a fresh clone cannot resolve it.
65
+
10. Merge PRs with `gh pr merge --merge`, never `--squash`. Frozen documents are
66
+
stamped with the commit they were written against and `worklog doc-verify`
67
+
resolves their code citations at that commit; a squash keeps that commit off
68
+
the default branch, so a fresh clone cannot resolve it.
Invoke **graph-engineer** for multi-step dual-graph work (impact + pack + curation in one arc).
84
+
Invoke **graph-engineer** for multi-step graph work (impact + pack + curation in one arc). Pack-first. Impact-before-structure. No domain-noun authorship.
0 commit comments