release prep (version bumps, tags) when explicitly asked. 'Update CHANGELOG' means only the CHANGELOG.
## Documentation
When counting items in documentation (tools, commands, features), always verify counts by explicitly listing
Steady8 mentions in 2 weeks
No other project uses it yet
3.8k4mo agoReviewMountCreate a free account to mount
hatch run test-unit` - Run test suite
- `hatch run docs:serve` - Build and serve documentation (hot-reloads)
## Development Flow
1. Make changes to code
1. Run `hatch run lint
No other project uses it yet
3.8k9mo agoReviewMountCreate a free account to mount
Additional resources for authoring agents:
- [`docs/llms.txt`](docs/llms.txt) — curated `/llms.txt`-standard index of the full documentation.
- Every documentation page has a clean Markdown twin. Remove the trailing `/` from its canonical
3.8k9mo agoReviewMountCreate a free account to mount
coreutils. Pin GNU with docker
(`debian:stable-slim`) before changing semantics and document a divergence
where it lives. Exit codes and stderr wording are part of the contract.
- **`CommandSpec`, `Argument
Steady5 mentions in 2 weeks
No other project uses it yet
3.8k4mo agoReviewMountCreate a free account to mount
DatabindTestUtil` class (in `testutil/` package) which extends `JacksonTestUtilBase`:
- Provides common assertion methods
- Sample JSON documents and constants
- Helper methods for ObjectMapper creation
- JUnit 5 based (migrated from JUnit 4)
### `@JacksonTestFailureExpected
Steady8 mentions in 2 weeks
No other project uses it yet
3.8k3y agoReviewMountCreate a free account to mount
test ./...` inside `services/` for shared packages. Validate both languages
for scheduler protobuf changes. Documentation-only changes need diff/link/command
checks, not runtime suites.
Run builds/tests as a non-root user. Capability
3.7k4mo agoReviewMountCreate a free account to mount
rather than replace, the
[LLM Prompt-Cache Convention](#llm-prompt-cache-convention-v0328) and
[Documentation Requirements](#documentation-requirements).
1. **Set `trust_env=False` for Bilibili, Douyin, XHS, Zhihu
3.7k2mo agoReviewMountCreate a free account to mount
reads this file automatically and follows the workflows below.
---
## Directory Layout
```
raw/ # Immutable source documents — never modify these
wiki/ # Claude owns this layer entirely
index.md # Catalog of all pages — update
3.7k7mo agoReviewMountCreate a free account to mount
rush build
# Start development server for core vtable package
cd packages/vtable && rushx demo
# Start documentation site
rush docs
# Run tests
rush test
# Run linting
rush eslint
# Fix dependency issues
rush
3.7k17mo agoReviewMountCreate a free account to mount
single authoritative agent entry point. Use its task routing to read the affected subsystem documentation and current source; do not maintain separate instructions here.
@AGENTS.md
3.7k4mo agoReviewMountCreate a free account to mount
catches.
- An include-only `.rst` under `docs/source/` is still discovered as its
own document and ships as a ` ` page; add it to
`exclude_patterns` in `conf.py` (`.. include::` still resolves
3.7k3mo agoReviewMountCreate a free account to mount
mode code blocks
- Is automatically tangled to `config.el` when building
- Includes comprehensive documentation alongside the configuration
- Supports adding new packages and customizations in the appropriate sections
**Important:** When making changes
Steady5 mentions in 2 weeks
No other project uses it yet
3.7k2mo agoReviewMountCreate a free account to mount
Axon 5. The reference guide is located in `docs/reference-guide/` and uses Antora for documentation.
Don't emphasize changes in the documentation. Instead, describe the new status
3.6k6mo agoReviewMountCreate a free account to mount
recurrent states,
random noise), allocate on the device of the relevant data or parameters.
- Document exceptions in a comment: required host allocations (pinned
staging memory, shared-memory slots, checkpoint loading
Steady2 mentions in 2 weeks
No other project uses it yet
3.6k4y agoReviewMountCreate a free account to mount
version-lock note" below), so its spec just imports bare `fastify`. The pattern is documented here for any future caller-injected adapter.
**Adapter-internal framework -- jest `moduleNameMapper` projects** (Express
No other project uses it yet
3.5k42d agoReviewMountCreate a free account to mount
apps, core OS language resources). `disk-plan` is strictly read-only. Durable
storage (Documents, app bundles, user media) is measured but never deletable.
## Conventions
- CLI parsing uses `github.com/urfave/cli/v3
3.5k37d 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.