chore: rewrite AGENTS.md + gitignore scratch (council Phase A, rebased)

[Gradata]

Clean rebase of #146. Drops 41 stale m1 commits (merged via #144) and keeps only the Phase A content.

Changes

• Gradata/AGENTS.md +194 lines (rewrite to match SDK reality)
• Gradata/.gitignore +7 lines (scratch dirs)

Test results

4061 pass / 4 skip / 3 fail (all 3 pre-existing on origin/main, unrelated to docs-only Phase A)

[greptile-apps]

Your free trial has ended. If you'd like to continue receiving code reviews, you can add a payment method here.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 18d70295-7c93-46bb-badf-03de521e6584

📥 Commits

Reviewing files that changed from the base of the PR and between 8f57c14 and ffc05f0.

📒 Files selected for processing (2)

• Gradata/.gitignore
• Gradata/AGENTS.md

---

📝 Walkthrough

• Rewrites AGENTS.md with comprehensive standardized instructions for AI coding agents operating in the Gradata repository
• Documents project scope, strict layering constraints, and core architecture including the Brain data model
• Specifies common developer commands (tests, lint/format, type check, security scan, build, module entrypoints)
• Defines conventions for optional dependencies, safe exception handling, atomic file writes, and non-thread-safe Brain coordination
• Sets testing expectations with deterministic guarantees and integration-test gating requirements
• Establishes commit/PR formatting and coordination workflow requirements for multi-file changes
• Updates .gitignore to ignore scratch and temporary artifacts (.tmp/, .archive/, sessions/handoff-*.md, /0, /BrainDetail)
• Documentation-only changes; no breaking changes, security fixes, or public API modifications

Walkthrough

This PR adds repository configuration and documentation. It introduces a .gitignore file to exclude temporary artifacts, scratch directories, and session files, along with a new AGENTS.md document providing standardized instructions and architectural guidelines for AI coding agents working in the Gradata repository.

Changes

Cohort / File(s)	Summary
Repository Configuration Gradata/.gitignore	Adds entries to exclude temporary directories (.tmp, .archive), session files, and root-level paths from version control.
AI Agent Documentation Gradata/AGENTS.md	New documentation file establishing standardized instructions for AI agents, including project scope, layering constraints, developer commands, architecture overview, conventions for dependencies and exception handling, testing expectations, and multi-file change coordination workflow.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• chore: rewrite .gitignore for post-Phase-B layout #124: Modifies the repository's .gitignore file similarly, updating ignore entries for the codebase.
• chore: senior-dev polish pass on repo root #65: Performs repository cleanup by updating .gitignore and removing internal session memory files.

Suggested labels

docs

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch rebase/council-phase-a

---

_{Review rate limit: 4/5 reviews remaining, refill in 12 minutes.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}