Skip to content

refactor(daemon): compress brief prose and demote the sub-issue playbook (MUL-5442) - #6310

Merged
Bohan-J merged 2 commits into
mainfrom
agent/steve-jobs/29a60922
Aug 3, 2026
Merged

refactor(daemon): compress brief prose and demote the sub-issue playbook (MUL-5442)#6310
Bohan-J merged 2 commits into
mainfrom
agent/steve-jobs/29a60922

Conversation

@Bohan-J

@Bohan-J Bohan-J commented Aug 3, 2026

Copy link
Copy Markdown
Collaborator

Part of MUL-5442 (GH #4358). Stacked on #6302 — base is refactor/brief-cross-section-dedup; retarget to main after #6302 merges.

Implements the two greenlit optimization tracks: prose compression (point 2) and skill demotion (point 3). Six static edits, identical for every issue run — #6008 byte stability untouched.

Measured result (standard issue fixture, no org content)

bytes
base (#6302 tip) 17,977
this PR 16,728
net −1,249 (−6.9%)

Per section: BTS 3,378 → 3,065 · Sub-issue Creation 795 → 321 · Output 1,664 → 1,466 · Attachments 451 → 331 · Instruction Precedence 5,245 → 5,101.

Edits

  1. BTS persistent-service bullet (−~230B) — keeps the full handoff contract (only when the service is the deliverable; lifecycle detached; readiness verified; best-effort without a supervisor), drops the operational walkthrough. Pins re-anchored from operational phrasing (stdio redirected to durable logs, PID/profile, verify readiness before replying) to the concepts (durable logs, recorded PID, verify readiness) — per the pin-inventory disposition discussed on the issue.
  2. BTS CI-ban bullet (−~170B) — command blacklist, ONE-snapshot rule, and "CI in flight is a complete hand-off" all kept verbatim; auto-merge/snapshot elaboration trimmed.
  3. Ownership mode (−~130B) — the unless your Agent Identity forbids issue status changes; if it does, skip it clause was stated on all three status bullets; now stated once on the section header. Sentence pins at runtime_config_test.go updated to the new shape (clause pinned once + three short command sentences).
  4. Delivery invariant (−~270B) — three sub-bullets merged into the lead paragraph. All three MUL-4899 pins (Runtime-local paths are never deliverables, NEVER write an absolute path or a file:// URL as a clickable link, path/to/file.ts:42) survive verbatim with zero test changes. Also fixes a stale cross-reference: the text said "(below)" but the per-surface delivery line renders above the invariant.
  5. Sub-issue Creation demoted (−~475B) — the todo/backlog/stage playbook moves to the multica-working-on-issues built-in skill (which already documents all of it, §"Sub-issues" and §"Stages"); the brief keeps a one-line flag map + skill pointer. Anti-dangling guard: skill-side anchors added to TestWorkingOnIssuesSkillCoversIssueLoopContracts so the playbook cannot silently leave the skill while the brief still points at it.
  6. Attachments intro (−~120B) — two sentences collapsed to one; the MUL-4899 "private working copy" framing from refactor(daemon): de-duplicate cross-section rules in the runtime brief (MUL-5442) #6302 is untouched.

Semantic invariants preserved

  • Every BTS behavioral constraint: background-and-yield ban, foreground-blocking collection, persistent-service scope + conditions, external-systems boundary, CI ban + single exception, sign-off ban.
  • Identity precedence: the forbids-clause still governs all three Ownership status calls (moved, not weakened).
  • MUL-4899 delivery contract: all pins verbatim.
  • Sub-issue semantics: all three flags still discoverable in the brief; full playbook one skill-read away, enforced by test.

Tests

  • go test ./internal/daemon/... green (daemon, execenv, repocache); go test -run 'Skill|Builtin' ./internal/service/ green; go build ./..., go vet clean.
  • ./internal/service/ full-suite failures are pre-existing local schema drift (column "kind" does not exist, needs migrated Postgres) — identical failure set without this change; no SQL touched here.
  • No assertion deleted without an equivalent replacement; pin edits are commented with the MUL-5442 rationale inline.

@vercel

vercel Bot commented Aug 3, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
multica-docs Ready Ready Preview Aug 3, 2026 11:47am

Request Review

…ook (MUL-5442)

Six static edits to the issue brief, -1,249 bytes on the standard fixture
(17,977 -> 16,728). All edits are identical for every issue run; prompt-cache
byte stability (#6008) is untouched.

- BTS persistent-service bullet: keep the handoff contract (deliverable-only,
  lifecycle detached, readiness verified, best-effort survival), drop the
  operational walkthrough. Pins re-anchored to concepts (durable logs,
  recorded PID, verify readiness).
- BTS CI-ban bullet: keep the command blacklist and the complete-hand-off
  rule, drop the auto-merge/snapshot elaboration.
- Ownership mode: state the identity-forbids clause once on the header
  instead of once per status bullet.
- Delivery invariant: merge the three sub-bullets into the lead paragraph;
  also fixes the stale '(below)' — the per-surface delivery line renders
  above the invariant, not below it.
- Sub-issue Creation: demote the todo/backlog/stage playbook to the
  multica-working-on-issues skill; the brief keeps a one-line flag map plus
  the skill pointer. Skill-side anchors added to
  TestWorkingOnIssuesSkillCoversIssueLoopContracts so the pointer cannot
  dangle.
- Attachments: collapse the two-sentence CLI-fetch intro into one line.

Every pinned behavioral phrase is either carried verbatim or re-pinned to an
equivalent semantic anchor in the same assertion; no assertion is deleted
without a replacement.

Co-authored-by: multica-agent <github@multica.ai>
@Bohan-J
Bohan-J force-pushed the agent/steve-jobs/29a60922 branch from 65c8408 to f369a90 Compare August 3, 2026 11:08
@Bohan-J
Bohan-J changed the base branch from refactor/brief-cross-section-dedup to main August 3, 2026 11:08
…L-5442)

Review catch by Elon on #6310: the compressed bullet weakened the contract
two ways — the reply requirement dropped 'logs' from the URL/logs/stop
triple (durable logs alone are unobservable if the user is never told where
they are), and the general ownership/cleanup handle narrowed to a bare PID
(a supervisor/profile-managed service has no single stable PID). Both test
pin sets had been updated to the weakened phrases, which would have made the
regression look legitimate.

Keeps the compressed sentence shape; restores both halves of the contract
and pins them ("cleanup handle such as PID/profile", "URL, logs, and stop
instructions") so they cannot be compressed away again. +38 bytes; the PR
still nets -1,211 against main.

Co-authored-by: multica-agent <github@multica.ai>
@Bohan-J
Bohan-J merged commit e92d828 into main Aug 3, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant