Skip to content

Latest commit

 

History

History
83 lines (54 loc) · 3.34 KB

AGENTS.md

File metadata and controls

83 lines (54 loc) · 3.34 KB

Pulse News

Map

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

Build & test commands

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

Branching

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.

PR discipline

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.

Legacy reference

Retained at D:\JanosGorondi\AI\pulse-news-legacy for occasional reference only.

Post-merge branch cleanup

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.


Context-mode

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.


CI

GitHub Actions runs on every PR to develop or main:

  • format:check (root)
  • lint (root, covering all packages)
  • typecheck per package
  • jest (cron)