What is the Neural Link?

The Neural Link is a bi-directional bridge that connects AI agents directly to the Neo.mjs runtime. It lets agents inspect the Scene Graph, component state, event listeners, computed styles, and DOM rectangles, and mutate the running application in real time.

Why is Neo.mjs called an Application Engine instead of a framework?

Neo.mjs maintains persistent application objects in a worker-backed Scene Graph instead of compiling application state away into ephemeral DOM nodes. That architecture enables multi-window orchestration, runtime permutation, and deep AI introspection.

What is Context Engineering?

Context Engineering shapes the information and tool environment around AI agents. Neo.mjs implements it through Knowledge Base, Memory Core, GitHub Workflow, and Neural Link MCP servers for frontier harnesses, plus a File System MCP server for internal Neo.ai.Agent local loops.

What is the Neo.mjs Agent OS?

The Neo.mjs Agent OS is the repository Brain: source code and services for Memory Core, Knowledge Base, Active Hybrid GraphRAG, DreamService, Golden Path synthesis, A2A coordination, and Neural Link tooling.

Frontmatter

id	11950
title	Inventory skill baggage for decision-atom rollout
state	Closed
labels	documentationenhancementairefactoringarchitecturemodel-experience
assignees	[]
createdAt	May 25, 2026, 4:53 AM
updatedAt	May 25, 2026, 4:54 AM
githubUrl	https://github.com/neomjs/neo/issues/11950
author	neo-gpt
commentsCount	1
parentIssue	null
subIssues	[]
subIssuesCompleted	0
subIssuesTotal	0
blockedBy	[]
blocking	[]
closedAt	May 25, 2026, 4:54 AM

Inventory skill baggage for decision-atom rollout

Closed v13.0.0/archive-v13-0-0-chunk-13 documentationenhancementairefactoringarchitecturemodel-experience

neo-gpt commented on May 25, 2026, 4:53 AM

Context

Parent epic #11605 defines the skill-baggage compression program. #11884 completed the first AC1/AC2 slice by codifying the decision-atom lesson-promotion shape. The next missing parent handle from the prior GPT epic review is AC3: inventory all .agents/skills/**/*.md workflow payloads before piloting hot-path migrations.

This child exists so the parent does not remain a prose-only program and future agents do not jump directly into broad pr-review / pull-request rewrites without evidence.

Duplicate / adjacency sweep

Live #11605 body and comments show #11884 as the existing AC1/AC2 child and name AC3 as a missing child.
Live GitHub search for skill baggage inventory decision atom maps #11605 returned only parent #11605.
Existing adjacent tickets #11604 and #11603 are broader governance / bandwidth concerns, not the concrete inventory artifact.
KB query for skill baggage / decision atom / map-atlas substrate confirmed existing lint and Map-vs-Atlas substrate, but did not surface a #11605 AC3 ticket.

The Problem

The parent epic explicitly rejects a giant all-skills migration and asks for inventory before pilots. Without a concrete inventory ticket, future sessions will either:

start compressing hot-path skills from intuition;
over-focus on byte counts without checking trigger frequency and behavior risk;
miss existing lint/manifest budget signals; or
recreate one-off audits that are not usable as rollout planning input.

The inventory is the evidence layer that makes later pr-review, pull-request, and batch rollout children scoped instead of aesthetic cleanup.

The Architectural Reality

Current substrate already has several relevant anchors:

test/playwright/unit/ai/scripts/lint/lintSkillManifest.spec.mjs covers per-file payload budgets, oversized workflow maps, and section-trigger parsing.
.agents/skills/pr-review/references/pr-review-guide.md and .agents/skills/pr-review/assets/pr-review-template.md already encode Progressive Disclosure / Map-vs-Atlas review gates.
ADR 0007 and ADR 0008 define compaction taxonomy and Progressive Disclosure skill anatomy.
#11884 closed the first source-of-authority slice for Bias -> Rule -> Rationale -> Trigger; this ticket consumes that atom, it does not redefine it.

The inventory belongs as an audit artifact plus ranked rollout plan, not as immediate runtime instruction substrate.

The Fix

Create a focused inventory artifact for .agents/skills/**/*.md workflow payloads:

Enumerate skill payload files, grouped by skill and load role (SKILL.md, workflow map, audit payload, template, incident/provenance payload).
Measure byte count / line count and flag budget or map-pressure signals already covered by lint substrate.
Identify sections with incident/provenance baggage, repeated edge-case stories, absent trigger pointers, or candidate Bias -> Rule -> Rationale -> Trigger compression.
Assign disposition candidates: keep, compress-to-trigger, move, rewrite, or retire.
Produce a ranked rollout table for the pilot and batch tickets, including pr-review and pull-request but not modifying them in this child.

Contract Ledger Matrix

Target Surface	Source of Authority	Proposed Behavior	Fallback / Edge Case	Docs	Evidence
Skill baggage inventory artifact	#11605 AC3; #11884 decision atom source	Records measured skill payload size, section risk, and disposition candidates across `.agents/skills/*/.md`.	If a file is generated or non-workflow-only, classify it and exclude from migration ranking with rationale.	Yes	Artifact includes file list, counts, and disposition table.
Rollout ranking table	#11605 AC4-AC6	Produces candidate order for `pr-review`, `pull-request`, and later batch groups by risk/size, not aesthetic preference.	If inventory shows pilot order should change, document why rather than forcing parent prose.	Yes	Table maps parent ACs to recommended children / follow-ups.
Behavior-preservation signals	#11605 AC9/AC10; ADR 0007/0008	Each candidate disposition notes what behavior must remain load-bearing after compression.	If behavior cannot be preserved by atom+trigger, mark `keep` or `rewrite`, not `retire`.	Yes	Inventory rows include behavior-risk notes and required validation signals.
Existing lint substrate usage	`lintSkillManifest.spec.mjs`; Progressive Disclosure review gates	Inventory reuses existing budget/map concepts instead of inventing a parallel scoring model.	If lint lacks a needed signal, file a follow-up rather than overloading this child.	No new runtime docs by default	Evidence cites the lint/test/source anchor used for each measured signal.

Decision Record impact

Aligned with ADR 0007 and ADR 0008. Depends on #11884 for the decision-atom source of authority. Does not amend ADRs.

Acceptance Criteria

Inventory artifact enumerates .agents/skills/**/*.md payloads by skill and load role.
Inventory records byte count, line count, section count where practical, and existing budget/map-pressure signals.
Inventory identifies incident/provenance baggage, repeated edge-case stories, absent trigger pointers, and decision-atom compression candidates.
Each row has a disposition candidate: keep, compress-to-trigger, move, rewrite, or retire.
Ranked rollout table proposes pilot/batch grouping and explicitly covers pr-review and pull-request.
No broad skill migration is included in this child.
Validation includes git diff --check for the artifact and any relevant skill/manifest lint if touched.

Out of Scope

Editing pr-review, pull-request, or other hot-path skill behavior.
Adding new AGENTS.md rules.
Creating a new lint rule unless the inventory proves a missing signal that deserves a follow-up.
Closing parent #11605.

Avoided Traps

Trap	Why rejected
Byte-count scoreboard only	Parent #11605 targets cognitive-load reduction while preserving behavior, not blind deletion.
One-shot all-skills cleanup	Parent explicitly requires pilots and batches after inventory.
Baggage laundering	Moving prose into another always-loaded file is not a valid disposition.
Re-defining the atom	#11884 already owns the decision-atom source; this child consumes it.

Parent epic: #11605.
Prior child: #11884.
Adjacent: #11604, #11603, #11319, #10537.
Source authorities: ADR 0007, ADR 0008, lintSkillManifest.spec.mjs, /create-skill skill payload.

Origin Session ID: e5a3acc3-d261-4ebf-96b1-4053ab0eafdf

Handoff Retrieval Hint: query_raw_memories("skill baggage inventory decision atom maps #11605 pr-review pull-request map atlas")