AGENTS.md
## Claude Code
- Use plan mode for multi-file, risky, architectural, or ambiguous changes.
- Use subagents only for bounded sidecar work: exploration, review, test triage, or documentation lookup.
- Prefer separate
secret**;
values resolve through `@langwatch/secrets` (ADR-132) and `haven env` masks
them. Module code never reads `process.env`.
## Git and GitHub
- Other changes in the checkout belong to someone else. Stage
5k21d agoReviewMountCreate a free account to mount
code directly to native executables. It uses SWC for TypeScript parsing and LLVM for code generation.
**Current Version:** 0.5.1659
## TypeScript Parity Status
Tracked via the gap test suite (`test-files
No other project uses it yet
5k2mo agoReviewMountCreate a free account to mount
snapshots if UI changes are intentional: `npm run test -w packages/ui -- -u`
4. **Claude CodeReview After PR Creation**:
- After creating a PR, run `npm run claude:review`
- The command
5k16d agoReviewMountCreate a free account to mount
mocking must be implemented.
**Feature Development (Outside-In Approach — applies to ALL work: planning, reviewing, coding, and auditing)**:
- This is a foundational principle, not just a coding guideline. Apply
5k7mo agoReviewMountCreate a free account to mount
window` object to prevent addon bundles from re-including our code, and from needing to recompile our source files.
## UI Components & Storybook
- UI components live in `resources/js/components/ui/` and are available
4.9k3mo agoReviewMountCreate a free account to mount
this without additional arguments.
- `vibe-tools repo` is ideal for repository-specific questions, planning, codereview and debugging. E.g. `vibe-tools repo "Review recent changes to command error handling looking
4.8k16mo agoReviewMountCreate a free account to mount
this is a
known Projucer export quirk, not a code defect, if you see it in a PR.
## PR review priorities
When reviewing pull requests:
- Flag any change to `audiopassthru
4.7k2y agoReviewMountCreate a free account to mount
test naming patterns (start with "test-")
- Killing all sessions would terminate your own Claude Code process
### Git Workflow Reminders
- Our workflow: start from main → create branch → make PR → merge → return
4.7k16mo agoReviewMountCreate a free account to mount
recieve"
sed -i 's/recieve/receive/g' file.py
```
## Use Cases
### When to Use Claude's Agent Capabilities
- **Codereview**: Let Claude analyze thoroughly
- **Debugging**: Benefit from comprehensive analysis
- **Learning**: Get detailed explanations
- **Refactoring
4.7k16mo agoReviewMountCreate a free account to mount
License:** FSL-1.1-MIT. No commercial derivative works. Keep this in mind when generating code or suggesting dependencies.
## Repo Structure
```
extensions/ — Curated, ordered learning path (6 builds
4.6k8mo agoReviewMountCreate a free account to mount
interactive commit tool:**
```bash
pnpm commit
```
### PR Requirements
- ✅ At least 1 approving review from a code owner
- ✅ All status checks passing (CI/CD pipeline)
- ✅ No merge conflicts with the base branch
4.6k7mo agoReviewMountCreate a free account to mount
golang-patterns` and `everything-claude-code:golang-testing` for deeper pattern work.
- **`/simplify`** — Review changed code for reuse, quality, and efficiency, then fix what it finds. Run after non-trivial
4.6k6mo agoReviewMountCreate a free account to mount
tests
- Test edge cases and error conditions
- Follow structured test patterns with proper isolation
### CodeReview Checklist
- Review for security vulnerabilities
- Check for proper error handling
- Verify gas optimization
4.5k13mo agoReviewMountCreate a free account to mount
here; verify each finding against this repository's code, configuration and history before acting on it. Do not assume a reviewer is right, and do not assume it is wrong
4.5k3mo agoReviewMountCreate a free account to mount
defense.
## Git Workflow
Always commit `cargo fmt` changes as a separate commit from code changes.
## Test Commands
All integration tests live in `imageflow_core/tests/integration/` as a single binary.
```bash
just
4.4k19mo agoReviewMountCreate a free account to mount
only used within the same module. Export only the public API.
### 7. Git & CodeReview
- Commit small and often — Each commit should have a single purpose.
- Use descriptive commit messages
4.4k10mo 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.