mdkg 0.3.7 → 0.3.9

package/dist/init/CLI_COMMAND_MATRIX.md

@@ -6,8 +6,9 @@ Verify live help with:
 - `mdkg --help`
 - `mdkg help <command>`
 
-Optional reusable SPEC capability records are accessed through `mdkg spec ...`.
-Repos without SPEC files remain valid.
+Optional reusable manifest capability records are accessed through `mdkg manifest ...`.
+Repos without MANIFEST/SPEC files remain valid. `mdkg spec ...` remains a
+legacy alias for one compatibility release.
 
 Primary commands:
 - `mdkg init`
@@ -20,6 +21,7 @@ Primary commands:
 - `mdkg handoff create <id-or-qid> [--ws <alias>] [--depth <n>] [--out <path>] [--json]`
 - `mdkg skill`
 - `mdkg capability`
+- `mdkg manifest`
 - `mdkg spec`
 - `mdkg archive`
 - `mdkg bundle`
@@ -118,9 +120,11 @@ Project database commands:
 - active `.mdkg/db/runtime/` files and `.mdkg/db` WAL/SHM/journal/lock/temp files are ignored by default
 
 Validation commands:
-- `mdkg validate [--out <path>] [--quiet] [--changed-only] [--json]`
+- `mdkg validate [--out <path>] [--json-out <path>] [--quiet] [--changed-only] [--summary] [--limit <n>] [--json]`
 - `--changed-only` filters warning presentation to changed `.mdkg` files while full graph errors still run
-- JSON receipts include `warning_diagnostics` with warning ids, categories, severity, paths, refs, and remediation text
+- `--summary` emits bounded warning samples for agent/CI logs; `--limit <n>` controls the sample size
+- `--out <path>` writes the compatibility text report; `--json-out <path>` writes a clean full JSON receipt
+- JSON receipts include `warning_summary` and `warning_diagnostics` with warning ids, categories, severity, paths, refs, and remediation text
 
 Node creation commands:
 - `mdkg new <type> "<title>" [options] [--json]`
@@ -128,19 +132,21 @@ Node creation commands:
 - `mdkg new spike "<research question>" [options] [--json]`
 
 Agent workflow file type creation:
-- `mdkg new spec "<title>" [options] [--json]`
+- `mdkg new manifest "<title>" [options] [--json]`
 - `mdkg new work "<title>" [options] [--json]`
 - `mdkg new work_order "<title>" [options] [--json]`
 - `mdkg new receipt "<title>" [options] [--json]`
 - `mdkg new feedback "<title>" [options] [--json]`
 - `mdkg new dispute "<title>" [options] [--json]`
 - `mdkg new proposal "<title>" [options] [--json]`
-- `mdkg new spec "image worker" --id agent.image-worker`
+- `mdkg new spec "<title>" [options] [--json]` is a deprecated alias for
+  `mdkg new manifest` and creates `MANIFEST.md` with `type: manifest`
+- `mdkg new manifest "image worker" --id agent.image-worker`
 - `mdkg new work "generate image" --id work.generate-image`
 
 Agent workflow notes:
 - `--id <portable-id>` is only for agent workflow file types.
-- `spec` and `work` scaffold as validation-clean standalone docs.
+- `manifest` and `work` scaffold as validation-clean standalone docs.
 - `work_order`, `receipt`, `feedback`, `dispute`, and `proposal` need real refs before strict `mdkg validate` passes.
 - `goal` nodes capture recursive objective state and required checks, but normal `mdkg next` does not select them.
 - `spike` nodes are actionable research/planning work under `.mdkg/work/`; use `mdkg task start|update|done` for lifecycle state.
@@ -171,7 +177,7 @@ Checkpoint commands:
 Agent bootstrap:
 - `mdkg init --agent`
 - published bootstrap config is root-only by default
-- `mdkg init --agent` creates the complete startup docs, wrapper docs, default mdkg skills, event log, registry, and skill mirrors
+- `mdkg init --agent` creates the complete startup docs, wrapper docs, `SOUL.md` / `COLLABORATION.md` core docs, legacy `HUMAN.md`, default mdkg skills, event log, registry, and configured skill mirrors
 - removed flags `--llm`, `--agents`, `--claude`, and `--omni` fail before mutation with guidance to use `mdkg init --agent`
 
 Upgrade:
@@ -195,18 +201,25 @@ Capability discovery:
 - `mdkg capability resolve [query] [--requires <capability>] [--fresh-only] [--json]`
 - capability records are deterministic cache projections from Markdown
 - records include source hash, headings, refs, and `indexed_at`
-- SPEC and WORK capability records include read-only `linkage` arrays for related SPECs, work contracts, work orders, and receipts when those graph mirrors exist
+- MANIFEST/SPEC and WORK capability records include read-only `linkage` arrays for related manifests, work contracts, work orders, and receipts when those graph mirrors exist
 - normal task, epic, feat, bug, test, spike, and checkpoint nodes are intentionally excluded
 
-Spec capability records:
+Manifest capability records:
+- `mdkg manifest list [--json]`
+- `mdkg manifest show <id-or-qid-or-alias> [--json]`
+- `mdkg manifest validate [<id-or-qid-or-alias>] [--json]`
+- `MANIFEST.md` is optional; repos with no manifest files still validate
+- manifest records describe reusable capability surfaces, not general planning notes
+- `mdkg manifest validate` with no ref validates the graph and all optional manifest records
+- `mdkg manifest validate <ref>` also checks that the target manifest reference exists
+- `mdkg manifest ...` is the focused manifest command family; `mdkg capability ...` remains broader skill/manifest/work/core/design discovery
+
+Legacy spec capability records:
 - `mdkg spec list [--json]`
 - `mdkg spec show <id-or-qid-or-alias> [--json]`
 - `mdkg spec validate [<id-or-qid-or-alias>] [--json]`
-- `SPEC.md` is optional; repos with no SPEC files still validate
-- SPEC records describe reusable capability surfaces, not general planning notes
-- `mdkg spec validate` with no ref validates the graph and all optional SPEC records
-- `mdkg spec validate <ref>` also checks that the target SPEC reference exists
-- `mdkg spec ...` is the focused SPEC command family; `mdkg capability ...` remains broader skill/spec/work/core/design discovery
+- `mdkg spec ...` is a deprecated alias for `mdkg manifest ...` during the compatibility bridge
+- legacy `SPEC.md` files remain valid for one compatibility release
 
 Archive sidecars:
 - `mdkg archive add <file> [--id <archive.id>] [--kind source|artifact] [--visibility private|internal|public] [--title <title>] [--refs <...>] [--relates <...>] [--json]`
@@ -281,8 +294,8 @@ Work semantic mirrors:
 - `mdkg work receipt verify <id-or-qid> [--json]`
 - `mdkg work receipt update <id-or-qid> [--receipt-status <status>] [--add-artifacts <...>] [--add-proof-refs <...>] [--add-attestation-refs <...>] [--json]`
 - `mdkg work artifact add <order-or-receipt-id-or-qid> <file> [--id <archive.id>] [--kind source|artifact] [--json]`
-- `mdkg work validate [<id-or-qid>] [--type spec|work|work_order|receipt|feedback|dispute|proposal] [--json]`
-- `work trigger` accepts a `WORK.md` ref directly or a `SPEC.md` capability ref with exactly one resolvable work contract; it creates a submitted order mirror and never executes work
+- `mdkg work validate [<id-or-qid>] [--type manifest|spec|work|work_order|receipt|feedback|dispute|proposal] [--json]`
+- `work trigger` accepts a `WORK.md` ref directly or a `MANIFEST.md` / legacy `SPEC.md` capability ref with exactly one resolvable work contract; it creates a submitted order mirror and never executes work
 - example: `mdkg work trigger work.example --id order.example-1 --requester user://example --json`
 - `work trigger --enqueue <queue>` requires a valid project DB plus an explicitly created active queue, creates a submitted order mirror, and enqueues a local delivery message without executing work
 - `work order status` is read-only and reports deterministic order state plus linked receipts

package/dist/init/README.md

@@ -27,7 +27,7 @@ mdkg show <id>
 mdkg pack <id>
 mdkg handoff create <id-or-qid> --json
 mdkg capability search "..."
-mdkg spec list --json
+mdkg manifest list --json
 mdkg archive list
 mdkg bundle create --profile private
 mdkg graph clone .mdkg/bundles/private/all.mdkg.zip --target demos/demo-1 --json
@@ -37,14 +37,14 @@ mdkg fix plan --json
 mdkg validate
 ```
 
-This repo is already initialized. Use `mdkg upgrade` to preview safe scaffold updates, `mdkg index` to create or refresh generated graph/skill/capability/subgraph and SQLite caches after init, `mdkg new` to create work, `mdkg new goal "..."` plus `mdkg goal activate/current/next/claim/evaluate` for recursive long-running objectives, `mdkg search`/`mdkg show` to inspect graph state, `mdkg capability ...` to inspect cached skill/spec/work/core/design capabilities, `mdkg spec ...` for focused optional SPEC records, `mdkg capability resolve ...` to rank local and subgraph capabilities, `mdkg archive ...` to register source/artifact sidecars, `mdkg work ...` to create work contract/order/receipt semantic mirrors and deterministic trigger/verification records, `mdkg bundle ...` to create full graph snapshot bundles, `mdkg graph ...` to clone/fork/import authored graph templates, `mdkg subgraph ...` to register read-only child graph planning views, `mdkg pack <id>` to build deterministic context, `mdkg handoff create <id-or-qid> --json` to create a sanitized copy-ready agent handoff prompt, and `mdkg validate` before closeout.
+This repo is already initialized. Use `mdkg upgrade` to preview safe scaffold updates, `mdkg index` to create or refresh generated graph/skill/capability/subgraph and SQLite caches after init, `mdkg new` to create work, `mdkg new goal "..."` plus `mdkg goal activate/current/next/claim/evaluate` for recursive long-running objectives, `mdkg search`/`mdkg show` to inspect graph state, `mdkg capability ...` to inspect cached skill/manifest/spec/work/core/design capabilities, `mdkg manifest ...` for focused optional manifest records, `mdkg capability resolve ...` to rank local and subgraph capabilities, `mdkg archive ...` to register source/artifact sidecars, `mdkg work ...` to create work contract/order/receipt semantic mirrors and deterministic trigger/verification records, `mdkg bundle ...` to create full graph snapshot bundles, `mdkg graph ...` to clone/fork/import authored graph templates, `mdkg subgraph ...` to register read-only child graph planning views, `mdkg pack <id>` to build deterministic context, `mdkg handoff create <id-or-qid> --json` to create a sanitized copy-ready agent handoff prompt, and `mdkg validate` before closeout.
 
 `mdkg handoff create` summarizes goal/work state, included pack nodes, latest
 checkpoint, boundaries, required checks, next actions, and raw-content marker
 warnings without copying raw node bodies into the prompt. Use `--out` to write
 the handoff artifact inside the repo root.
 
-For large historical graphs, `mdkg validate --changed-only --json` keeps warning review focused on changed `.mdkg` files while full graph errors still run. `mdkg format --headings --dry-run --json` previews missing recommended heading additions before `--apply`.
+For large historical graphs, `mdkg validate --changed-only --json` keeps warning review focused on changed `.mdkg` files while full graph errors still run. `mdkg validate --summary --json --limit 20` keeps agent and CI logs bounded, and `--json-out <path>` writes a clean full JSON receipt artifact. `mdkg format --headings --dry-run --summary --json --limit 20` previews missing recommended heading additions with bounded output before `--apply`.
 
 Use `mdkg status --json` for a read-only operator summary of Git, graph,
 selected-goal, project DB, and generated-cache health before mutating work. Use
@@ -80,15 +80,17 @@ intentionally with `mdkg new task ...` or `mdkg new test ...`.
 Agent workflow docs can use semantic ids:
 
 ```bash
-mdkg new spec "image worker" --id agent.image-worker
+mdkg new manifest "image worker" --id agent.image-worker
 mdkg new work "generate image" --id work.generate-image
 ```
 
-`SPEC.md` is optional. Repos without SPEC files still validate. When present,
-SPEC records describe reusable capability surfaces rather than general planning
-notes. `mdkg spec list/show/validate` is the focused SPEC command family, while
-`mdkg capability ...` remains the broader read-only discovery surface for
-skills, SPECs, WORK contracts, core docs, and design docs.
+`MANIFEST.md` is optional. Repos without manifest files still validate. When
+present, manifest records describe reusable capability surfaces rather than
+general planning notes. `SPEC.md` remains a legacy alias for one compatibility
+release, and `mdkg spec list/show/validate` remains a deprecated alias for
+`mdkg manifest list/show/validate`. `mdkg capability ...` remains the broader
+read-only discovery surface for skills, manifests, WORK contracts, core docs,
+and design docs.
 
 Read `AGENT_START.md` first when this repo includes it.
 

package/dist/init/config.json

@@ -32,6 +32,21 @@
     "receipts_path": ".mdkg/db/receipts",
     "migration_table": "mdkg_schema_migration"
   },
+  "customization": {
+    "standards": {
+      "profile": "default",
+      "refs": []
+    },
+    "core_docs": {
+      "custom_paths": []
+    },
+    "skill_mirrors": {
+      "targets": [
+        ".agents/skills",
+        ".claude/skills"
+      ]
+    }
+  },
   "subgraphs": {},
   "pack": {
     "default_depth": 2,

package/dist/init/core/COLLABORATION.md

@@ -0,0 +1,45 @@
+---
+id: rule-7
+type: rule
+title: collaboration profile and operator preferences
+tags: [collaboration, preferences, operator]
+owners: []
+links: []
+artifacts: []
+relates: [rule-human]
+refs: [dec-53]
+aliases: [collaboration, operator-profile]
+created: 2026-06-27
+updated: 2026-06-27
+---
+
+# Purpose
+
+Capture stable collaboration preferences, operating boundaries, and repo-specific
+human expectations so agents can work with less ambiguity.
+
+# Scope
+
+Applies to planning, implementation, review, release, and handoff interactions in
+this repository.
+
+# Compatibility
+
+`COLLABORATION.md` is canonical. `HUMAN.md` remains a one-release legacy alias for
+repos and agent prompts that still reference it; read `COLLABORATION.md` first and
+then use `HUMAN.md` only for compatibility notes not yet migrated.
+
+# Requirements
+
+- Keep top goals, boundaries, and style preferences current.
+- Include ask-before-doing constraints for risky or high-impact actions.
+- Record preferred environment assumptions and validation commands.
+- Preserve local operator customizations during `mdkg upgrade --apply`.
+
+# Notes
+
+Suggested prompts:
+- What are your top 3 goals in this repo right now?
+- What should never happen without confirmation?
+- What coding/review style should the agent prefer?
+- What OS/runtime/test commands should be assumed?

package/dist/init/core/HUMAN.md

@@ -10,9 +10,15 @@ relates: []
 refs: []
 aliases: [human]
 created: 2026-03-10
-updated: 2026-03-10
+updated: 2026-06-27
 ---
 
+# Compatibility
+
+`HUMAN.md` is a one-release legacy alias. Read
+`.mdkg/core/COLLABORATION.md` first when it exists, then use this file only for
+older local notes that have not yet moved to the canonical collaboration profile.
+
 # Purpose
 
 Capture stable collaboration preferences and boundaries so agents can work with less ambiguity.

package/dist/init/core/core.md

@@ -4,6 +4,7 @@
 # This list is included by `mdkg pack --verbose`.
 
 rule-soul
+rule-7
 rule-human
 rule-1
 rule-2

package/dist/init/core/rule-1-mdkg-conventions.md

@@ -92,6 +92,9 @@ Reserved rule IDs allowed by contract:
 - `rule-soul`
 - `rule-human`
 
+`rule-7` is the current canonical collaboration profile. `rule-human` remains a
+one-release legacy alias through `HUMAN.md`.
+
 Examples:
 - `task-183`
 - `edd-14`

package/dist/init/core/rule-3-cli-contract.md

@@ -114,20 +114,20 @@ If a user provides an unqualified ID and it is ambiguous globally:
     - `llms.txt`
     - `CLI_COMMAND_MATRIX.md`
     - `.mdkg/core/SOUL.md` (`id: rule-soul`)
-    - `.mdkg/core/HUMAN.md` (`id: rule-human`)
+    - `.mdkg/core/COLLABORATION.md` (`id: rule-7`)
+    - `.mdkg/core/HUMAN.md` (`id: rule-human`, one-release legacy alias)
     - seeded canonical skills:
       - `.mdkg/skills/select-work-and-ground-context/SKILL.md`
       - `.mdkg/skills/build-pack-and-execute-task/SKILL.md`
       - `.mdkg/skills/verify-close-and-checkpoint/SKILL.md`
     - `.mdkg/skills/registry.md`
     - `.mdkg/work/events/events.jsonl`
-    - `.agents/skills/`
-    - `.claude/skills/`
-    - deterministic `core.md` pin insertion (`rule-soul`, then `rule-human`)
+    - configured skill mirror targets, defaulting to `.agents/skills/` and `.claude/skills/`
+    - deterministic `core.md` pin insertion (`rule-soul`, then `rule-7`, then `rule-human`)
     - ignore policy for generated JSON index/temp/lock files, `.mdkg/pack/`, and raw archive source copies under `.mdkg/archive/**/source/`
   - mirrored skills are append-focused outputs:
     - `.mdkg/skills/` remains canonical
-    - unrelated existing folders under `.agents/skills/` and `.claude/skills/` are preserved
+    - unrelated existing folders under configured mirror targets are preserved
     - same-slug collisions fail by default unless explicitly forced through `mdkg skill sync --force`
 
 ### Guide

package/dist/init/init-manifest.json

@@ -1,17 +1,22 @@
 {
   "schema_version": 1,
   "tool": "mdkg",
-  "mdkg_version": "0.3.7",
+  "mdkg_version": "0.3.9",
   "files": [
     {
       "path": ".mdkg/config.json",
       "category": "config",
-      "sha256": "8055c72aa3c55f8a49d532a735bc29e3baa2e2bf478e9d092b83bec9e46fa78c"
+      "sha256": "715e2f55843dc31f66d4b7d333b5f89ea2aeeacc30f5dfaf7d3fd9f2c41e5fb0"
+    },
+    {
+      "path": ".mdkg/core/COLLABORATION.md",
+      "category": "core",
+      "sha256": "ef60b65b54a57ed54984a49f5ed14453cb4e47170a5660be94eceec26b92b01f"
     },
     {
       "path": ".mdkg/core/core.md",
       "category": "core",
-      "sha256": "d87beecf4229535c0d0feea7deae28b97d0681105a1c282d9961e97918f0bbe8"
+      "sha256": "7d8a5ee16433ac8057234c84c2603a9d568d538f17f0488572da15f59603ca0f"
     },
     {
       "path": ".mdkg/core/guide.md",
@@ -21,12 +26,12 @@
     {
       "path": ".mdkg/core/HUMAN.md",
       "category": "core",
-      "sha256": "75d2e015cd5ba61062cb84246017ee4f4221610d4a56e4a0b332271b90694965"
+      "sha256": "945fb5cb47945735b9529f2b0a322630b3e8aef1c3e69c4ce85dd2db3e905cca"
     },
     {
       "path": ".mdkg/core/rule-1-mdkg-conventions.md",
       "category": "core",
-      "sha256": "15f886e6661046de45ad798c292d74cc1ff3cc14c8cfcc82ed0b8c35635d0477"
+      "sha256": "03db1635d170331517efb0ac24351b477a8020a96e51edf5bd67910a49bb5db7"
     },
     {
       "path": ".mdkg/core/rule-2-context-pack-rules.md",
@@ -36,7 +41,7 @@
     {
       "path": ".mdkg/core/rule-3-cli-contract.md",
       "category": "core",
-      "sha256": "f61b84ff6e5abae91365c4f623ccbd78f25dfcfef09822fefb3abf0119d65739"
+      "sha256": "362fb8f22525f51c15ef54d81f63ebef4ab4b1dbaf37bd1415462a204ab78e45"
     },
     {
       "path": ".mdkg/core/rule-4-repo-safety-and-ignores.md",
@@ -61,7 +66,12 @@
     {
       "path": ".mdkg/README.md",
       "category": "mdkg_doc",
-      "sha256": "5a03de7c4602936e6108b3e8f2916ead8320a4020c335ea9cfd083d59eabf083"
+      "sha256": "e876acfbf3e9de411cd45eb86e7e9bff821f8a5dd6dc933bd6da4ac88a9686e6"
+    },
+    {
+      "path": ".mdkg/skills/author-mdkg-skill/SKILL.md",
+      "category": "default_skill",
+      "sha256": "9ea196cb778e6a777c945b3bba9d51c7574602f413e9a1d5e01e2b95918c0873"
     },
     {
       "path": ".mdkg/skills/build-pack-and-execute-task/SKILL.md",
@@ -71,17 +81,17 @@
     {
       "path": ".mdkg/skills/pursue-mdkg-goal/SKILL.md",
       "category": "default_skill",
-      "sha256": "2bc888092d95b362e402494af4dbe6909204bd5578613d6159753a84efaae16d"
+      "sha256": "0545b011232d6924d84d80ad4b33153e591249d440c55481f125b37923c298d5"
     },
     {
       "path": ".mdkg/skills/select-work-and-ground-context/SKILL.md",
       "category": "default_skill",
-      "sha256": "e50fc3b1a2c79a9a3544ca9df1bf4ca9c312e7c3a51d5e4c6f3314341eca268b"
+      "sha256": "95faee88875233dd2ed2039e941fbe879e3ccf619e1f9f18e3f2313ac5033409"
     },
     {
       "path": ".mdkg/skills/verify-close-and-checkpoint/SKILL.md",
       "category": "default_skill",
-      "sha256": "3e4137b7b6a71f088dee79b5ee2f4743aefa3b43adae07337307db89a24416b6"
+      "sha256": "1e3982ad80a0a8b94d43a80e2b7143a938f6e01aa898b86d0410911f61361107"
     },
     {
       "path": ".mdkg/templates/default/archive.md",
@@ -133,6 +143,11 @@
       "category": "template",
       "sha256": "8f984580aefd02b34639fa7f5d2a834662656bbf2e12f14a285f5ae31aff74ce"
     },
+    {
+      "path": ".mdkg/templates/default/manifest.md",
+      "category": "template",
+      "sha256": "2ff2af58cae6a0381a66949d7d9e997fac6486da85171b09096c43663889da95"
+    },
     {
       "path": ".mdkg/templates/default/prd.md",
       "category": "template",
@@ -193,51 +208,101 @@
       "category": "template",
       "sha256": "08a1bd65297173a1dc9df95776775d406337a419d4bc51863593b6f28777ebdb"
     },
+    {
+      "path": ".mdkg/templates/specs/agent.MANIFEST.md",
+      "category": "template",
+      "sha256": "79fb755c95747d3f673e1333ec3f039d08f76488ba268b7fa32f457d8638ee64"
+    },
     {
       "path": ".mdkg/templates/specs/agent.SPEC.md",
       "category": "template",
       "sha256": "dab10c0ed12aa10a752ee3bd61f263065644826eb950c71a9e3458673edb0ca5"
     },
+    {
+      "path": ".mdkg/templates/specs/api.MANIFEST.md",
+      "category": "template",
+      "sha256": "dd342ab2bd331b716e4b7de9f8c7cfa503703422a4cc88c21fe90ff49b11aa83"
+    },
     {
       "path": ".mdkg/templates/specs/api.SPEC.md",
       "category": "template",
       "sha256": "aee86cadcca31a5a015d7e15ad7503c4aa30f2af0079ec03f857b82b3ecbae59"
     },
+    {
+      "path": ".mdkg/templates/specs/base.MANIFEST.md",
+      "category": "template",
+      "sha256": "056c4ccf8285db72c8befdc6acd165d625dbe892d70e89ce586f081db8e250fc"
+    },
     {
       "path": ".mdkg/templates/specs/base.SPEC.md",
       "category": "template",
       "sha256": "6d4171fac00c2f3d8f2a2ac746b8a47c59aaecebe224c3a0046dd6e6974a1d08"
     },
+    {
+      "path": ".mdkg/templates/specs/capability.MANIFEST.md",
+      "category": "template",
+      "sha256": "0ab2c2f90c6bdcddaafd77ac6cc36422d6ee10cc935942d8f80728f5b184d5cc"
+    },
     {
       "path": ".mdkg/templates/specs/capability.SPEC.md",
       "category": "template",
       "sha256": "68a91e8bbd80d1ff1972e4c31e29f26451d5a1be1d25d414170fdd670010066f"
     },
+    {
+      "path": ".mdkg/templates/specs/integration.MANIFEST.md",
+      "category": "template",
+      "sha256": "7af890bdac5515600661c241dd488c2bc270248ae6fba9afb0307d7a643022a4"
+    },
     {
       "path": ".mdkg/templates/specs/integration.SPEC.md",
       "category": "template",
       "sha256": "e907ce6ebc1fa5a455e31e39036e3f8699dccb3d9e45288c8ea025eaec4ca4a2"
     },
+    {
+      "path": ".mdkg/templates/specs/model.MANIFEST.md",
+      "category": "template",
+      "sha256": "3fe36a424b6eba8542bd08d3e2728ffd7f35d2c72037f2e565757cea15da2e1f"
+    },
     {
       "path": ".mdkg/templates/specs/model.SPEC.md",
       "category": "template",
       "sha256": "56061a241819dfda4d3022c075f744cf6650f5f52c58cd15b0af9d1f613af4f2"
     },
+    {
+      "path": ".mdkg/templates/specs/project.MANIFEST.md",
+      "category": "template",
+      "sha256": "e1f68306a9cff3d73e65a2fea38d52b49dd76921b5d7c7ea9710eb2c23cb6f89"
+    },
     {
       "path": ".mdkg/templates/specs/project.SPEC.md",
       "category": "template",
       "sha256": "386c41852cbb46e7a6ba583a7b0c4126262a56618d8e214aaa601b68d55818b9"
     },
+    {
+      "path": ".mdkg/templates/specs/runtime-agent.MANIFEST.md",
+      "category": "template",
+      "sha256": "4ba2013362597f101fb225bc6a3369a47a0c1cac3de78220efea4e53d42f0393"
+    },
     {
       "path": ".mdkg/templates/specs/runtime-agent.SPEC.md",
       "category": "template",
       "sha256": "53af7c3e172f5ed1297f340aca0be5e53302613d2e6bb9145915067d7b0004c8"
     },
+    {
+      "path": ".mdkg/templates/specs/runtime-image.MANIFEST.md",
+      "category": "template",
+      "sha256": "098debed22f274c9f408defcf330ef27c760e1a3166876f2a6e16cb28cfb4757"
+    },
     {
       "path": ".mdkg/templates/specs/runtime-image.SPEC.md",
       "category": "template",
       "sha256": "37416b045cd7733d1f5e1cc629ac9b6616024d5fa52f2bdcd90110267151e593"
     },
+    {
+      "path": ".mdkg/templates/specs/tool.MANIFEST.md",
+      "category": "template",
+      "sha256": "79e45600a3b83d70e2791cbdff0138b57018a30b7e277d9017b7ba142deccb91"
+    },
     {
       "path": ".mdkg/templates/specs/tool.SPEC.md",
       "category": "template",
@@ -246,7 +311,7 @@
     {
       "path": "AGENT_START.md",
       "category": "startup_doc",
-      "sha256": "d305f0e61c2401814bc51067c8129a3ad131c6217692038bc7ffad012c305451"
+      "sha256": "91e31ae818b29f62ebe77ac24f7e1a2bd10a4fedfc1684da935f0849aaf6d200"
     },
     {
       "path": "AGENTS.md",
@@ -261,12 +326,12 @@
     {
       "path": "CLI_COMMAND_MATRIX.md",
       "category": "startup_doc",
-      "sha256": "84de4e06dd4d6d2b316e17c37bebcec373f1a9500d7107c8dd0ce5ca15048b7d"
+      "sha256": "82c509b91498131304ff2bc94bb7eb2f29c3c207a00bc8bcaf8a6ab52ff9e689"
     },
     {
       "path": "llms.txt",
       "category": "startup_doc",
-      "sha256": "8316bb8f634c6fb290ef1591e9c5b9786a2ddc06d25ab7d448fce8f4aebf65b8"
+      "sha256": "108ac1feb3e11824c9cfc5116aaa83355cb461ad9b0ec5c4bb244f6a70276f31"
     }
   ]
 }

package/dist/init/llms.txt

@@ -4,7 +4,8 @@ Read `AGENT_START.md` first.
 
 Key files:
 - `.mdkg/core/SOUL.md`
-- `.mdkg/core/HUMAN.md`
+- `.mdkg/core/COLLABORATION.md`
+- `.mdkg/core/HUMAN.md` (legacy alias for one release)
 - `.mdkg/README.md`
 - `CLI_COMMAND_MATRIX.md`