Skip to content

docs: harness-agnostic session rules with async non-blocking I/O - #13

Merged
Igor Holt (igor-holt) merged 1 commit into
mainfrom
docs/session-operating-rules
Aug 31, 2026
Merged

docs: harness-agnostic session rules with async non-blocking I/O#13
Igor Holt (igor-holt) merged 1 commit into
mainfrom
docs/session-operating-rules

Conversation

@igor-holt

@igor-holt Igor Holt (igor-holt) commented Aug 31, 2026

Copy link
Copy Markdown
Member

Summary

Adds shared agent operating rules so every harness (Claude, Grok, Codex, Cursor, Gemini, Copilot, OpenCode, OpenClaw) loads the same session contract.

What landed

  • AGENTS.md, CLAUDE.md, GEMINI.md — session operating rules at the top
  • .grok/rules/session-operating-rules.md — Grok auto-load
  • Copilot instructions synced (copilot-instructions.md and .github/copilot-instructions.md)

Session contract

  • Truthfulness: never report findings from still-running commands or empty MCP confirmations; mark unknown sources [UNVERIFIED]
  • Disk preflight: df -h / and tmp before long installs/builds/tests; stop under 5GB free
  • Async / non-blocking I/O: background long commands; no status-tool poll loops; every network/subprocess call has a timeout
  • Git: separate -m flags; stop if the branch carries unrelated commits; never commit PII/credentials
  • Contracts: Foundry verify with relative paths; Base 8453 only for live deployments

This branch is a single commit off main (not the mixed chore/gitignore-gemini-gha-creds branch).

Test plan

  • Confirm AGENTS.md / CLAUDE.md / GEMINI.md render and headings match
  • Confirm Copilot instructions include the Async I/O bullet
  • CI / required checks green

View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

Add AGENTS.md, CLAUDE.md, and GEMINI.md so every agent harness loads the same operating rules. Sessions must use background commands, bounded timeouts, and no status-tool poll loops. Copilot instructions and .grok/rules stay in sync with ~/.agents/session-operating-rules.md.

@claude claude 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.

⚠️ Code review skipped — your organization's overage spend limit has been reached.

Code review is billed via overage credits. To resume reviews, an organization admin can raise the monthly limit at claude.ai/admin-settings/claude-code.

Once credits are available, push a new commit or reopen this pull request to trigger a review.

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@igor-holt
Igor Holt (igor-holt) requested a lite review from Copilot August 31, 2026 19:30
@sonarqubecloud

Copy link
Copy Markdown

Copilot AI 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.

The job was not started because the account is locked due to a billing issue.

@igor-holt
Igor Holt (igor-holt) merged commit 30e727d into main Aug 31, 2026
5 of 6 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.

2 participants