> For the complete documentation index, see [llms.txt](https://as-pect.gitbook.io/as-pect/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://as-pect.gitbook.io/as-pect/agents.md).

# AGENTS.md

## Project Philosophy

`as-pect` exists to make testing AssemblyScript projects feel simple, fast, and dependable.

When working in this repository, prefer changes that support these goals:

1. **Make testing AssemblyScript projects simple.** Keep APIs, CLI flows, fixtures, and documentation easy to understand. Optimize for the shortest path from writing a test to getting useful feedback.
2. **Reduce dependencies as much as possible.** Avoid adding packages unless they clearly pay for their complexity. Prefer small, local implementations and standard platform features when practical.
3. **Make testing AssemblyScript projects fast.** Protect startup time, execution time, and developer feedback loops. Treat unnecessary work, heavy abstractions, and avoidable I/O as costs to justify.

Favor maintainable, focused changes that preserve compatibility for existing `as-pect` users while making the testing experience simpler, leaner, and faster.

## Commit Philosophy

Make commits atomic and easy to review. Separate distinct units of work into separate commits, each with a clear title and a descriptive commit message that explains the intent, context, and user-visible impact of the change.