# AGENTS.md

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

## Setup

```
uv sync
```

## Commands

```
pytest         # run the test suite
ruff check .   # lint
```

## Layout

- `tests/`    297 source files
- `graphify/` 84 source files
- `worked/`   14 source files
- `tools/`    4 source files
- `scripts/`  1 source file

## Conventions

- Tests live alongside the code they cover, following `docs/superpowers/specs/2026-05-04-incremental-updates-dedup-design.md`.
- CI defines what passing means. See `.github/workflows/ci.yml`, and keep it green.
- TODO: add the two or three conventions a newcomer always gets wrong here.

## Gotchas

- `graphify/extract.py` is 326KB. It will not fit comfortably in context, so read it in parts.

---

Drafted by agentreadme.com from what is in this repository. Everything marked TODO
needs a human. Check it in as AGENTS.md at the root.