Skip to content

feat: collaborative mode refreshes STATUS.md before every terminal PR push - #30

Merged
moui72 merged 12 commits into
mainfrom
feat/collab-status-refresh
Jul 31, 2026
Merged

feat: collaborative mode refreshes STATUS.md before every terminal PR push#30
moui72 merged 12 commits into
mainfrom
feat/collab-status-refresh

Conversation

@moui72

@moui72 moui72 commented Jul 27, 2026

Copy link
Copy Markdown
Owner

Plan plan-feat-collab-status-refresh-2026-07-27-7811.md (approved) + ready tasks file tasks-feat-collab-status-refresh-18bc.md (6 tasks, complexity: moderate — first dogfood of the new stamp) implementing feedback F001: in collaborative mode, no ArDD skill pushes a feature branch whose STATUS.md predates the state the push carries. Scopes the delegated-no-/ardd-status rule to solo mode, adds the coordinator refresh-before-push step, and gives /ardd-plan's collaborative endings a terminal refresh. Supersedes the rejected ci-status-refresh-on-main-coll CI approach (research doc on PR #29's branch).

Stacked on feat/complexity-model-routing (PR #29) — base rewrites to main when #29 merges. Implementation follows on this branch.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Clarified collaborative-mode sequencing so STATUS.md is refreshed and committed on the feature branch before any terminal push or pull request offer.
    • Tightened ownership rules: delegated subagents must not run /ardd-status; coordinators perform the refresh and report-back.
    • Added guidance to prevent pushing outdated status, including an exemption for initial draft-PR visibility.
    • Updated planning/implementation/status references and task tracking.
  • Chores
    • Refreshed the project status and feedback records to reflect the completed workflow updates.

@coderabbitai

coderabbitai Bot commented Jul 27, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: ff5122ea-68f2-47ce-8797-43dd015bbc5b

📥 Commits

Reviewing files that changed from the base of the PR and between 5aa82f9 and c998a18.

📒 Files selected for processing (1)
  • .project/plans/plan-feat-collab-status-refresh-2026-07-27-7811.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • .project/plans/plan-feat-collab-status-refresh-2026-07-27-7811.md

Walkthrough

The change defines a collaborative-mode invariant requiring coordinator-run STATUS.md refresh and commit before terminal pushes or PR offers, then synchronizes implementation, planning, status, architecture, and reference documentation.

Changes

Collaborative status refresh

Layer / File(s) Summary
Invariant plan and task tracking
.project/plans/..., .project/tasks/..., .project/feedback/..., .project/STATUS.md
Adds the refresh invariant, phased tasks, planned feedback state, and status-history entries documenting the work.
Delegated implementation refresh flow
skills/ardd-implement/SKILL.md, docs/reference/skills/ardd-implement.md, CLAUDE.md
Requires the coordinator to fast-forward, refresh and prune STATUS.md, commit it, and only then offer a push or PR.
Plan and status skill synchronization
skills/ardd-plan/SKILL.md, skills/ardd-status/SKILL.md, docs/reference/skills/ardd-plan.md, docs/reference/skills/ardd-status.md
Documents terminal refresh ordering, primary-checkout execution, and delegated-worktree restrictions.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant DelegatedSubagent
  participant Coordinator
  participant FeatureBranch
  participant ArDDStatus
  DelegatedSubagent->>Coordinator: report completed branch
  Coordinator->>FeatureBranch: fast-forward reported changes
  Coordinator->>ArDDStatus: refresh and prune STATUS.md
  ArDDStatus->>FeatureBranch: write refreshed STATUS.md
  Coordinator->>FeatureBranch: commit refresh
  Coordinator->>FeatureBranch: push or offer PR
Loading

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main collaborative-mode STATUS.md refresh invariant added by the PR.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/collab-status-refresh

Comment @coderabbitai help to get the list of available commands.

@moui72
moui72 marked this pull request as ready for review July 29, 2026 13:28
moui72 pushed a commit that referenced this pull request Jul 30, 2026
…le base)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HnmhbSPHnwMVrxfVT3pTjy
CI and others added 11 commits July 30, 2026 14:14
…riant

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Re-scope the delegated-no-status note's trapped-write rationale to solo
mode and add the collaborative report-back sequence: side-effect checks,
ff feature branch onto the reported branch, mandatory /ardd-status
refresh + prune + commit before any push/PR offer.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Step 8's inline terminal /ardd-status is what satisfies the invariant in
collaborative mode; push/PR offers must follow it, never precede it.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…(T003)

The terminal /ardd-status (refresh + prune) runs on the feature branch
and is committed before any terminal-state push/draft-PR offer, so a
plan-only PR's STATUS.md matches the plan/tasks state it carries.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
… (T004)

Feature-branch runs in the primary checkout are the required norm in
collaborative mode; the prohibition targets delegated worktrees (all
modes) plus solo mode's trapped-write case. States the shared invariant.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ference pages (T005)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…pass)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HnmhbSPHnwMVrxfVT3pTjy
…le base)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HnmhbSPHnwMVrxfVT3pTjy
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HnmhbSPHnwMVrxfVT3pTjy
@moui72
moui72 changed the base branch from feat/complexity-model-routing to main July 30, 2026 18:15
@moui72
moui72 force-pushed the feat/collab-status-refresh branch from a40230f to 5aa82f9 Compare July 30, 2026 18:15

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.project/plans/plan-feat-collab-status-refresh-2026-07-27-7811.md:
- Around line 101-109: Resolve the open question in the “Open Questions” section
by explicitly recording the approved policy for exempting first-commit or other
incremental visibility pushes, consistent with T001. Remove the request for
later confirmation or policy reconsideration so the plan is an unambiguous
source of truth.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: d81aa057-f5de-4ec1-9537-59acc1f23caf

📥 Commits

Reviewing files that changed from the base of the PR and between f79abe9 and 5aa82f9.

📒 Files selected for processing (11)
  • .project/STATUS.md
  • .project/feedback/feedback-collab-status-refresh-before-pr-a28b.md
  • .project/plans/plan-feat-collab-status-refresh-2026-07-27-7811.md
  • .project/tasks/tasks-feat-collab-status-refresh-18bc.md
  • CLAUDE.md
  • docs/reference/skills/ardd-implement.md
  • docs/reference/skills/ardd-plan.md
  • docs/reference/skills/ardd-status.md
  • skills/ardd-implement/SKILL.md
  • skills/ardd-plan/SKILL.md
  • skills/ardd-status/SKILL.md

Comment thread .project/plans/plan-feat-collab-status-refresh-2026-07-27-7811.md Outdated
Addresses CodeRabbit review on PR #30: the Open Questions section still
asked for confirmation of a scoping decision that was approved at the
checkpoint and shipped in T001. Records the resolution instead.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HnmhbSPHnwMVrxfVT3pTjy
@moui72

moui72 commented Jul 30, 2026

Copy link
Copy Markdown
Owner Author

Addressed in c998a18 — the Open Questions section now records the approved resolution (mid-run visibility pushes exempt; the invariant binds only terminal-state pushes) and cites where it's implemented in ardd-implement/ardd-plan, rather than still asking for confirmation.

@moui72
moui72 merged commit 691a0d3 into main Jul 31, 2026
53 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant