plugins` and `just sync-plugins-to-docs` commands. Do not update both manually.
- Test plugins with Claude Code before committing using `plugins/customaize-agent:test-prompt` and `plugins/customaize-agent:test-skill` commands.
### When
software engineering books. Six independent skills under `skills/` (PR Review, Architecture Audit, Tech Debt, Test Quality, Health Dashboard, Full Sweep) each produce findings in the Iron Law form: **Symptom → Source
machine learning models.
## Baseline Commit Rules
1. Always ensure all affected (or new) tests pass - backend tests suite should only be run in its entirety for good reason
Claude Code integration commands.
## Build Commands
```bash
make build # build binary to .bin/ralphex
make test # run tests with coverage
make lint # run golangci-lint
make fmt # format code
```
### Updating Dependencies
TypeScript compile (tsc) → dist/
pnpm run dev # Run with tsx (no build step)
pnpm test # Run unit tests (vitest)
pnpm run test:watch # Watch mode
pnpm run link # Build + pnpm
exposes all capabilities as an MCP server. 30,000+ lines of TypeScript, 1,819 tests, v0.20.2. Apache 2.0, repo at ghostwright/phantom.
## Tech Stack
| Layer | Technology |
|-------|-----------|
| Runtime | Bun (TypeScript-native, built
budgets for blocking remediation loops whose capped exit is
explicitly blocked, unshipped, or pending. Test advisory liveness across later
fully-due windows, and leave current thresholds in the owning implementation
CLAUDE.md
See CONTRIBUTING.md for development workflow, setup, testing, and commit conventions.
## Verification
After changes, run relevant tests before committing:
- `yarn test` (TypeScript unit tests)
- `yarn test:unit:ios` / `yarn test
source project enabling instant UI code changes without restarting a Compose Multiplatform application.
## Build & Test
```bash
# Build
./gradlew build
# Run all tests
./gradlew check
# Run a sample
./gradlew :samples:counter
repository.
Tracely is trace-native CI/CD for AI agents: **production trace → failure detection → regression test → CI/CD gate**. The trace is the source of truth; evals, clusters, cases, gates and trends
roadmap.
**Keep this current in real time** (see rule below).
- **[docs/testing.md](docs/testing.md)** — test conventions and the per-file test map.
- **[docs/experiments.md](docs/experiments.md)** — experiment protocol: what counts as a result,
what
ESLint on `src/`. `no-explicit-any` is error; unused vars must be prefixed `_`. |
| `npm test` | Fast unit gate: type-contracts tsc, the test type-check (`tsconfig.tests.json`), then an adaptive number
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.