Skip to content

refactor: optimize goal/propose/tag — prose->table, dedup DRY_RUN, fix propose parallel-Skill claim #91

@JFK

Description

@JFK

Problem

commands/goal.md (241), commands/propose.md (552), and commands/tag.md (425) carry ~1,450 tokens of compressible redundancy and a few precision gaps.

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

  • goal.md: the autonomy model is stated as a table then re-explained in prose (~goal.md:27-42); keep the table. Tighten the TDD-invariant paragraph (~goal.md:142-150) that restates the contract 3x. Make the gate1-vs-gate2 force-continue logic a table (~goal.md:180-182).
  • propose.md — precision fix: remove the misleading "invoke both skills in parallel" instruction (~propose.md:288) — Skill is not parallel-capable in this harness. Clarify title-derivation (~propose.md:158) and the keyword/validation regex mismatch (~propose.md:124-126).
  • tag.md: condense the repeated "skip if DRY_RUN -> bash -> verify" pattern (steps 7/9/10/11/12) and the long push-failure recovery section (~tag.md:324-338).
  • Across all three: collapse prose+bullets pairs that restate the same parse logic into one pseudocode/table block.

Acceptance criteria

Depends on

#1, #2.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingenhancementNew feature or request

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions