@moreih29/nexus-core 0.4.0 → 0.5.0

package/conformance/README.md

@@ -170,6 +170,7 @@ Assertions are key/value objects where keys are JSONPath expressions and values
 | `"$.field": { "type": "number", "min": 1 }` | Numeric value >= 1 |
 | `"$.field": { "type": "string", "minLength": 5 }` | String with minimum length |
 | `".nexus/state/plan.json": null` | File must not exist |
+| `".nexus/state/artifacts/findings.md": {}` | File must exist; content not inspected (use for non-JSON artifacts like .md, .txt, binary files) |
 
 For `state_files`, a `null` value at the file path key means the file must be absent. A `null` value at a JSONPath key within a file assertion means that field must be `null`.
 
@@ -240,7 +241,10 @@ A conformance test runner does the following for each fixture:
    - For multi-step scenarios: iterate `steps` in order, calling each `action` (or triggering each `event`) and evaluating `assert_return` and `assert_state` after each step before proceeding.
 4. **Evaluate postconditions**:
    - Check `postcondition.return_value` assertions against the tool's return value.
-   - Check `postcondition.state_files` assertions against the actual file system state.
+   - Check `postcondition.state_files` assertions against the actual file system state. For each entry in `state_files`:
+     - Value is `null` → assert the file does NOT exist.
+     - Value is an empty object `{}` → assert the file EXISTS; do NOT parse content (use for non-JSON artifacts: .md, .txt, binary).
+     - Value is a non-empty object `{...}` → parse file as JSON and evaluate each JSONPath assertion against the parsed content.
    - If `postcondition.error` is `true`, the tool call must have produced an error.
    - If `postcondition.error_contains` is set, the error message must contain that substring.
 5. **Report** pass/fail per `test_id`.

package/conformance/examples/plan.extension.schema.example.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "conformance/examples/plan.extension.schema.example.json",
+  "title": "Example: Harness-local plan state extension",
+  "description": "Non-normative reference example of a harness-local extension schema for plan.json. Harnesses MAY add supplemental fields via {base}.extension.json files in .nexus/state/{harness-id}/. Consumers replace harness_specific_field_example with their own fields. See docs/nexus-outputs-contract.md §Harness-local State Extension for the pattern definition.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["extends"],
+  "properties": {
+    "extends": {
+      "type": "string",
+      "const": "conformance/state-schemas/plan.schema.json",
+      "description": "Reference to the parent common-schema this extension supplements"
+    },
+    "harness_id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Identifier of the harness that produced this extension file"
+    },
+    "harness_specific_field_example": {
+      "type": "string",
+      "description": "Placeholder — replace with your harness's actual extension fields as needed"
+    }
+  }
+}

package/conformance/lifecycle/agent-complete.json

@@ -5,7 +5,8 @@
     "state_files": {
       ".nexus/state/agent-tracker.json": [
         {
-          "agent_type": "claude-nexus:engineer",
+          "harness_id": "claude-nexus",
+          "agent_name": "architect",
           "agent_id": "uuid-eng01",
           "started_at": "2026-04-13T00:00:00.000Z",
           "resume_count": 0,

package/conformance/lifecycle/agent-resume.json

@@ -5,7 +5,8 @@
     "state_files": {
       ".nexus/state/agent-tracker.json": [
         {
-          "agent_type": "claude-nexus:engineer",
+          "harness_id": "claude-nexus",
+          "agent_name": "architect",
           "agent_id": "uuid-eng01",
           "started_at": "2026-04-13T00:00:00.000Z",
           "resume_count": 0,

package/conformance/lifecycle/agent-spawn.json

@@ -6,7 +6,8 @@
       ".nexus/state/runtime.json": {
         "teams_enabled": true,
         "session_started_at": "2026-04-13T00:00:00.000Z",
-        "plugin_version": "0.4.0"
+        "harness_id": "claude-nexus",
+        "harness_version": "0.25.0"
       },
       ".nexus/state/agent-tracker.json": []
     }
@@ -14,7 +15,8 @@
   "event": {
     "type": "agent_spawn",
     "params": {
-      "agent_type": "claude-nexus:engineer",
+      "harness_id": "claude-nexus",
+      "agent_name": "architect",
       "agent_id": "uuid-eng01"
     },
     "description": "Harness spawns an agent instance and records its initial state in the agent registry"
@@ -23,7 +25,8 @@
     "state_files": {
       ".nexus/state/agent-tracker.json": {
         "$.length": 1,
-        "$[0].agent_type": "claude-nexus:engineer",
+        "$[0].harness_id": "claude-nexus",
+        "$[0].agent_name": "architect",
         "$[0].agent_id": "uuid-eng01",
         "$[0].started_at": { "type": "iso8601" },
         "$[0].resume_count": 0,
@@ -33,7 +36,7 @@
   },
   "covers": {
     "state_schemas": {
-      "agent-tracker.schema.json": ["agent_type", "agent_id", "started_at", "resume_count", "status"]
+      "agent-tracker.schema.json": ["harness_id", "agent_name", "agent_id", "started_at", "resume_count", "status"]
     }
   }
 }

package/conformance/lifecycle/session-end.json

@@ -6,7 +6,8 @@
       ".nexus/state/runtime.json": {
         "teams_enabled": true,
         "session_started_at": "2026-04-13T00:00:00.000Z",
-        "plugin_version": "0.4.0"
+        "harness_id": "claude-nexus",
+        "harness_version": "0.25.0"
       },
       ".nexus/state/agent-tracker.json": []
     }
@@ -23,7 +24,7 @@
   },
   "covers": {
     "state_schemas": {
-      "runtime.schema.json": ["teams_enabled", "session_started_at", "plugin_version"],
+      "runtime.schema.json": ["teams_enabled", "session_started_at", "harness_id", "harness_version"],
       "agent-tracker.schema.json": []
     },
     "description": "Covers deletion aspect of the full runtime/agent-tracker lifecycle — absence of both files after session_end"

package/conformance/lifecycle/session-start.json

@@ -11,7 +11,8 @@
     "type": "session_start",
     "params": {
       "teams_enabled": true,
-      "plugin_version": "0.4.0"
+      "harness_id": "claude-nexus",
+      "harness_version": "0.25.0"
     },
     "description": "Harness session hook fires at startup, injecting runtime configuration and initializing the agent registry"
   },
@@ -20,7 +21,8 @@
       ".nexus/state/runtime.json": {
         "$.teams_enabled": true,
         "$.session_started_at": { "type": "iso8601" },
-        "$.plugin_version": { "type": "string", "minLength": 1 }
+        "$.harness_id": "claude-nexus",
+        "$.harness_version": { "type": "string", "minLength": 1 }
       },
       ".nexus/state/agent-tracker.json": {
         "$.length": 0
@@ -29,7 +31,7 @@
   },
   "covers": {
     "state_schemas": {
-      "runtime.schema.json": ["teams_enabled", "session_started_at", "plugin_version"],
+      "runtime.schema.json": ["schema_version", "teams_enabled", "session_started_at", "harness_id", "harness_version"],
       "agent-tracker.schema.json": []
     }
   }

package/conformance/scenarios/full-plan-cycle.json

@@ -15,7 +15,7 @@
     },
     "description": "End-to-end lifecycle scenario: plan/task/history state transitions and each tool's return value across 5 sequential invocations."
   },
-  "uncovered_params": ["research_summary", "issue_id", "summary", "title", "context", "deps"],
+  "uncovered_params": ["research_summary", "issue_id", "decision", "title", "context", "deps"],
   "precondition": {
     "state_files": {
       ".nexus/state/plan.json": null,
@@ -56,7 +56,7 @@
         "tool": "plan_decide",
         "params": {
           "issue_id": 1,
-          "summary": "Keep .nexus/state/ as the canonical location. Documented in state-schemas README."
+          "decision": "Keep .nexus/state/ as the canonical location. Documented in state-schemas README."
         }
       },
       "assert_return": {
@@ -78,7 +78,7 @@
         "tool": "plan_decide",
         "params": {
           "issue_id": 2,
-          "summary": "Ship a one-shot migration script as a standalone npm script. Document in RELEASING.md."
+          "decision": "Ship a one-shot migration script as a standalone npm script. Document in RELEASING.md."
         }
       },
       "assert_return": {

package/conformance/schema/fixture.schema.json

@@ -112,7 +112,7 @@
       "properties": {
         "state_files": {
           "type": "object",
-          "description": "Map of file path to content object (null means the file must not exist)",
+          "description": "Map of file path to content object. null = file must not exist; empty object {} = file must exist but content is not inspected (use for non-JSON artifacts like .md, .txt, binary files); non-empty object = precondition content written as-is (typically JSON).",
           "additionalProperties": {
             "oneOf": [
               { "type": "object" },
@@ -171,7 +171,7 @@
         },
         "params": {
           "type": "object",
-          "description": "Optional event-specific parameters (e.g. agent_type and agent_id for agent_spawn)",
+          "description": "Optional event-specific parameters (e.g. harness_id, agent_name, and agent_id for agent_spawn)",
           "additionalProperties": true
         },
         "description": {
@@ -187,7 +187,7 @@
       "properties": {
         "state_files": {
           "type": "object",
-          "description": "Map of file path to assertion object (null means the file must not exist after the action)",
+          "description": "Map of file path to assertion object. null = file must not exist after the action; empty object {} = file must exist but content is not inspected (use for non-JSON artifacts like .md, .txt, binary files); non-empty object = JSONPath assertions on parsed JSON content.",
           "additionalProperties": {
             "oneOf": [
               {

package/conformance/state-schemas/agent-tracker.schema.json

@@ -2,17 +2,22 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "conformance/state-schemas/agent-tracker.schema.json",
   "title": "Nexus Agent Tracker",
-  "description": "Schema for .nexus/state/agent-tracker.json — registry of spawned agent instances tracked across a session",
+  "description": "Schema for .nexus/state/agent-tracker.json — registry of spawned agent instances tracked across a session. No schema_version field: this file is session-scoped and deleted on session end — migration anchor not required.",
   "type": "array",
   "items": {
     "type": "object",
     "additionalProperties": false,
-    "required": ["agent_type", "agent_id", "started_at", "resume_count", "status"],
+    "required": ["harness_id", "agent_name", "agent_id", "started_at", "resume_count", "status"],
     "properties": {
-      "agent_type": {
+      "harness_id": {
         "type": "string",
-        "minLength": 1,
-        "description": "Qualified agent type identifier (e.g. 'claude-nexus:engineer')"
+        "pattern": "^[a-z][a-z0-9-]*$",
+        "description": "Identifier of the harness that spawned this agent."
+      },
+      "agent_name": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9-]*$",
+        "description": "Neutral agent id as defined in nexus-core agents/{id}/meta.yml (e.g. 'architect', 'engineer')."
       },
       "agent_id": {
         "type": "string",

package/conformance/state-schemas/history.schema.json

@@ -7,14 +7,24 @@
   "additionalProperties": false,
   "required": ["cycles"],
   "properties": {
+    "schema_version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+$",
+      "description": "nexus-core version that introduced this schema shape (e.g. '0.5'). Optional in v0.5.0 — candidate for required in v1.0.0 (Phase 2 entry)."
+    },
     "cycles": {
       "type": "array",
       "description": "Chronologically ordered list of completed execution cycles",
       "items": {
         "type": "object",
         "additionalProperties": false,
-        "required": ["completed_at", "branch", "plan", "tasks"],
+        "required": ["completed_at", "branch", "plan", "tasks", "schema_version"],
         "properties": {
+          "schema_version": {
+            "type": "string",
+            "pattern": "^\\d+\\.\\d+$",
+            "description": "Version tag recorded at the time this cycle was archived. Required for every cycle as history.json accumulates across nexus-core versions."
+          },
           "completed_at": {
             "type": "string",
             "format": "date-time",

package/conformance/state-schemas/plan.schema.json

@@ -7,6 +7,11 @@
   "additionalProperties": false,
   "required": ["id", "topic", "issues", "created_at"],
   "properties": {
+    "schema_version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+$",
+      "description": "nexus-core version that introduced this schema shape (e.g. '0.5'). Optional in v0.5.0 — candidate for required in v1.0.0 (Phase 2 entry)."
+    },
     "id": {
       "type": "number",
       "minimum": 1,

package/conformance/state-schemas/runtime.schema.json

@@ -5,8 +5,13 @@
   "description": "Schema for .nexus/state/runtime.json — ephemeral runtime configuration written by the harness at session start",
   "type": "object",
   "additionalProperties": false,
-  "required": ["teams_enabled", "session_started_at", "plugin_version"],
+  "required": ["teams_enabled", "session_started_at", "harness_id", "harness_version"],
   "properties": {
+    "schema_version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+$",
+      "description": "nexus-core version that introduced this schema shape (e.g. '0.5'). Optional in v0.5.0 — candidate for required in v1.0.0 (Phase 2 entry)."
+    },
     "teams_enabled": {
       "type": "boolean",
       "description": "Whether multi-agent team orchestration is active in this session"
@@ -16,10 +21,14 @@
       "format": "date-time",
       "description": "ISO 8601 timestamp when the current harness session was started"
     },
-    "plugin_version": {
+    "harness_id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Identifier of the harness that owns this runtime state (e.g. 'claude-nexus', 'opencode-nexus'). Free string — nexus-core does not enumerate harnesses."
+    },
+    "harness_version": {
       "type": "string",
-      "minLength": 1,
-      "description": "Version string of the harness plugin that wrote this file"
+      "description": "Semver-like version string of the harness plugin that wrote this file."
     }
   }
 }

package/conformance/state-schemas/tasks.schema.json

@@ -7,6 +7,11 @@
   "additionalProperties": false,
   "required": ["goal", "decisions", "tasks"],
   "properties": {
+    "schema_version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+$",
+      "description": "nexus-core version that introduced this schema shape (e.g. '0.5'). Optional in v0.5.0 — candidate for required in v1.0.0 (Phase 2 entry)."
+    },
     "goal": {
       "type": "string",
       "minLength": 1,

package/conformance/tools/plan-decide.json

@@ -1,7 +1,7 @@
 [
   {
     "test_id": "plan_decide_happy_path",
-    "description": "plan_decide marks an issue as decided and records the decision summary on the issue object",
+    "description": "plan_decide marks an issue as decided and records the decision text on the issue object",
     "covers": {
       "state_schemas": {
         "plan.schema.json": ["issues[].status", "issues[].decision"]
@@ -10,7 +10,7 @@
         "plan_decide": ["decided", "allComplete", "remaining"]
       }
     },
-    "uncovered_params": ["issue_id", "summary"],
+    "uncovered_params": ["issue_id", "decision"],
     "precondition": {
       "state_files": {
         ".nexus/state/plan.json": {
@@ -37,7 +37,7 @@
       "tool": "plan_decide",
       "params": {
         "issue_id": 1,
-        "summary": "Use declarative JSON with JSONPath assertions. Harness-neutral tool names only."
+        "decision": "Use declarative JSON with JSONPath assertions. Harness-neutral tool names only."
       }
     },
     "postcondition": {
@@ -63,7 +63,7 @@
         "plan.schema.json": []
       }
     },
-    "uncovered_params": ["issue_id", "summary"],
+    "uncovered_params": ["issue_id", "decision"],
     "precondition": {
       "state_files": {
         ".nexus/state/plan.json": null
@@ -73,7 +73,7 @@
       "tool": "plan_decide",
       "params": {
         "issue_id": 1,
-        "summary": "Some decision"
+        "decision": "Some decision"
       }
     },
     "postcondition": {
@@ -90,7 +90,7 @@
         "plan.schema.json": ["issues[].how_agents", "issues[].how_agents[]", "issues[].how_summary", "issues[].how_agent_ids"]
       }
     },
-    "uncovered_params": ["issue_id"],
+    "uncovered_params": ["issue_id", "decision"],
     "precondition": {
       "state_files": {
         ".nexus/state/plan.json": {
@@ -112,7 +112,7 @@
       "tool": "plan_decide",
       "params": {
         "issue_id": 1,
-        "summary": "Declarative JSON with JSONPath assertions, harness-neutral.",
+        "decision": "Declarative JSON with JSONPath assertions, harness-neutral.",
         "how_agents": ["architect", "postdoc"],
         "how_summary": {
           "architect": "JSONPath assertions provide harness-agnostic verifiability.",

package/conformance/tools/plan-start.json

@@ -4,7 +4,7 @@
     "description": "plan_start creates plan.json with correct structure when given a topic, issues, and research_summary",
     "covers": {
       "state_schemas": {
-        "plan.schema.json": ["id", "topic", "issues[].id", "issues[].title", "issues[].status", "research_summary", "created_at"]
+        "plan.schema.json": ["schema_version", "id", "topic", "issues[].id", "issues[].title", "issues[].status", "research_summary", "created_at"]
       },
       "return_value": {
         "plan_start": ["created", "plan_id", "topic", "issueCount"]

package/conformance/tools/task-add.json

@@ -4,7 +4,7 @@
     "description": "task_add creates tasks.json with the new task when no tasks.json existed, assigning id=1 and status=pending",
     "covers": {
       "state_schemas": {
-        "tasks.schema.json": ["tasks[].id", "tasks[].title", "tasks[].status", "tasks[].deps", "tasks[].approach", "tasks[].acceptance", "tasks[].risk", "tasks[].context", "tasks[].created_at"]
+        "tasks.schema.json": ["schema_version", "tasks[].id", "tasks[].title", "tasks[].status", "tasks[].deps", "tasks[].approach", "tasks[].acceptance", "tasks[].risk", "tasks[].context", "tasks[].created_at"]
       },
       "return_value": {
         "task_add": ["task"]

package/conformance/tools/task-close.json

@@ -5,6 +5,8 @@
     "covers": {
       "state_schemas": {
         "history.schema.json": [
+          "schema_version",
+          "cycles[].schema_version",
           "cycles[].completed_at",
           "cycles[].branch",
           "cycles[].plan",

package/docs/consumer-implementation-guide.md

@@ -555,7 +555,7 @@ Identify the equivalent events in your harness's plugin system and implement the
 **When it fires:** Lead spawns a subagent to execute a task.
 
 **Expected consumer behavior:**
-- Record the new agent entry in `agent-tracker.json`: `{ agent_type, agent_id, task_id, started_at }`.
+- Record the new agent entry in `agent-tracker.json`: `{ harness_id, agent_name, agent_id, task_id, started_at }`.
 - Inject the knowledge index into the subagent's initial context: the list of files in `.nexus/memory/`, `.nexus/context/`, and `.nexus/rules/` so the agent knows what project knowledge is available.
 - Apply capability restrictions: resolve `effective_capabilities` for this agent type and configure the subagent's tool access accordingly (see §6).
 - Apply the resume evaluation: check `owner_reuse_policy` on the task and the agent's `resume_tier` to determine whether to spawn fresh or resume a prior session (see §10).

package/docs/nexus-outputs-contract.md

@@ -238,6 +238,16 @@ Nexus 산출물은 생성 책임 주체에 따라 세 카테고리로 분류된
 
 (루트 레벨 `edit-tracker.json`/`reopen-tracker.json`은 legacy carve-out으로 v0.3.x 이하 호환 유지)
 
+### Reference example
+
+`conformance/examples/plan.extension.schema.example.json`에 non-normative 참조 예시가 있다. 이 파일은 다음 요소를 보여준다:
+
+- `extends` 필드 (const: 부모 schema 경로)로 extension이 참조하는 common schema를 명시
+- `additionalProperties: false` — 확장 schema에서도 엄격 적용
+- `harness_id` 필드와 harness-specific field placeholder
+
+consumer는 이 파일을 starting point로 삼아 자신의 실제 extension 필드로 교체한다.
+
 ---
 
 ## Conformance 의무와의 연결

package/docs/nexus-tools-contract.md

@@ -102,7 +102,17 @@ Mutates the issue list of the active planning session. Supports four discrete ac
 
 ### Return Value
 
-All responses include an `issue` field containing the affected `PlanIssue` object. The discriminating field varies by action:
+All responses include an `issue` field containing the affected `PlanIssue` object.
+
+The `issue` object contains:
+
+| Field | Type | Presence |
+|-------|------|----------|
+| `id` | `number` | always |
+| `title` | `string` | on `add`, `edit`, `reopen` |
+| `status` | `"pending" \| "decided"` | on `add`, `reopen` |
+
+The discriminating field varies by action:
 
 | Action | Discriminating Field | Value |
 |--------|----------------------|-------|
@@ -140,7 +150,7 @@ Records a decision for a specific issue and marks it as `"decided"`. Triggered b
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
 | `issue_id` | `number` | yes | Identifier of the issue being decided |
-| `summary` | `string` | yes | Decision summary to record against the issue |
+| `decision` | `string` | yes | Decision text to record against the issue |
 | `how_agents` | `string[]` | no | Names of HOW agents that contributed analysis |
 | `how_summary` | `Record<string, string>` | no | Per-agent key position summaries |
 | `how_agent_ids` | `Record<string, string>` | no | Agent name to agent-instance ID mapping for future resume |

package/manifest.json

@@ -1,8 +1,24 @@
 {
-  "nexus_core_version": "0.4.0",
-  "nexus_core_commit": "2cc2402301c1f9b95ef0e9896c30e561357a7c35",
+  "nexus_core_version": "0.5.0",
+  "nexus_core_commit": "4da9b345dce867d9b7b60f8b04076a1a3dc3818a",
   "schema_contract_version": "2.0",
   "agents": [
+    {
+      "name": "designer",
+      "description": "UX/UI design — evaluates user experience, interaction patterns, and how users will experience the product",
+      "task": "UI/UX design, interaction patterns, user experience",
+      "alias_ko": "디자이너",
+      "category": "how",
+      "resume_tier": "persistent",
+      "model_tier": "high",
+      "capabilities": [
+        "no_file_edit",
+        "no_task_create",
+        "no_task_update"
+      ],
+      "id": "designer",
+      "body_hash": "sha256:88ac56147d0e5bdf23fa591ce570a9c2d0eb1338df4ec2219f6238ddfcb65df4"
+    },
     {
       "name": "architect",
       "description": "Technical design — evaluates How, reviews architecture, advises on implementation approach",
@@ -35,10 +51,10 @@
       "body_hash": "sha256:f04d15249601b14046e7e40a4475defb289436c4474afbd89986964f8c3e7c2f"
     },
     {
-      "name": "designer",
-      "description": "UX/UI design — evaluates user experience, interaction patterns, and how users will experience the product",
-      "task": "UI/UX design, interaction patterns, user experience",
-      "alias_ko": "디자이너",
+      "name": "strategist",
+      "description": "Business strategy — evaluates market positioning, competitive landscape, and business viability of decisions",
+      "task": "Business strategy, market analysis, competitive positioning",
+      "alias_ko": "전략가",
       "category": "how",
       "resume_tier": "persistent",
       "model_tier": "high",
@@ -47,8 +63,8 @@
         "no_task_create",
         "no_task_update"
       ],
-      "id": "designer",
-      "body_hash": "sha256:88ac56147d0e5bdf23fa591ce570a9c2d0eb1338df4ec2219f6238ddfcb65df4"
+      "id": "strategist",
+      "body_hash": "sha256:0254b4144a22c66209bd68119553d9057a4fb7f9b1ff7ebb9878687d99583465"
     },
     {
       "name": "engineer",
@@ -64,37 +80,6 @@
       "id": "engineer",
       "body_hash": "sha256:3d58b1b490c2f93cace2eedd0f04ec000f84514388eb086768cf53f8fa33db01"
     },
-    {
-      "name": "strategist",
-      "description": "Business strategy — evaluates market positioning, competitive landscape, and business viability of decisions",
-      "task": "Business strategy, market analysis, competitive positioning",
-      "alias_ko": "전략가",
-      "category": "how",
-      "resume_tier": "persistent",
-      "model_tier": "high",
-      "capabilities": [
-        "no_file_edit",
-        "no_task_create",
-        "no_task_update"
-      ],
-      "id": "strategist",
-      "body_hash": "sha256:0254b4144a22c66209bd68119553d9057a4fb7f9b1ff7ebb9878687d99583465"
-    },
-    {
-      "name": "researcher",
-      "description": "Independent investigation — conducts web searches, gathers evidence, and reports findings with citations",
-      "task": "Web search, independent investigation",
-      "alias_ko": "리서처",
-      "category": "do",
-      "resume_tier": "persistent",
-      "model_tier": "standard",
-      "capabilities": [
-        "no_file_edit",
-        "no_task_create"
-      ],
-      "id": "researcher",
-      "body_hash": "sha256:fc79bafec05503327bd51a0b84b6e642d304bd79c45b78db6448b112793c143e"
-    },
     {
       "name": "postdoc",
       "description": "Research methodology and synthesis — designs investigation approach, evaluates evidence quality, writes synthesis documents",
@@ -126,6 +111,21 @@
       "id": "tester",
       "body_hash": "sha256:4dd04e1c93ff9c0c9fa6aebb60ece3f9719e82f9714b13feea01b6163633caec"
     },
+    {
+      "name": "researcher",
+      "description": "Independent investigation — conducts web searches, gathers evidence, and reports findings with citations",
+      "task": "Web search, independent investigation",
+      "alias_ko": "리서처",
+      "category": "do",
+      "resume_tier": "persistent",
+      "model_tier": "standard",
+      "capabilities": [
+        "no_file_edit",
+        "no_task_create"
+      ],
+      "id": "researcher",
+      "body_hash": "sha256:fc79bafec05503327bd51a0b84b6e642d304bd79c45b78db6448b112793c143e"
+    },
     {
       "name": "writer",
       "description": "Technical writing — transforms research findings, code, and analysis into clear documents and presentations for the intended audience",
@@ -156,15 +156,17 @@
       "body_hash": "sha256:6c8d1a36626d4034209ff83780dec6238297ec4710612441b2ef09daac714ca8"
     },
     {
-      "name": "nx-init",
-      "description": "Project onboarding — scan, mission, essentials, context generation",
-      "summary": "Project onboarding — scan, mission, essentials, context generation",
-      "manual_only": true,
+      "name": "nx-plan",
+      "description": "Structured multi-perspective analysis to decompose issues, align on decisions, and produce an enriched plan before execution. Plan only — does not execute.",
+      "summary": "Structured planning — subagent-based analysis, deliberate decisions, produce execution plan",
+      "triggers": [
+        "plan"
+      ],
       "harness_docs_refs": [
-        "instruction_file"
+        "resume_invocation"
       ],
-      "id": "nx-init",
-      "body_hash": "sha256:3c8230ecc0f87c541ec0ff80492a28f28bf173d0b9781901adadfae69a54b8ed"
+      "id": "nx-plan",
+      "body_hash": "sha256:85b858089bd3dc276be61baa3f5265bc107a85470f169983e710fecb404bb4b1"
     },
     {
       "name": "nx-sync",
@@ -177,17 +179,15 @@
       "body_hash": "sha256:a7b0ae8f13ebcd10e52361d0ada1570ff0c47933f731deec07e95539c63e6946"
     },
     {
-      "name": "nx-plan",
-      "description": "Structured multi-perspective analysis to decompose issues, align on decisions, and produce an enriched plan before execution. Plan only — does not execute.",
-      "summary": "Structured planning — subagent-based analysis, deliberate decisions, produce execution plan",
-      "triggers": [
-        "plan"
-      ],
+      "name": "nx-init",
+      "description": "Project onboarding — scan, mission, essentials, context generation",
+      "summary": "Project onboarding — scan, mission, essentials, context generation",
+      "manual_only": true,
       "harness_docs_refs": [
-        "resume_invocation"
+        "instruction_file"
       ],
-      "id": "nx-plan",
-      "body_hash": "sha256:85b858089bd3dc276be61baa3f5265bc107a85470f169983e710fecb404bb4b1"
+      "id": "nx-init",
+      "body_hash": "sha256:3c8230ecc0f87c541ec0ff80492a28f28bf173d0b9781901adadfae69a54b8ed"
     }
   ],
   "vocabulary": {