Skip to content

Extract agent-neutral install requirements from the Bob doc #483

Closed

Description

@randomparity

Problem

docs/bob-install-requirements.md mixes facts true of every non-marketplace agent with
Bob-specific ones. Epic #482 adds four more agent docs; copying the shared facts into each
would make five copies that drift.

Evidence

  • docs/bob-install-requirements.md §1 (minimum file tree, references/,
    scripts/check-public-safety.sh) and §2 (<plugin root> under copy vs symlink, per-script
    table: skills/deliver/scripts/deliver-write:4 logical cd,
    skills/return-to-town/scripts/publish-handoff:48 physical cd -P) do not depend on Bob.
  • §6's agents/openai.yaml and marketplace rows are adept-side facts; the Bob column is
    Bob-specific.
  • §3 (symlinks/reload), §4 (naming), §5 (collisions), §7 (open decisions) are Bob-specific.

Expected

An agent-neutral install-requirements doc under docs/ holding §1, §2, and the adept-side
half of §6, written with ~/.<agent>/ / <install root> placeholders instead of ~/.bob/.
docs/bob-install-requirements.md keeps §3, §4, §5, §7 and the Bob column of §6, linking
the core doc. No fact appears in both. Verification markers and environments carry over
unchanged.

Proposed approach

Move text, don't rewrite claims. Keep issue #478 references intact. Bump
.claude-plugin/plugin.json (PATCH).

Part of #482

Activity

  1. randomparity commented on Oct 30, 2026

    @randomparity
    OwnerAuthor

    Scope — issue #483

    Tracking metadata

    • blast radius: docs-only; change hazards: none; complexity: S; decompose: one-pr (live derivation; no WORK:DIVINATION on the issue)
    • classification: governed-small-change — ADR 0022 (docs/adr/0022-versioned-manifest-and-bump-gate.md, Accepted 2026-08-19, not superseded) governs the only contract change (version bump); the document move changes no contract or normative behavior.
    • artifact lane: no-spec; review depth: single-pass; design denominator: not-applicable (no-spec)
  2. added
    status:in-reviewadversarial review of the branch running; a PR may not be open yet
    status:awaiting-mergegreen + mergeable; human just clicks merge
    and removed
    status:in-reviewadversarial review of the branch running; a PR may not be open yet
    on Oct 30, 2026
  3. randomparity commented on Oct 30, 2026

    @randomparity
    OwnerAuthor
    • Outcome: handed off — PR docs: extract agent-neutral install requirements from the Bob doc #492 green+mergeable, awaiting human merge.
    • Branch/PR: feat/agent-install-requirements-483, PR docs: extract agent-neutral install requirements from the Bob doc #492.
    • Guardrails: just commit-check, just shape-check, just plugin-check green; managed pre-push hook (just ci) green on the pushed head; CI Verify green on ubuntu and macOS.
    • Review: single-pass gauntlet escalated to $trial-loop on one high finding (leftover old §6 table), fixed; confirming pass approved. Security pass not triggered.
    • Follow-up candidate: the moved citation scripts/check-public-safety.sh:4,11 should read :4,9 (pre-existing; claims not rewritten in this PR).

    MERGE-READY: #492 @ 24cb65c

  4. randomparity commented on Oct 30, 2026

    @randomparity
    OwnerAuthor

    Trajectory — issue #483 (merged)

    • outcome: merged via PR docs: extract agent-neutral install requirements from the Bob doc #492 (merge commit 73e6ffbd0372e68cbc6757cc9b11da9d2a47e8d7, head 24cb65c6e91e73dd6a25e41c0d796279629c4eea), campaign 9ee0df7c8a64-7bc8870d-a6b3-4048-b44d-a042ced88aef.
    • gate: SHA parity, Verify + Pages green for the head, base main contained in head, author MERGE-READY handshake — all held for one head before --match-head-commit merge.
    • guardrails: managed pre-push hook ran just ci on the pushed head; CI Verify green on ubuntu and macOS.
    • surprises: none. Review follow-up candidate: the moved scripts/check-public-safety.sh:4,11 citation in docs/agent-install-requirements.md points past the 9-line script's exec (line 9); the error predates this PR.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:distributionPlugin packaging, releases, publishing, and external listings

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions