iteration 0

AGENTS.md

@@ -0,0 +1,52 @@
+# Evaluclaude Harness - Agent Instructions
+
+## Project Overview
+
+This is a CLI tool for generating evaluation tests for codebases using Claude. The core philosophy is "Zero-to-evals in one command."
+
+## Commands
+
+```bash
+# Build the project
+npm run build
+
+# Run typecheck
+npm run typecheck
+
+# Run tests
+npm test
+
+# Run the CLI
+npm start -- intro <path>
+```
+
+## Project Structure
+
+```
+src/
+├── cli/              # Commander.js CLI
+├── introspector/     # Tree-sitter codebase parsing (NO LLM)
+│   ├── parsers/      # Language-specific parsers
+│   ├── scanner.ts    # File discovery
+│   ├── git.ts        # Git integration
+│   └── summarizer.ts # Main analysis logic
+└── index.ts          # Main exports
+```
+
+## Key Principles
+
+1. **Tree-sitter for introspection**: Never send raw code to Claude for structure extraction
+2. **Claude generates specs, not code**: EvalSpec JSON is generated by Claude, test code is rendered deterministically
+3. **Git-aware incremental**: Only re-analyze changed files
+
+## Dependencies
+
+- `tree-sitter`: Native AST parsing
+- `tree-sitter-python`: Python grammar
+- `tree-sitter-typescript`: TypeScript grammar
+- `commander`: CLI framework
+- `glob`: File pattern matching
+
+## Testing
+
+Use vitest for testing. Test files go in `tests/` directory.