app/, cron/ and shared/ each have an AGENTS.md with their own rules; read it before working there.
| Path | What | Go here when |
|---|---|---|
app/ |
React Native / Expo app, Android-first | screens, navigation, push handling |
cron/ |
Vercel cron jobs: fetch (Perplexity) → rank (Claude) → persist → notify | the daily digest pipeline |
shared/ |
types, config schema, region constants used by both app/ and cron/ |
a type or config both sides read |
supabase/ |
schema reference only (no code) | tables, RLS, RPCs |
docs/ |
UX notes | a UX decision |
| Package | Typecheck | Lint | Test |
|---|---|---|---|
| cron | cd cron && npx tsc --noEmit |
cd cron && npx eslint --ext .ts src |
cd cron && npm test |
| app | cd app && npx tsc --noEmit |
cd app && npx eslint --ext .ts,.tsx src |
deferred to app/foundation |
Prettier (run from root): npm run format:check / npm run format
main ← protected; merges from develop only; tagged releases
develop ← protected; all feature slices merge here; CI must be green
feat/* ← one feature per branch
fix/* ← one bug per branch
Never commit directly to main or develop. Always open a PR.
All PRs target develop. Never target main directly — main only receives merges from develop. The GitHub repo default branch is set to develop so the PR form pre-selects it, but always confirm before creating.
Rebuild done (~99% parity). Normal feature/fix flow on develop.
- Focused, reviewable PR to
develop. - Before opening a PR:
/code-review. On auth/notifications/API/deep-link changes:/security-review. - Tests in the same PR. Target 60–70% line coverage on logic that breaks silently.
Retained at D:\JanosGorondi\AI\pulse-news-legacy for occasional reference only.
After any PR is merged, immediately run:
git checkout develop
git pull origin develop
git branch -d feat/<branch-name>
git push origin --delete feat/<branch-name>Also clean up any other stale merged feat/* branches at the same time. Do this without being asked.
Use ctx_execute / ctx_execute_file / ctx_batch_execute instead of Bash for any command that reads, queries, lists, diffs, tests, builds, or inspects output. Bash only for: file mutations, git writes, cd/pwd, process control, package install.
No subagents for read-only tasks — Use ctx_batch_execute + ctx_search for exploration instead.
GitHub Actions runs on every PR to develop or main:
- format:check (root)
- lint (root, covering all packages)
- typecheck per package
- jest (cron)