Skip to content

Commit 180cb16

Browse files
committed
docs: add project context and conda workaround to CLAUDE.md
- Add FASTQ domain concepts summary - Document compression modes - Add conda/glibc linker workaround instructions
1 parent 797d0b9 commit 180cb16

1 file changed

Lines changed: 23 additions & 0 deletions

File tree

CLAUDE.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,15 @@ Read [`AGENTS.md`](AGENTS.md) first. This file only adds Claude-specific guidanc
1111
- Avoid `/fleet` unless the task clearly benefits from parallelism.
1212
- Use autopilot only after `proposal.md`, `design.md`, and `tasks.md` are in place and bounded.
1313

14+
## Project-specific context
15+
16+
This is a **FASTQ compression tool** for bioinformatics. Key domain concepts:
17+
18+
- **FASTQ format**: 4-line records (ID, sequence, +, quality)
19+
- **Block-indexed archive**: Enables random access via block index
20+
- **Read length classification**: Short (ABC), Medium/Long (Zstd)
21+
- **Compression modes**: Archive (default), Streaming (`--streaming`), Pipeline (`--pipeline`)
22+
1423
## Validation
1524

1625
```bash
@@ -20,3 +29,17 @@ cargo test --lib --tests
2029
cargo doc --no-deps
2130
npm run docs:build
2231
```
32+
33+
## Conda/glibc workaround
34+
35+
If tests fail with `__tunable_is_initialized@GLIBC_PRIVATE`, ensure `.cargo/config.toml` uses system GCC:
36+
37+
```toml
38+
[target.x86_64-unknown-linux-gnu]
39+
linker = "/usr/bin/gcc"
40+
```
41+
42+
Or run with:
43+
```bash
44+
PATH="/usr/bin:/bin:/usr/local/bin:$HOME/.cargo/bin" cargo test
45+
```

0 commit comments

Comments
 (0)