ntp-android/AGENTS.md

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