oxlint --type-check`. Never assume type safety — verify it.
## Code Editing Rules
When reviewing or editing code, do NOT remove code (assertions, type casts, etc.) unless you have verified
Steady5 mentions in 2 weeks
No other project uses it yet
9.3k10mo agoReviewMountCreate a free account to mount
branch. (Lint, tsc and test failures after our changes are still ours.)
- Before calling code dead, search the whole repo (desktop, native, Go callers, string-built names), not one directory
9.3k53d agoReviewMountCreate a free account to mount
directory.
For example, for Rust code, check `rust/AGENT.md`; for Elixir code, check `elixir/AGENT.md`, etc.
## Codereview guidelines
- Assume that code compiles and is syntactically correct.
- Focus on consistency and correctness
9.2k3y agoReviewMountCreate a free account to mount
Instatic
This file is the **agent rule book**. Read it before changing code. Detailed explanations live in `docs/` — start at [`docs/README.md`](docs/README.md) for orientation and follow the links from there
9k5mo agoReviewMountCreate a free account to mount
required:
- General programming concepts such as closures, data structures, and design patterns.
- Refactoring, codereview, or debugging of the user's own business logic.
- Writing scripts from scratch when
No other project uses it yet
9k3mo agoReviewMountCreate a free account to mount
swift test` (or `swift test --enable-test-discovery` on Linux)
3. **[VERY IMPORTANT] Review your code** - ensure it follows all best practices above
4. **[VERY IMPORTANT] Simplify further** - look
Steady3 mentions in 2 weeks
No other project uses it yet
8.9k16d agoReviewMountCreate a free account to mount
without explicit user approval.
Changes to this module require careful review of the safety invariants documented in the code comments.
#### Core concepts
- **`HeapReader<'a>`** — A scoped borrow created exclusively
8.8k58d agoReviewMountCreate a free account to mount
complete review workflow (classification, checklists, verdict format, and posting instructions). This is the primary guide; follow its steps sequentially.
2. `agents/architecture_guide.md` — Codebase architecture and patterns
3. `agents/code_standards.md` — Code quality expectations
Steady3 mentions in 2 weeks
No other project uses it yet
8.5k3y agoReviewMountCreate a free account to mount
Ordering in cached lazy getters" section in `docs/engineering-guidelines.md` (under GC3) for the rationale and code shape.
Test files are free to use `await import` freely.
## Development workflow
After modifying
8.5k47d agoReviewMountCreate a free account to mount
that the allowed tools do not cover then runs
only if Claude Code's safety review passes it. Allow only the tools the job
needs, and keep any `--disallowedTools` list
8.4k4mo agoReviewMountCreate a free account to mount
reasons; don't "simplify" them without understanding what breaks.
3. **Minimal code** — no decorative code. No helpers for single callers, no speculative abstractions, no options for hypothetical future needs
8.2k8mo agoReviewMountCreate a free account to mount
Review Pitfalls (learned from PR history)
These are the most frequent issues raised during codereview on this repo:
### Severity levels
- `critical` = requires immediate human attention
8.2k31d agoReviewMountCreate a free account to mount
site/` TypeScript/Astro code. `../_data/rules.yml` — the file most
contributions edit — has no linter or schema (its conventions live in the root `CLAUDE.md`),
so those are enforced only by review
8.2k31d agoReviewMountCreate a free account to mount
prompts loaded by Antigravity and other harnesses.
2. `.claude-plugin/agents/`: Contains Claude Code adapters. Reviewer adapters use
`omitClaudeMd: true` and `tools: [Read, Grep, Glob]`; the synthesizer and bootstrap
orchestrator
8.1k4d agoReviewMountCreate a free account to mount
code in this repo is named, typed, structured, formatted, tested, and reviewed. Pure Python coding standard; framework-agnostic.
- **`documents/ai/guides/serena.md`** — Always-on. When and how to use Serena MCP for symbol
7.9k14mo agoReviewMountCreate a free account to mount
A file Claude Code reads at the start of every session. It holds the commands, conventions and warnings the agent needs for this project.
Where does it go?
At the repository root. Claude Code also reads CLAUDE.md files in subdirectories when it works there.
What should it contain?
Build and test commands, the project's layout, conventions that aren't obvious from the code, and mistakes to avoid. Short files tend to work better than long ones.
CLAUDE.md or AGENTS.md?
Claude Code reads CLAUDE.md; most other agents read AGENTS.md. Many projects keep one and point the other at it.