---
inclusion: auto
---

# CV Project Standards

## Quality Gates (before every commit)

1. `gitleaks detect --source . --no-git` — no secrets in code
2. `npm run typecheck` — TypeScript passes
3. `npm test` — all vitest tests pass (252 tests, 80%+ coverage)
4. `npm audit` — 0 vulnerabilities

## Conventional Commits

```
feat(cv): add tandem CV template
fix(graph): handle circular references in index
test(interview): add property test for gap detection
docs(readme): update entity schema section
```

## Testing

- Vitest + fast-check for property-based testing
- 15 formal correctness properties defined in SPEC.md
- Given-When-Then structure
- 80% coverage minimum

## Autonomous Mode

- Never push directly to main — use feature branches
- Create PRs on GitHub targeting main
- If stuck after 3 attempts: stop and document
- Report: `PROGRESS: X%` / `HELP: description`

## Architecture

- File-based knowledge graph (YAML entities, one file per entity)
- TypeScript for validation and logic
- Kiro skills for workflows (interview, cv-generate, talk-intro, kb-review)
- No build step, no server — file system is the database

## File Naming

- Entity files: kebab-case (`andre-knie.yaml`, `db-cargo-innovation-lead.yaml`)
- All filenames OneDrive-safe (no brackets, no special chars)