# AGENTS.md

This repository is built phase-by-phase with hard gates for a private Android NTP comparison utility.

## Hard rules

- Never skip a phase gate.
- Never mark a phase complete without recorded evidence in `project-docs/status/`.
- Keep the app local-first: no backend, no telemetry, no analytics, no cloud sync unless explicitly approved.
- Android permissions must stay minimal. Network access for NTP probes is expected; do not add location, contacts, storage, or account permissions without approval.
- NTP probing must use UDP packets directly for v1; no external time-service backend.
- Store saved servers, profiles, and short history locally in Room.
- Do not commit signing keys, keystores, tokens, private server lists, customer names, or exported reports.

## Required artifacts per phase

- `project-docs/status/phase-N-summary.md`
- `project-docs/status/phase-N-test-results.md`
- `project-docs/status/phase-N-open-issues.md`

## Required validation before advancing

Run the checks required by the phase, including as applicable:

- structure validation
- Android debug build
- unit tests
- lint/static checks
- manual emulator/device smoke tests
- privacy/permission review
- export-data review