claude.ai/code) when working with code in this repository.
## Important
- ALL instructions within this document MUST BE FOLLOWED, these are not optional unless explicitly stated.
- ASK FOR CLARIFICATION
Steady7 mentions in 2 weeks
No other project uses it yet
4.6k6mo agoReviewMountCreate a free account to mount
observability platform built on OpenTelemetry. This repository contains the Python SDK for Logfire and documentation. The server application for recording and displaying data is closed source.
Key aspects:
- Opinionated wrapper
4.6k12d agoReviewMountCreate a free account to mount
Agent framework documentation
These guides must describe integrations that users can reproduce. Treat every code sample and support claim as
product behavior, not illustrative pseudocode.
## Required standard
- Use the framework
4.6k12d agoReviewMountCreate a free account to mount
paths
- Consider caching strategies for frequently accessed data
- Optimize database queries in backend services
## 📝 Documentation Standards
- Update README files when adding new features
- Document complex algorithms and business logic
- Keep
4.5k13mo agoReviewMountCreate a free account to mount
duplicating
already existing functionality results in contract termination.
- Implementation notes and plans and documents generated while developing belong
in `./docs/notes/`. Ensure that notes have a frontmatter with `date`, and
`reason
4.5k13mo agoReviewMountCreate a free account to mount
next to their output.
- `tests/Unit` — PHPUnit tests; `docker/` and `docker-compose.yml` — local stack; `docs/` — user documentation.
## Conventions
- Configuration lives in `config.php` (copy of `config-sample.php`), not in environment variables.
- Console commands
4.5k3mo agoReviewMountCreate a free account to mount
Guidelines
### Code Standards (from .cursor/rules)
- **No comments or Javadoc** in final code - use self-documenting naming
- **Incremental refactoring** - small testable steps with commits after each step
- **Extract only what
4.5k17mo agoReviewMountCreate a free account to mount
errors.
- Avoid deeply nested logic — Extract nested logic into helper functions or early returns.
- Document all exported functions with JSDoc — Include parameter descriptions, return types, and behavior notes. Code should
4.4k10mo agoReviewMountCreate a free account to mount
Project instructions
NestJS boilerplate supporting both relational (TypeORM/PostgreSQL) and document (Mongoose/MongoDB) persistence.
## When adding entities, schemas, or properties
Use the `generate` skill (auto-loaded from [.claude/skills/generate/SKILL.md](.claude/skills/generate/SKILL.md)). It documents
4.4k6mo agoReviewMountCreate a free account to mount
touch it, and never replicate a change made to `/lib`, `index.js` or `promise.js` there.
- Documentation: `website/docs/` (Docusaurus).
- Tests:
- Unit: `test/unit`, parallel.
- Integration: `test/integration`, parallel, alongside the unit tests.
- Global: `test/global
Steady2 mentions in 2 weeks
No other project uses it yet
4.4k3mo agoReviewMountCreate a free account to mount
repository entrypoint. Follow its task-scoped links instead of loading every maintenance/build document for every edit. Verification and delivery routing is in [docs/AGENT_WORKFLOW.md](docs/AGENT_WORKFLOW.md).
## Branch and WSL environment
These points
4.4k2mo agoReviewMountCreate a free account to mount
ever uncertain about what the intended behavior should be, refer to the documentation in DOCS.md.
## Common Commands
### Development Setup
```bash
make dev # Install development environment with all dependencies
4.4k11mo agoReviewMountCreate a free account to mount
that names a tool unlocks it for that
agent. Recommended models live in the documentation.
## Trace a behavior problem
1. Resolve the active agent, its configured prompt and permissions
4.3k2mo agoReviewMountCreate a free account to mount
complete guide. Key rules
are summarized below.
### Comments
- Use `///` for public API documentation (classes, public methods, public members).
- Use `//` for private/protected members and comments inside code blocks.
- Start comments with
4.3k59d agoReviewMountCreate a free account to mount
build`
- **Mandatory Rules**:
- Always write/update unit tests for any code changes.
- Always update documentation in `website/docs/` if config/features change.
- Always update `website/docs/changelog/next.md` with your change.
- Run linters before finishing
4.2k22d agoReviewMountCreate a free account to mount
useCallback` and `useMemo` for stable references
3. Add comprehensive unit tests
4. Document return types with TypeScript
5. Export from `src/hooks/index.ts`
### Debugging Test Failures
- Unit tests: Check `coverage/` directory
4.2k19mo 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.