Add working agreement modes: ask-permission and PR mode #31

Merged
geusebio merged 1 commit from docs/working-agreement-modes into main 2026-08-21 18:04:52 +00:00
Owner

Adds a Working agreement mode section to VCS.md distinguishing:

  • ask-permission mode (default) — commit/push always wait for explicit
    permission, per action.
  • PR mode — intermediate commits, pushing, opening the draft PR,
    watching CI to green and fixing failures, updating the PR (never
    force-pushing), and marking it ready once all-green and mergeable are
    all automatic within the scope of a task. Merging is not automated by
    the mode either way — it stays governed by the existing automerge-offer
    rule (button, small/low-risk PRs only).

A repo opts into PR mode by declaring it in its own CLAUDE.md; absence of
a declaration means ask-permission mode. Updates the ground-rules bullet,
the "before you commit" checklist, the Work in progress section, and the
quick-reference table to point at the new section instead of stating the
old blanket rule.

Docs-only, no CI in this repo.

Adds a **Working agreement mode** section to VCS.md distinguishing: - **ask-permission mode** (default) — commit/push always wait for explicit permission, per action. - **PR mode** — intermediate commits, pushing, opening the draft PR, watching CI to green and fixing failures, updating the PR (never force-pushing), and marking it ready once all-green and mergeable are all automatic within the scope of a task. Merging is not automated by the mode either way — it stays governed by the existing automerge-offer rule (button, small/low-risk PRs only). A repo opts into PR mode by declaring it in its own CLAUDE.md; absence of a declaration means ask-permission mode. Updates the ground-rules bullet, the "before you commit" checklist, the Work in progress section, and the quick-reference table to point at the new section instead of stating the old blanket rule. Docs-only, no CI in this repo.
Distinguishes the default ask-permission mode, where commit/push always
wait for explicit permission, from PR mode, where intermediate commits,
pushing, opening the draft PR, watching CI to green, and marking it ready
are automatic within the scope of a task. Merging stays gated by the
existing automerge-offer rule in both modes. Consuming repos declare
which mode they run in their own CLAUDE.md; no declaration means
ask-permission mode.
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
Grey.ooo/agent-standards!31
No description provided.