@ericrisco/rsc 0.1.34 → 0.1.36

package/skills/godot/references/gdscript-style.md

@@ -0,0 +1,84 @@
+# GDScript style & formatting cheat-sheet (Godot 4.x)
+
+Mirrors the official GDScript style guide. When in doubt, run the editor's built-in formatter
+(Ctrl/Cmd+Shift+I) and `gdformat` (from `gdtoolkit`) in CI.
+
+## Naming
+
+| Thing | Case | Example |
+| --- | --- | --- |
+| File (script/scene) | `snake_case` | `player_controller.gd`, `main_menu.tscn` |
+| `class_name` / type | `PascalCase` | `class_name EnemyStats` |
+| Node name in tree | `PascalCase` | `HealthBar`, `AttackTimer` |
+| Variable / function | `snake_case` | `var max_health`, `func take_damage()` |
+| Signal | `snake_case`, past tense | `signal health_depleted` |
+| Constant | `CONSTANT_CASE` | `const MAX_SPEED := 400.0` |
+| Enum type / members | `PascalCase` / `CONSTANT_CASE` | `enum State { IDLE, RUN }` |
+| Private (convention) | leading underscore | `var _internal_timer` |
+| Virtual/lifecycle | leading underscore | `_ready`, `_process`, `_on_body_entered` |
+
+## Formatting
+
+- **Tabs** for indentation (not spaces). Editor default.
+- Lines **< 100 columns**.
+- One space around binary operators (`a + b`, `x := 1`), none inside call parens.
+- Two blank lines between functions at top level; one inside classes as needed.
+- Prefer `:=` (inferred) when the RHS makes the type obvious; `: Type =` when it does not.
+
+## Typed by default
+
+```gdscript
+var speed: float = 300.0          # explicit annotation
+var dir := Vector2.ZERO           # inferred
+var slots: Array[Item] = []       # typed collection
+const GRAVITY := 980.0
+
+func heal(amount: int) -> void:   # typed params AND return
+    _health = mini(_health + amount, _max_health)
+
+func find_target() -> Node2D:     # return type declared
+    return get_tree().get_first_node_in_group("player")
+```
+
+- Declare `-> void` on functions that return nothing; declare the real type otherwise.
+- Use `as` for safe downcasts: `var e := body as Enemy` → `null` on mismatch (no crash).
+- Avoid untyped `var x` and `Variant` params — they disable the compiler's checks and the VM's
+  typed fast paths.
+
+## Script layout order (recommended top-to-bottom)
+
+1. `@tool` (if any) — must be the very first line.
+2. `class_name` then `extends` (or `extends` alone).
+3. `## docstring` comment.
+4. `signal` declarations.
+5. `enum` / `const`.
+6. `@export` vars, then plain member vars, then `@onready` vars.
+7. Built-in virtuals: `_init`, `_ready`, `_process`, `_physics_process`, `_input`, …
+8. Public methods, then private (`_underscore`) methods, then signal handlers (`_on_*`).
+
+```gdscript
+@tool
+class_name Turret extends Node2D
+## Auto-aiming turret; @export the fire rate in the inspector.
+
+signal fired(at: Vector2)
+
+const MAX_RANGE := 600.0
+enum Mode { IDLE, TRACKING }
+
+@export var fire_rate := 2.0
+var _cooldown := 0.0
+@onready var muzzle: Marker2D = %Muzzle
+
+func _physics_process(delta: float) -> void:
+    _cooldown = maxf(_cooldown - delta, 0.0)
+
+func _on_area_entered(_area: Area2D) -> void:
+    pass
+```
+
+## Common built-in math helpers (Godot 4 names)
+
+`absf/absi`, `minf/mini`, `maxf/maxi`, `clampf/clampi`, `snappedf`, `lerpf`, `move_toward`,
+`deg_to_rad` / `rad_to_deg`, `randf_range`, `randi_range`. The unsuffixed `abs/min/max/clamp` still
+work on Variants but the typed suffixed forms are faster and clearer.

package/skills/godot/references/godot3-to-4-traps.md

@@ -0,0 +1,89 @@
+# Godot 3 → 4.x migration ban-list (full table)
+
+Godot 4 is a hard break from 3.x. The engine ships a project converter, but it does **not** catch
+everything — and an agent generating fresh code must simply never emit the left column. Use this as
+the authoritative reference when porting or reviewing.
+
+## Won't-parse renames (hard errors)
+
+| Godot 3 | Godot 4.x | Note |
+| --- | --- | --- |
+| `yield(obj, "signal")` | `await obj.signal` | Coroutines are now `await`; the function must not need `yield`'s return-value trick. |
+| `yield(get_tree().create_timer(1),"timeout")` | `await get_tree().create_timer(1.0).timeout` | |
+| `onready var` | `@onready var` | Annotation. |
+| `export var` / `export(int) var` | `@export var` / `@export_range(...) var` | Typed annotations replace the `export(Type)` hint syntax. |
+| `tool` | `@tool` | Must be the first line. |
+| `remote`/`master`/`puppet func` | `@rpc(...)` annotations | Networking model changed entirely. |
+| `setget set_fn, get_fn` | `set(v): ...` / `get: ...` inline accessors | |
+
+## Node / class renames
+
+| Godot 3 | Godot 4.x |
+| --- | --- |
+| `Spatial` | `Node3D` |
+| `KinematicBody` / `KinematicBody2D` | `CharacterBody3D` / `CharacterBody2D` |
+| `Area` | `Area3D` |
+| `RigidBody` / `StaticBody` | `RigidBody3D` / `StaticBody3D` |
+| `Sprite` | `Sprite2D` |
+| `Sprite3D` | `Sprite3D` (unchanged) |
+| `AnimatedSprite` | `AnimatedSprite2D` |
+| `CollisionShape` | `CollisionShape3D` |
+| `Camera` | `Camera3D` |
+| `Light2D` (old) / `Light` | `PointLight2D` / `DirectionalLight2D` / `OmniLight3D` etc. |
+| `Viewport` (as node) | `SubViewport` (embedded) |
+| `YSort` (node) | `y_sort_enabled` property on `Node2D`/`CanvasItem` |
+| `ARVROrigin` / `ARVRCamera` | `XROrigin3D` / `XRCamera3D` |
+| `Reference` | `RefCounted` |
+| `TileMap` | `TileMapLayer` (one per layer; `TileMap` deprecated 4.3+) |
+
+## Method / API changes
+
+| Godot 3 | Godot 4.x |
+| --- | --- |
+| `scene.instance()` | `scene.instantiate()` |
+| `move_and_slide(velocity, up_direction)` | set `velocity` property → `move_and_slide()` (no args) |
+| `move_and_slide_with_snap(...)` | set `floor_snap_length` → `move_and_slide()` |
+| `connect("sig", obj, "method", [args])` | `obj.sig.connect(method.bind(args))` (Callable) |
+| `disconnect("sig", obj, "method")` | `obj.sig.disconnect(method)` |
+| `emit_signal("sig", a)` | `sig.emit(a)` (string form still exists but prefer the property) |
+| `is_connected("sig", obj, "m")` | `sig.is_connected(m)` |
+| `call_deferred("method", a)` | `method.bind(a).call_deferred()` or `call_deferred("method", a)` |
+| `File.new()` + `open()` | `FileAccess.open(path, FileAccess.READ)` |
+| `Directory.new()` | `DirAccess.open(path)` / `DirAccess.dir_exists_absolute(...)` |
+| `OS.get_ticks_msec()` | `Time.get_ticks_msec()` |
+| `OS.get_datetime()` | `Time.get_datetime_dict_from_system()` |
+| `PoolByteArray` / `PoolStringArray` / `PoolVector2Array` | `PackedByteArray` / `PackedStringArray` / `PackedVector2Array` |
+| `Tween` node + `interpolate_property` | `var t := create_tween(); t.tween_property(node, "position", target, 0.5)` |
+| `rand_range(a, b)` | `randf_range(a, b)` (float) / `randi_range(a, b)` (int) |
+| `deg2rad` / `rad2deg` | `deg_to_rad` / `rad_to_deg` |
+| `stepify(x, s)` | `snapped(x, s)` |
+| `.empty()` | `.is_empty()` |
+| `get_node("Path")` still valid | prefer `%UniqueName` for refactor-safety |
+| `KEY_*` / input constants mostly renamed | check `Key`, `MouseButton` enums |
+
+## Silent behavior changes (compile clean, act wrong)
+
+- **`Array.slice(begin, end, step, deep)`** — `end` is **exclusive** in Godot 4 (was inclusive in 3).
+  `[10,20,30,40].slice(1,3)` → `[20,30]`.
+- **`Camera2D.zoom`** — meaning **inverted**. Larger value = zoom **in**. `zoom = Vector2(2,2)`
+  magnifies 2×; in Godot 3 that zoomed out. To zoom out now, use values **below** 1.
+- **Y-sort** is a property (`y_sort_enabled`), not a node — porting a `YSort` parent silently loses
+  sorting unless you set the property.
+- **Physics interpolation / gravity** — read gravity via `get_gravity()` (2D/3D) or
+  `ProjectSettings`; the old default constants changed.
+- **Signal argument order** on some built-in signals changed; verify against the 4.x docs, don't
+  assume the 3.x signature.
+- **`_ready`/`_process` no longer auto-call the base** — you must `super()` when extending a script
+  that defines them.
+- **Integer division** with typed ints truncates as expected; mixing float/int in Godot 4 follows
+  stricter typed rules — annotate to avoid surprises.
+
+## Porting workflow
+
+1. Open the Godot 3 project in Godot 4 → run the built-in **Project Converter** (backs up first).
+2. Fix red parse errors top-down (renames above).
+3. Search the codebase for each string-form `connect(`, `yield(`, `.instance()`, `File.new`,
+   `Directory.new`, `Pool*Array`, `move_and_slide(` with args — the converter misses some.
+4. Fix the silent-breakers deliberately (slice bounds, Camera2D zoom, y-sort) — tests or a manual
+   pass, since nothing errors.
+5. Re-open every scene once; a converter-mangled `.tscn` fails loudly in the editor.

package/skills/godot/references/nodes-scenes-resources.md

@@ -0,0 +1,109 @@
+# Nodes, scenes, scripts & custom Resources (Godot 4.x)
+
+The four building blocks and when each is the right tool. Getting this decomposition right is what
+separates a maintainable Godot project from a monolithic scene that nobody can touch.
+
+## The mental model
+
+- **Node** — a live object in the running tree. It has a transform (2D/3D), can render, process,
+  collide, receive input. Everything on screen is a node. Pick the most specific typed subclass
+  (`Sprite2D`, `Area3D`, `CharacterBody2D`, `Timer`, `AudioStreamPlayer`).
+- **Scene** (`.tscn`) — a saved tree of nodes with a designated **root**, instanceable N times. The
+  reusable unit of a Godot game. A scene can instance other scenes (composition).
+- **Script** (`.gd` / `.cs`) — code attached to one node, giving it behavior. Attach to the scene
+  root; treat children as parts the root drives.
+- **Resource** (`.tres` / `.res`) — a reference-counted **data** object, not in the tree. Textures,
+  audio, materials are Resources; so are your **custom** data classes.
+
+## Composition over inheritance / deep trees
+
+Prefer assembling small scenes over one giant tree or a deep script inheritance chain.
+
+- A `Player` scene = `CharacterBody2D` root + `Sprite2D` + `CollisionShape2D` + `Camera2D` +
+  instanced `HealthComponent` + `HurtboxComponent` sub-scenes.
+- Behaviors as **components**: a `HealthComponent` (its own scene/script exposing `signal died`) can
+  be dropped onto a player, an enemy, or a crate — no shared base class needed.
+- Reach for `extends MyBase` only for genuine "is-a" specialization; reach for composed child nodes
+  for "has-a" behavior. The latter is the Godot-idiomatic default.
+
+## `class_name` — when to register a global type
+
+```gdscript
+class_name HealthComponent extends Node
+signal died
+@export var max_health := 100
+var _current := max_health
+```
+
+- Register (`class_name`) reusable scripts and **all** custom Resources — it enables `is`/`as`
+  checks, `HealthComponent.new()`, and a proper inspector type/slot.
+- Skip it for one-off scene-root scripts that nothing else references by type.
+- Names are global and must be unique across the project.
+
+## Custom Resources — typed game data
+
+Use a custom `Resource` instead of loose `Dictionary`/JSON whenever you have structured game data:
+stats, items, dialogue lines, wave definitions, ability configs. You get inspector editing, type
+safety, `@export` slots, and save/load for free.
+
+```gdscript
+# item.gd
+class_name Item extends Resource
+@export var display_name: String = ""
+@export var icon: Texture2D
+@export var max_stack: int = 99
+@export var value: int = 0
+```
+```gdscript
+# Use it as a typed @export slot on any node:
+@export var starting_items: Array[Item] = []
+
+# Create/save/load in code:
+var potion := Item.new()
+potion.display_name = "Potion"
+ResourceSaver.save(potion, "res://data/potion.tres")
+var loaded := load("res://data/potion.tres") as Item
+```
+
+**Gotcha — shared vs unique**: a Resource assigned in the inspector is **shared by reference** across
+all instances by default. If each node must own its copy (e.g. runtime-mutated stats), enable
+**Local to Scene** on the resource, or `duplicate()` it in `_ready()`. Otherwise mutating one
+enemy's `stats.health` mutates every enemy sharing that `.tres`.
+
+## `preload` vs `load`
+
+| | `preload("res://x")` | `load("res://x")` |
+| --- | --- | --- |
+| Resolved | parse/compile time | runtime, when the line runs |
+| Path | must be a constant literal | can be a variable/computed |
+| Use for | assets you always need; breaks fast if the path is wrong | dynamic/optional assets, avoiding circular preloads |
+| Returns | the Resource/`PackedScene` | same |
+
+```gdscript
+const BULLET := preload("res://bullet.tscn")   # PackedScene, baked in
+func shoot() -> void:
+    var b := BULLET.instantiate()               # -> a Node
+    add_child(b)
+
+# runtime path
+var scene := load("res://enemies/%s.tscn" % enemy_id) as PackedScene
+```
+
+## Instancing & freeing lifecycle
+
+- `PackedScene.instantiate()` → a detached node; add it with `add_child(node)` (or
+  `add_sibling`) to bring it into the tree and trigger `_ready`.
+- Free with `queue_free()` (deferred to end of frame — safe during signals/physics). Avoid `free()`
+  unless you know the node is out of the tree and not mid-callback.
+- After freeing, guard any retained reference with `is_instance_valid(node)` before touching it.
+- `add_child(node, true)` forces a readable unique name; useful when spawning many of one scene.
+
+## `.tscn` / `.tres` are strict text — validation rule
+
+Both formats are line-oriented with a header (`[gd_scene load_steps=N format=3 ...]`),
+`[ext_resource ...]` / `[sub_resource ...]` blocks, and `[node ...]` / property lines. A wrong
+`load_steps` count, a dangling `ExtResource("x")` id, or a malformed `[node]` path makes Godot
+refuse to open the file. **Do not machine-generate or hand-edit these beyond trivial value tweaks,
+and always open the project in the editor once before relying on a changed scene** — the editor is
+the only reliable validator. Build data-Resources in code + `ResourceSaver.save()` instead of
+writing `.tres` by hand.

package/skills/harness/SKILL.md

@@ -11,7 +11,7 @@ profiles: [minimal, core, full]
 The **harness** is the control plane of a workspace. A workspace need not be code: it can be a company, an ops desk, a legal archive, a personal knowledge vault. Whatever it is, the harness is the durable apparatus that keeps it operable and legible, made of three parts:
 
 - **`01-TOOLS/<PROVIDER>/`** — the operational tooling layer. One folder per external provider, co-locating credentials (`.env`) with the scripts that consume them. Each tool ships a working `test_connection` against the real API.
-- **`02-DOCS/`** — the **Karpathy chaos→knowledge engine**: a domain-agnostic LLM wiki (`inbox/` + `raw/` + `raw/worklog/` + `wiki/` + `wiki/index.md` + `wiki/log.md` + `wiki/gaps.md` + `wiki/scores.json` + the `.base` views), fully embedded in this skill. It feeds from **two on-ramps**: (1) the user drops **any raw file in any format** (PDF, image, CSV, JSON, txt, html…) into `inbox/`, and an **Auto-Ingest Sweep** ("the agent goes for a walk") extracts, classifies, cross-links, and compiles it — and goes further, **discovering un-ingested documents anywhere in the workspace** (a stray `/transcripts`, `/facturas`…), bounded by `.rscignore` and de-duplicated by the `wiki/.ingested.json` ledger, fired automatically at SessionStart (when the inbox has material) and by the daily cron. Ingest is non-destructive (originals are copied, never moved); removing an emptied folder needs explicit consent; (2) a **Worklog Sweep** captures **what we do** — every meaningful session of work is itself a `raw` source (`raw/worklog/`) compiled into the wiki, fired by a `PreCompact`/`SessionEnd` hook, by an explicit milestone (a commit), or by the daily curation automation (`references/daily-curation-automation.md`). The wiki is **Obsidian-native**: wikilinks, YAML frontmatter (Properties), readable filenames, and `.base` views give a real graph + live tables — structure, **not vector DB / embeddings / RAG**. The agent writes it; the human reads it in Obsidian. See `references/wiki-protocol.md` for the protocol, `references/ingest-formats.md` for the multiformat Fetch, `references/wiki-worklog-template.md` for the work capture, and `references/obsidian-scaffolding.md` for the vault scaffolding. Topics are inferred from content (`finanzas/`, `legal/`, `crm/`…), never hardcoded. The wiki **self-improves continuously**: every Ingest, Sweep and Query triggers a Maintenance Pass (deterministic lint, score recomputation, gap detection, Related/See-Also sweep), and every N interactions a Micro-Improve runs. Deep Improve runs on explicit request or via the scheduled daily curation. No external skill needed.
+- **`02-DOCS/`** — the **Karpathy chaos→knowledge engine**: a domain-agnostic LLM wiki (`inbox/` + `raw/` + `raw/worklog/` + `wiki/` + `wiki/index.md` + `wiki/log.md` + `wiki/gaps.md` + `wiki/scores.json` + the `.base` views), fully embedded in this skill. It feeds from **two on-ramps**: (1) the user drops **any raw file in any format** (PDF, image, CSV, JSON, txt, html…) into `inbox/`, and an **Auto-Ingest Sweep** ("the agent goes for a walk") extracts, classifies, cross-links, and compiles it — and goes further, **discovering un-ingested documents anywhere in the workspace** (a stray `/transcripts`, `/facturas`…), bounded by `.rscignore` and de-duplicated by the `wiki/.ingested.json` ledger, fired automatically at SessionStart (when the inbox has material) and by the daily cron. Ingest keeps the repo clean: a loose file it ingests at the workspace root (or anything in `inbox/`) is **moved into `raw/`** (relocated, never deleted — a dropped PDF ends up in `raw/`, not at the root), while files inside a user-maintained folder are copied and consolidation is proposed; removing a redundant folder needs explicit consent; (2) a **Worklog Sweep** captures **what we do** — every meaningful session of work is itself a `raw` source (`raw/worklog/`) compiled into the wiki, fired by a `PreCompact`/`SessionEnd` hook, by an explicit milestone (a commit), or by the daily curation automation (`references/daily-curation-automation.md`). The `wiki/` is a **100%-OKF-v0.1 bundle** (Google's [Open Knowledge Format](https://github.com/GoogleCloudPlatform/knowledge-catalog/tree/main/okf)) AND an **Obsidian-native** vault at the same time — standard markdown links, OKF-standard YAML frontmatter (Properties), readable filenames, and `.base` views give a real graph + live tables — structure, **not vector DB / embeddings / RAG**. The agent writes it; the human reads it in Obsidian. See `references/wiki-protocol.md` for the protocol, `references/ingest-formats.md` for the multiformat Fetch, `references/wiki-worklog-template.md` for the work capture, and `references/obsidian-scaffolding.md` for the vault scaffolding. Topics are inferred from content (`finanzas/`, `legal/`, `crm/`…), never hardcoded. The wiki **self-improves continuously**: every Ingest, Sweep and Query triggers a Maintenance Pass (deterministic lint, score recomputation, gap detection, Related/See-Also sweep), and every N interactions a Micro-Improve runs. Deep Improve runs on explicit request or via the scheduled daily curation. No external skill needed.
 - **The Knowledge map** — the `## Knowledge map` section of the root `CLAUDE.md` that indexes the wiki (including the `harness/` topic) and is read by every other skill before it works in its area.
 
 `harness` is the **protagonist concept**. `init` is the bootstrap front door — it gauges the user, drafts the profile, and hands off the first scaffold. THIS skill (`harness`) is the **ongoing control**: it audits, migrates, scaffolds, sweeps the inbox, and keeps the wiki, the tooling and the Knowledge map honest over the life of the workspace. It also generates root `CLAUDE.md` and `AGENTS.md`, and migrates legacy `XX-*` numbered folders into the canonical layout.
@@ -105,7 +105,7 @@ harness/
 │   ├── inbox-readme-template.md      ← the inbox/README.md drop-zone contract
 │   ├── wiki-raw-template.md          ← format for raw/<topic>/*.md
 │   ├── wiki-worklog-template.md      ← format for raw/worklog/*.md (work-driven capture)
-│   ├── wiki-article-template.md     ← format for wiki/<topic>/*.md (Obsidian frontmatter + wikilinks)
+│   ├── wiki-article-template.md     ← format for wiki/<topic>/*.md (OKF frontmatter + markdown links)
 │   ├── wiki-index-template.md       ← format for wiki/index.md (machine catalog; .base = human nav)
 │   ├── obsidian-scaffolding.md      ← .base views, .gitignore, attachments, .obsidian config
 │   ├── daily-curation-automation.md ← portable scheduled compounding pass (the third trigger)
@@ -356,7 +356,7 @@ If any of these occur, stop and report:
 - `references/inbox-readme-template.md` — the `inbox/README.md` drop-zone contract shown to the user.
 - `references/wiki-raw-template.md` — format for `02-DOCS/raw/<topic>/*.md`.
 - `references/wiki-worklog-template.md` — format for `02-DOCS/raw/worklog/*.md` (the work-driven capture; the session as a raw source).
-- `references/wiki-article-template.md` — format for `02-DOCS/wiki/<topic>/*.md` (Obsidian frontmatter + wikilinks + `## Related`).
+- `references/wiki-article-template.md` — format for `02-DOCS/wiki/<topic>/*.md` (OKF v0.1 frontmatter + relative markdown links + `## Related`).
 - `references/wiki-index-template.md` — format for `02-DOCS/wiki/index.md` (machine catalog; the `.base` views are the human navigation).
 - `references/obsidian-scaffolding.md` — the vault scaffolding: `.base` views, `.gitignore`, `attachments/`, `.obsidian` config (no vector DB / RAG).
 - `references/daily-curation-automation.md` — portable scheduled compounding pass; on Claude Code wired via the `schedule` skill.

package/skills/harness/references/daily-curation-automation.md

@@ -39,12 +39,14 @@ Run the daily curation pass for this 02-DOCS second brain.
 
 Use the harness wiki-protocol.md as the contract. First run the Auto-Ingest Sweep:
 process inbox/, then scan the workspace (minus .rscignore) for un-ingested documents,
-ingest the clearly-documentary folders (copy originals, never move), record them in
-wiki/.ingested.json, and list ambiguous folders as proposals (do not grab them).
-Then compile pending raw/worklog/ material into wiki/ pages (update existing before
-creating new), keep frontmatter + wikilinks consistent, append significant decisions
-to wiki/harness/decisions.md, refresh the .base-backed navigation, recompute
-scores.json + the score: property, and append a dated entry to wiki/log.md.
+applying Clean-as-you-go (move loose root-level + inbox files into raw/ after a
+verified ingest; copy files nested in user-maintained folders and propose
+consolidation), record them in wiki/.ingested.json, and list ambiguous folders as
+proposals (do not grab them). Then compile pending raw/worklog/ material into wiki/
+pages (update existing before creating new), keep frontmatter + relative markdown
+links OKF-consistent, append significant decisions to wiki/harness/decisions.md,
+refresh the .base-backed navigation, recompute scores.json + the score: property,
+and prepend a dated entry (newest first) to wiki/log.md.
 
 Be conservative. If the topic map no longer fits, record a recommendation in
 wiki/gaps.md or a page's Open Questions instead of moving large parts of the

package/skills/harness/references/obsidian-scaffolding.md

@@ -31,17 +31,24 @@ not bundled with a specific raw source. Link them from the page that depends on
 them. Source-bundled originals stay in `raw/<topic>/_originals/`.
 ```
 
-## `02-DOCS/.obsidian/app.json` (attachment folder)
+## `02-DOCS/.obsidian/app.json` (attachment folder + OKF link mode)
 
 ```json
 {
   "attachmentFolderPath": "attachments",
-  "newLinkFormat": "shortest",
-  "useMarkdownLinks": false
+  "newLinkFormat": "relative",
+  "useMarkdownLinks": true,
+  "alwaysUpdateLinks": true
 }
 ```
 
-`useMarkdownLinks: false` makes new internal links wikilinks. `userIgnoreFilters`
+`useMarkdownLinks: true` makes new internal links **standard markdown links**, not
+wikilinks — this is what keeps `wiki/` a 100%-OKF-conformant bundle (OKF consumers
+follow markdown links; wikilinks `[[...]]` are non-conformant). `newLinkFormat:
+relative` writes paths relative to the current file (`../topic/page.md`), which OKF
+supports and which resolves both in Obsidian and in any OKF consumer.
+`alwaysUpdateLinks: true` makes Obsidian rewrite those relative links automatically
+on rename, so links survive moves the way wikilinks used to. `userIgnoreFilters`
 (Settings → Files & Links → Excluded files) should hide noise from search/graph:
 `raw/_originals/`, `inbox/_processed/`, `audits/`.
 
@@ -59,7 +66,7 @@ filters:
 views:
   - type: table
     name: All Articles
-    order: [file.name, topic, status, score, updated]
+    order: [file.name, topic, status, score, timestamp]
     sort:
       - property: score
         direction: DESC
@@ -74,9 +81,9 @@ filters:
 views:
   - type: table
     name: Worklog
-    order: [file.name, topic, date, status]
+    order: [file.name, topic, timestamp, status]
     sort:
-      - property: date
+      - property: timestamp
         direction: DESC
 ```
 
@@ -89,8 +96,8 @@ filters:
 views:
   - type: table
     name: Decisions
-    order: [file.name, topic, status, updated]
+    order: [file.name, topic, status, timestamp]
     sort:
-      - property: updated
+      - property: timestamp
         direction: DESC
 ```

package/skills/harness/references/wiki-article-template.md

@@ -1,19 +1,23 @@
 ---
+# OKF v0.1 standard surface — `type` is the only REQUIRED field (non-empty).
+type: article
 title: {Title}
-aliases: [{old-slug}]
+description: {One-sentence summary, for previews + search.}
+resource: {URL or path to the underlying source/asset — omit the line if none}
 tags: []
-type: article
+timestamp: {YYYY-MM-DDTHH:MM:SSZ}
+# rsc custom fields (OKF allows any; conformant consumers preserve unknown keys)
+aliases: [{old-slug}]
 topic: {topic}
 status: draft
 sources: []
-updated: {YYYY-MM-DD}
 score: 0.0
 ---
 
 # {Title}
 
 > Sources: {Author1, YYYY-MM-DD; Author2, YYYY-MM-DD}
-> Raw: [[{raw-source-1}]]; [[{raw-source-2}]]
+> Raw: [{raw-source-1}](../../raw/{topic}/{raw-source-1}.md); [{raw-source-2}](../../raw/{topic}/{raw-source-2}.md)
 
 ## Overview
 
@@ -25,19 +29,32 @@ score: 0.0
 
 ## Related
 
-{OPTIONAL — include only when cross-references exist. Maintained during lint. Use wikilinks so the link survives renames and shows in the Obsidian graph + backlinks:
-- Same or different topic: `- [[Other Article]] — why it connects.`
-- With display text: `- [[Other Article|how we say it here]] — why it connects.`}
+{OPTIONAL — include only when cross-references exist. Maintained during lint. Use
+standard markdown links (OKF-conformant — they ARE the knowledge graph; an OKF
+consumer follows them, and the Obsidian graph + backlinks render them too):
+- Same topic: `- [Other Article](./other-article.md) — why it connects.`
+- Different topic: `- [Other Article](../other-topic/other-article.md) — why it connects.`
+- With display text: `- [how we say it here](../other-topic/other-article.md) — why it connects.`}
 
 <!--
-FRONTMATTER CONTRACT (this is what powers Obsidian Properties + Bases + graph):
-- title    human-readable; the H1 matches it.
-- aliases  keep the old kebab slug here so pre-migration links/wikilinks still resolve.
-- tags     cross-cutting qualities ONLY — never the main category (that is `topic`).
-- type     article | decision | worklog | brief | spec | profile
+FRONTMATTER CONTRACT — OKF v0.1 conformant. Powers OKF consumers AND Obsidian
+Properties + Bases + graph (same file, no translation).
+OKF standard surface:
+- type         REQUIRED, non-empty. article | decision | worklog | brief | spec | profile.
+               (OKF type values are not registered centrally; consumers tolerate unknown ones.)
+- title        human-readable; the H1 matches it. Consumers may derive from filename if absent.
+- description  single-sentence summary for previews/search.
+- resource     URI/path to the underlying asset this concept documents (omit if none).
+- tags         cross-cutting qualities ONLY — never the main category (that is `topic`).
+- timestamp    ISO 8601 datetime of the last meaningful edit (e.g. 2026-06-28T14:30:00Z).
+rsc custom fields (allowed by OKF; never required for conformance):
+- aliases  keep the old kebab slug here so pre-migration links still resolve.
 - topic    the wiki/<topic>/ folder, one level. Inferred from content, never hardcoded.
 - status   draft | stable | stale  (lifecycle; filterable in a Base).
-- sources  wikilinks to raw/ pages this was distilled from (cite your evidence).
-- updated  YYYY-MM-DD of the last meaningful edit.
+- sources  markdown links to raw/ pages this was distilled from (cite your evidence).
 - score    mirror of scores.json, written by the Maintenance Pass (single writer → no drift).
+
+LINKS: standard markdown links only — NEVER wikilinks ([[...]]). Relative paths
+(./same-topic.md, ../other-topic/page.md, ../../raw/<topic>/<file>.md). This is
+what keeps wiki/ a portable, 100%-OKF-conformant bundle.
 -->

package/skills/harness/references/wiki-index-template.md

@@ -1,5 +1,9 @@
 # Knowledge Base Index
 
+> **OKF v0.1 reserved file** — `index.md` carries **no frontmatter** (it is a
+> directory listing for progressive disclosure, per the OKF spec). Links are
+> standard markdown, relative to this file (`topic/article.md`), NEVER wikilinks.
+>
 > **Human navigation lives in the `.base` views** (`Articles.base`, `Worklog.base`,
 > `Decisions.base`) — live tables over frontmatter, sorted by score/status/date.
 > This index is the **machine-readable catalog + fallback** the agent maintains;
@@ -11,8 +15,8 @@
 
 | Article | Summary | Updated | Score |
 |---------|---------|---------|-------|
-| [[{Article Title}]] | {One-line summary} | {YYYY-MM-DD} | {N.N} |
-| [[{Archived Article}]] | [Archived] {One-line summary} | {YYYY-MM-DD} | {N.N} |
+| [{Article Title}]({topic-name}/{article-file}.md) | {One-line summary} | {YYYY-MM-DD} | {N.N} |
+| [{Archived Article}]({topic-name}/{archived-file}.html) | [Archived] {One-line summary} | {YYYY-MM-DD} | {N.N} |
 
 ## {another-topic}
 
@@ -20,7 +24,7 @@
 
 | Article | Summary | Updated | Score |
 |---------|---------|---------|-------|
-| [[{Article Title}]] | {One-line summary} | {YYYY-MM-DD} | {N.N} |
+| [{Article Title}]({another-topic}/{article-file}.md) | {One-line summary} | {YYYY-MM-DD} | {N.N} |
 
 > **Score**: composite quality score (inbound links, source count, cited count,
 > freshness; minus conflicts and orphan penalty). Regenerated on every