LearnNewsExamplesServices
Frontmatter
id17640
titleScaffold neomjs/neo-agent-brain: dev branch, labels, provenance shell
stateClosed
labels
enhancementaiagent-os
assigneesneo-opus-vega
createdAtAug 23, 2026, 8:18 PM
updatedAtAug 24, 2026, 4:42 PM
githubUrlhttps://github.com/neomjs/neo/issues/17640
authorneo-opus-vega
commentsCount0
parentIssue17500
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[]
blocking[]
closedAtAug 24, 2026, 4:42 PM

Scaffold neomjs/neo-agent-brain: dev branch, labels, provenance shell

Closed Backlog/active-chunk-19 enhancementaiagent-os
neo-opus-vega
neo-opus-vega commented on Aug 23, 2026, 8:18 PM

Context

The operator created neomjs/neo-agent-brain (2026-08-23T17:57Z, Neo.mjs AI Devs team = maintainers) — Epic #17500's leaf 5, unblocked since the #17502 naming close + ADR 0040 merge. The repository is empty: unborn default branch, no contents, the 9 stock GitHub labels. Operator direction (in-session, same day): start the in-repo prep now — labels, package placeholder, shell files — while ticket migration waits for the cut; reserve heavier budget for the cut window.

The Problem

Every downstream leaf needs a repository that is not a bare shell: leaf 8's canary transfer needs the label taxonomy provisioned first (its explicit first half); the move leaf needs a dev working branch + branch discipline to target; ADR 0040 §2.9 requires the provenance statement (fresh history + pointer, no neomjs/neo SHA rewrite) recorded where a visitor lands. An empty repo also cannot receive a pull request, so the very first commit is direct by necessity — that exception must be one minimal, recorded init commit, never a habit.

The Fix

  1. Branch topology: one minimal init commit (README shell only) creates dev directly — the single unavoidable direct push, recorded here; set dev as the default branch; main stays uncreated until the release machinery makes it (mirroring the Engine's main-is-release-only shape, per the new repo's own cadence per ADR 0040 §3).
  2. Labels: sync the neomjs/neo taxonomy (name + color + description; create-or-update, stock labels updated in place) so leaf 8's canary lands on identical semantics.
  3. Shell files via branch + PR onto dev: README (what this repo is, pre-move status, provenance pointer per ADR 0040 §2.9, link to Epic #17500 + the ADR in neomjs/neo), LICENSE (MIT, mirroring the Engine), .gitignore (minimal seed), package.json placeholder (name, private: true, description, a $comment naming ADR 0040 as the manifest authority and the move leaf as the writer — root scripts stay EMPTY: the root manifest becomes the Host-Edge package only at the move).
  4. Commit convention: cross-repo ticket refs in full form (neomjs/neo#NNNNN) until the tracker migrates.

Decision Record impact

aligned-with ADR 0040 (§2.1 root topology deferred to the move; §2.9 provenance; naming). No ADR touched.

Acceptance Criteria

  • dev exists, is the default branch, and holds exactly one direct init commit (README shell); every subsequent change lands via branch + PR.
  • The label set matches neomjs/neo's (name/color/description), verified by a diff of both label lists in the PR/receipt.
  • README states: pre-move shell · Brain-of-the-organism identity · provenance rule (fresh history, no Engine SHA rewrite, pointer to neomjs/neo) · Epic #17500 + ADR 0040 links.
  • package.json placeholder is private: true with empty scripts and the $comment authority pointer; no dependency and no workspaces key.
  • main does not exist.
  • No production/AgentOS source file moves (the move leaf owns relocation; blocking proofs unaffected).

Out of Scope

Ticket/tracker migration (leaf 8 canary + bulk) · any ai/** relocation · npm publish/name reservation (operator-owned) · CI workflows (the workflow-disposition leaf owns them) · seat provisioning (leaf 11).

Related

Parent: Epic #17500 (leaf 5). Authority: ADR 0040. Naming: #17502 (closed). Blocking proofs untouched: #17533.

Origin Session ID: 0fdaef3c-fcaf-4983-87a3-88d6eb611357

Retrieval Hint: query_raw_memories("neo-agent-brain scaffold dev branch labels provenance shell")

Live latest-open sweep: checked latest 8 open issues at 2026-08-23T18:13Z (newest #17635); no equivalent. A2A in-flight sweep: continuous wake stream this session; no scaffold claim.

tobiu cross-referenced by PR #1 on Aug 23, 2026, 8:21 PM
tobiu referenced in commit 194e939 - "chore: the ignore seed becomes a real one, and the copyright starts when the repo did (neomjs/neo#17640) on Aug 24, 2026, 12:12 PM
tobiu referenced in commit 6107629 - "Merge pull request #2 from neomjs/vega/17640-scaffold-shell on Aug 24, 2026, 4:42 PM
tobiu closed this issue on Aug 24, 2026, 4:42 PM