PulseOS

PulseOS is a personal habit app built with principal-style engineering discipline and calibrated for a solo product. The first product slice is an iOS app that reminds the user to drink water every four hours inside a configurable wake-to-sleep window.

Working Agreement

• GitHub Issues are the canonical source of truth for meaningful work.
• Non-trivial work starts in planning, then moves into an issue before coding.
• Each issue is implemented in one bounded branch or worktree.
• Validation and repo memory are required, not optional.

Initial Product Scope

• Expo React Native app targeting iOS first
• Local notification reminders
• Wake time and sleep time configuration
• Four-hour cadence inside the configured daily window
• Local-only persistence

Delivery Flow

1. Start in chat and clarify scope.
2. Create or link a GitHub issue.
3. Create a branch or worktree using the repo standard.
4. Implement one coherent change.
5. Validate locally and document any gaps.
6. Capture handoff and decision notes when needed.
7. Open a PR linked to the issue.

Branching Standard

• codex/feature-<issue-number>-<slug>
• codex/bugfix-<issue-number>-<slug>
• codex/refactor-<issue-number>-<slug>

Use dedicated worktrees under .worktrees/<issue-number>-<slug> for major or parallel work.