Skip to content

docs(agents): sync shared working rules from ai-rules - #18

Merged
BigSimmo merged 1 commit into
mainfrom
rules/shared-rules-sync-20261101
Nov 1, 2026
Merged

BigSimmo merged 1 commit into
mainfrom
rules/shared-rules-sync-20261101

Conversation

@BigSimmo

@BigSimmo BigSimmo commented Nov 1, 2026 •

Copy link
Copy Markdown
Owner

Updates this repository's copies of Josh's shared working rules to the current reviewed public projection from BigSimmo/ai-rules (generated by repository_rule_targets.py, the same logic as sync.sh --repos).

Changed: only the managed shared-cloud-working-rules block in AGENTS.md and the shared prefix of docs/agents/shared-context-and-memory.md. Any project-owned addendum is preserved byte-for-byte; the generator refuses to overwrite unreviewed edits.

Main additions: authorized browser/device testing preference (Chrome, then Edge), reporting missing capability precisely, leaner process guidance, the parallel dev server memory check, and condensed memory-budget wording. No product, clinical or runtime behaviour changes.

Checks: generated from a clean worktree of origin/main. Local docs-link and inventory checks pass; the full docs-maintenance check could not run locally (a formatting dependency was missing in the temporary worktree; it fails identically without this change), so CI is the authority.

Note for local checkouts: the main checkout carries an older uncommitted copy of these two files from an earlier sync. Once this merges, those two local changes are superseded and can be discarded before pulling.


Summary by cubic

Syncs this repo's shared agent working rules from BigSimmo/ai-rules, touching only the managed shared-cloud-working-rules block in AGENTS.md and the shared prefix of docs/agents/shared-context-and-memory.md. The project-owned addendum is preserved byte-for-byte; the generator refuses to overwrite unreviewed edits.

Main additions: authorized browser/device testing preference (Chrome, then Edge), precise reporting of missing capability, leaner process guidance, a parallel dev server memory check, and condensed memory-budget wording. No product, clinical, or runtime behavior changes.

Verification and local checkouts: generated from a clean worktree of origin/main; local docs-link and inventory checks pass, and the full docs-maintenance check could not run locally (missing formatting dependency, fails identically without this change), so CI is the authority. The main checkout still carries an older uncommitted copy of these two files; once this merges, discard those local changes before pulling.

Written for commit 4fdcd68. Summary will update on new commits.

View guided diff


Summary by Gitar

  • Spending approval:
    • Replaced the per-run billable gate with one approval per bounded task or batch, covering retries within a stated maximum
  • PR repair workflow:
    • Added guidance for authorized PR repairs covering check triage, remote head verification and retained merge/deploy authority
  • Skills and handoffs:
    • Added rules for loading only relevant skills and carrying task approvals through trusted handoffs

This will update automatically on new commits.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 1, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-01T11:13:41.383347Z 4fdcd68 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@coderabbitai

coderabbitai Bot commented Nov 1, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

No actionable comments were generated in the recent review.

Recent review info
Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: ASSERTIVE
  • Plan: Team
  • Run ID: 898fea67-43e4-4b00-b28c-2fe008d3f092
Commits

Reviewing files that changed from the base of the PR and between 12ea9ee and 4fdcd68.

Files selected for processing: 2
  • AGENTS.md
  • docs/agents/shared-context-and-memory.md
Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

Included review availability: This review used your included allowance. 0 included reviews remain after this review. Your included PR review attempts over the past 7 days set your current allowance at 1 review per hour.

Summary by CodeRabbit

  • Documentation
    • Clarified guidance for authorized browser and device verification, including how to distinguish local capabilities from hosted CI and observed deployments.
    • Updated task and action boundaries, including approval requirements for sensitive, shared, destructive, merge, and deployment actions.
    • Added spending limits and renewal conditions for billable work, plus guidance for memory operations when project ownership is unknown.

Walkthrough

The shared operating guidance now covers authorized browser and device verification, task authority, delegation, checkpoints, and PR repair. Memory guidance clarifies when work can continue, how memory searches and saves are checked, and how bounded spending approvals apply.

Changes

Operating and memory guidance

Layer / File(s) Summary
Task authority and verification
AGENTS.md, docs/agents/shared-context-and-memory.md
Updates task authority and reporting rules, browser and device verification, PR-repair procedures, host capability checks, and browser resource limits.
Memory handling and spending limits
AGENTS.md, docs/agents/shared-context-and-memory.md
Clarifies conditions for continuing memory work, checks before transmitting memory searches or saves, Windows adapter reservation behavior, and bounded task or evaluation batch spending approvals.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

Merge Risk: Minimal · up to 4fdcd

No actionable product, runtime, security, or operational risk was found in the policy updates.

Important

Pre-merge checks failed

Please resolve all errors before merging. Addressing warnings is optional.

Failed Failed checks: 1 error

Check name Status Explanation Resolution
Verification Claims Error The PR description claims that “Local docs-link and inventory checks pass” but does not name the exact command or check for either result. The description does give a reason for the full docs-maintena… Update the PR description to list each exact verification command or check and its result, for example Ran <exact docs-link command>: passed and Ran <exact inventory command>: passed. Keep the unavailable check explicit, for example `No…
Passed Passed checks: 10 passed
Check name Status Explanation
Title check Passed The title clearly identifies the documentation change and its source. It accurately summarizes the main pull request objective.
Description check Passed The description directly explains the synchronization, affected files, preserved project-owned content, main additions, and verification status. It is related to the changeset.
Docstring Coverage Passed No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentat…
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.
Generated And Sensitive Files Passed PASS — The PR changes only two tracked Markdown files: AGENTS.md and docs/agents/shared-context-and-memory.md. The diff contains documentation and policy text only. No secrets, credentials, tokens…
Risky Git Or Deployment Actions Passed PASS. The PR adds no force-push, hard reset, destructive clean, branch deletion, shared-branch rebase, or production-data mutation instruction. It permits only ordinary feature-branch publication and …
Supabase Project And Schema Safety Passed The pull request changes only AGENTS.md and docs/agents/shared-context-and-memory.md. The diff contains no Supabase project reference, schema, SQL, migration, RLS, policy, or database configuratio…
Runtime And Package Manager Integrity Passed PASS: The PR changes only AGENTS.md and docs/agents/shared-context-and-memory.md. package.json, package-lock.json, and .nvmrc are unchanged. The existing package.json still requires Node >=24.15.0 <25…
Api Route Failure Handling Passed The pull request changes only AGENTS.md and docs/agents/shared-context-and-memory.md. The diff contains working-rule and memory-policy documentation changes only. It does not change API routes, se…
Full details: Docstring Coverage

Explanation

No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentation-only edits and deletions within surviving functions are included; unchanged diff context and fully deleted functions are excluded. Analyzed 0 functions across 0 files. (2 skipped: 2 unsupported.)

Full details: Generated And Sensitive Files

Explanation

PASS — The PR changes only two tracked Markdown files: AGENTS.md and docs/agents/shared-context-and-memory.md. The diff contains documentation and policy text only. No secrets, credentials, tokens, private keys, real .env files, logs, caches, build outputs, browser artifacts, database dumps, or machine-local configuration were found. The files are plain text and the PR description clearly justifies the generated documentation sync.

Full details: Risky Git Or Deployment Actions

Explanation

PASS. The PR adds no force-push, hard reset, destructive clean, branch deletion, shared-branch rebase, or production-data mutation instruction. It permits only ordinary feature-branch publication and an explicitly authorized push (AGENTS.md:13; docs/agents/shared-context-and-memory.md:17-23). Merge, automerge, migration, sensitive actions, and deployment retain applicable authority, and the text states that a finished agent turn is not deployment evidence (AGENTS.md:13; docs/agents/shared-context-and-memory.md:22-23).

Full details: Supabase Project And Schema Safety

Explanation

The pull request changes only AGENTS.md and docs/agents/shared-context-and-memory.md. The diff contains no Supabase project reference, schema, SQL, migration, RLS, policy, or database configuration change. The references to migrations and production authority are general working rules, not database operations.

Full details: Runtime And Package Manager Integrity

Explanation

PASS: The PR changes only AGENTS.md and docs/agents/shared-context-and-memory.md. package.json, package-lock.json, and .nvmrc are unchanged. The existing package.json still requires Node >=24.15.0 <25 and npm 11.x, and .nvmrc remains 24. No package-manager switch, lockfile bypass, engine weakening, or force/legacy resolution flag was introduced.

Full details: Api Route Failure Handling

Explanation

The pull request changes only AGENTS.md and docs/agents/shared-context-and-memory.md. The diff contains working-rule and memory-policy documentation changes only. It does not change API routes, server actions, RAG, search, ingestion, or provider integrations, so this check is not applicable.

Full details: Verification Claims

Explanation

The PR description claims that “Local docs-link and inventory checks pass” but does not name the exact command or check for either result. The description does give a reason for the full docs-maintenance check not running, but the passed checks do not meet the required exact-command/check format. The reviewed diff changes only AGENTS.md and docs/agents/shared-context-and-memory.md; the verification claim is in the supplied PR description.

Resolution

Update the PR description to list each exact verification command or check and its result, for example Ran &lt;exact docs-link command&gt;: passed and Ran &lt;exact inventory command&gt;: passed. Keep the unavailable check explicit, for example Not run: &lt;exact docs-maintenance command&gt;; formatting dependency was missing, and the unchanged baseline fails for the same reason.

Finishing Touches
Simplify code
  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

@gitar-bot

gitar-bot Bot commented Nov 1, 2026

Copy link
Copy Markdown

Important

You are using the Gitar free plan. Upgrade to unlock code review, CI analysis, auto-apply, custom automations, and more.

Gitar

@BigSimmo
BigSimmo merged commit b3c1436 into main Nov 1, 2026
7 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