Skip to content

Ship the autoresearch director protocol as public skill content (the #390 content half) #466

Closed

Description

@aarontrowbridge

Important

Problem — The autoresearch director protocol (session ledgers, the hypothesizer/experimenter/analyzer trio, deliberate spec gates, checkout registry, compaction-any-time safety) has been running the studio all week — but only as staged server plumbing + a team-vault canonical copy (armonissima #58). Public content's canonical home is the product repo (packages/extension/skills/, surface: public per package_skills.ts); the protocol is the spine of the open-source autoresearch positioning and ships to users, not just to this install.

Approach — Ship skills/autoresearch/SKILL.md in the in-repo public library with surface: public, engine-neutral, personal-vault paths genericized (the armonissima copy retires in favor of this canonical). The stage-internal-skills comment already names this pattern: content is homed when its issue arc arrives — #369 is closed, #390 is unblocked, and this is #390's content half.

Scope — in: the one skill file (public-adapted from armonissima #58) · out: the agent-card shipping machinery (extension prep emitting .opencode/agents/ — that is #390's own AC "role subagent registration"), the mode switch itself (#390), pack folding (WS2).

Acceptance Criteria

  • packages/extension/skills/autoresearch/SKILL.md exists with surface: public, engine-neutral protocol, no install-specific paths (personal vault referenced generically)
  • The packaging leak-guard stays green (no internal-surface skill ships; autoresearch is public by frontmatter)
  • The armonissima internal copy retires in a follow-up vault PR pointing here as canonical (single source of truth)

Key Decisions

  • Canonical flips: amicode repo becomes the source of truth for the shipped protocol; armonissima keeps only internal workflow skills (develop/tdd/write-an-issue lineage).
  • The opencode binding (the autoresearch primary agent card) stays engine-side per develop's Role binding section — this PR ships the role-neutral protocol only.

Prior Art

  • armonissima 1.3 — RunInspector → multi-run #58 (the protocol, promoted from staging 2026-08-20); the 2026-08-20 stack review note (one protocol, one harness, one trust architecture); spec-20260818-193000 (round-1 critics, round-2 mechanical review).

Source

Part of #390 (content half). Provenance: the 2026-08-18→20 studio sessions.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions