Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion .wiki/Decisions-and-Roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,8 @@ Two roadmap tracks are current:
- **Refactor/umbrella track — #593** ("Umbrella: V2 architecture refactor —
shell primitives, composition root, state reactivity, transport adapter")
sequences the ADR-0004 follow-through into one ordered `/ship` execution
plan, one PR per phase with a human merge gate between phases: Phase 1
plan, phase by phase (shipped under the pre-2026-08-05 per-phase-PR flow;
`/ship` now integrates units onto one branch/PR per run): Phase 1
#586 (`SurfaceLifecycle` + docked right-inspector slot, unblocks #488),
Phase 2 #587 (side-panel registry, unblocks #487, salvages
`feat/nav-section-registry-487p2`/PR #573), Phase 3 #591 (fail-closed
Expand Down
7 changes: 4 additions & 3 deletions .wiki/Development-Workflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,9 +52,10 @@ verification.
- Preserve user-owned dirty-tree changes.
- Track planned work in GitHub issues, not internal files under published `docs/`.
- File high-signal out-of-scope bugs with the `inbox` label.
- In attended `/ship`, ask for explicit merge approval, then the same session may
merge the PR. In explicit unattended mode, do not ask: auto-merge only after a
clean third ChatGPT pass at the current head and green required checks.
- `/ship` never asks to merge on success: it auto-merges once a certified ChatGPT
review exists at the exact PR head with required checks green. It stops for a
human decision only when a review loop exhausts its passes (5 for plans, 3 for
code) or another merge proof condition fails.
- Save genuinely surprising environment/test friction as project memory.

Canonical source: [`CLAUDE.md`](../CLAUDE.md),
Expand Down
26 changes: 15 additions & 11 deletions .wiki/Project-Skills.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,15 @@ Back to [[Home]]. Related: [[Development-Workflow]], [[Operations-Memory]].
The canonical project skills are tracked under the repo-root **`skills/`**
directory (promoted from `.claude/skills` 2026-07-30, #b4cd83b):

- `ship` — plan, implement, test, review, reconcile, and open a PR for one issue.
Attended runs ask before merging and may perform the approved merge; unattended
runs have no merge prompt and auto-merge only after a clean third ChatGPT pass
at the current head plus green CI. Multi-phase attended work uses one PR per
phase; the old separate `ship-phase` skill now just forwards to `/ship`.
- `ship-phase` — deprecated alias that forwards to `/ship <issue> unattended`.
- `ship` — autonomously deliver one or more issues/phases: a coordinator spawns a
fresh worker per unit, iterates each unit's plan through a ChatGPT review loop
to approval (max 5 passes), integrates the implementation onto one branch,
opens one PR, and iterates a ChatGPT code review loop to certification (max 3
passes). It auto-merges without asking when every proof condition holds
(certified head at the exact PR SHA, green required checks, branch protection
permits) and stops for a human decision only when a review loop exhausts its
passes or a merge proof fails. The old attended/unattended split and the
separate `ship-phase` alias were removed 2026-08-05.
- `sql-browser-dashboard` — turns an already-known SQL/result-column
investigation into a validated `PortableBundleV2` Dashboard bundle and
publishes it through the `save_dashboard` MCP tool (or leaves it as a
Expand All @@ -33,13 +36,14 @@ copies:
```

Keep `skills/` canonical. Edit each skill once there; do not replace the
symlinks with copies. `ship`/`ship-phase` can mutate git/GitHub and are only to
be invoked when explicitly requested.
symlinks with copies. `ship` can mutate git/GitHub and is only to be invoked
when explicitly requested.

The skill instructions also require isolation for concurrent shipping, full unit
and build gates, explicit read-only boundaries for review helpers, and reconciliation
of roadmap/ADR/changelog. Automatic merge is limited to explicit unattended runs
that satisfy the three-pass review and current-head CI proof.
of roadmap/ADR/changelog. `/ship` merges automatically only when a certified
ChatGPT review exists at the exact PR head with required checks green; any
failed proof condition halts for a human decision instead.

## Local-only development skills

Expand All @@ -51,7 +55,7 @@ Some skills are **vendored dev tools kept local, not committed** to the repo:
docs are tracked. Install it locally to run `/impeccable`; nothing in CI or
the shipped artifact depends on it.

Rule: `ship`, `ship-phase`, `chatgpt-review`, and `sql-browser-dashboard`
Rule: `ship`, `chatgpt-review`, and `sql-browser-dashboard`
(project workflow skills) are committed under `skills/`. Large general-purpose
skills like `impeccable` stay local and are documented here. The old global
instruction-only `chatgpt-review` is retained as a recoverable timestamped
Expand Down
25 changes: 0 additions & 25 deletions skills/ship-phase/SKILL.md

This file was deleted.

Loading