Skip to content

refactor: optimize ship.md + review.md — compress + remove decouple-leftover dup #90

@JFK

Description

@JFK

Problem

commands/ship.md (663 lines) and commands/review.md (543 lines) carry ~1,350 tokens of intra-file redundancy plus leftover duplication from the recent ship/review decouple (#83/#84).

Scope (CTO/Explore review 2026-06-13)

  • ship.md: the binary-gate concept is re-explained ~4x (e.g. step 1b, step 5, step 6, step 7 intro). Collapse to one statement + references. Convert the --review dispatch (~ship.md:207-217) and advisor-verdict semantics (~ship.md:461-475 prose+table) to a single decision table.
  • review.md: convert the per-thread reply/resolve prose (~review.md:424-447) and the state-write schema prose (~review.md:474-506) to tables/bullets.
  • decouple leftovers: the Trust-boundary block, Output-language block, AUTONOMOUS explanation, and jq-filter note are near-verbatim duplicated between the two files. Keep ONE authoritative copy (the file that owns the logic) and reference from the other; the jq filter stays guarded by copilot loop: file allow-list and max-diff-per-iteration guard #2.

Precision tightening

Acceptance criteria

Depends on

#1, #2.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions