Skip to content

AGENTS.md

Latest commit

 

History

History
40 lines (26 loc) · 892 Bytes

AGENTS.md

File metadata and controls

40 lines (26 loc) · 892 Bytes

PulseOS Agent Rules

Issue-First Rule

For any meaningful new task:

  1. Check whether the repo has a GitHub remote and authenticated gh access.
  2. Create or link the GitHub issue before implementation.
  3. Use repo-local notes only as supporting artifacts, not as a substitute for the issue.

Workflow Priority

Preferred flow for PulseOS:

  • clarify
  • GitHub issue
  • branch or worktree
  • implementation
  • validation
  • handoff
  • PR

Isolation Rule

One branch or worktree should do one coherent thing. If scope grows, split follow-up issues instead of expanding the branch indefinitely.

Validation Rule

Before completing meaningful work, record:

  • validation performed
  • validation skipped
  • any manual iOS verification still required

Repo Memory Rule

Meaningful work should update:

  • docs/handoffs/
  • docs/decisions/ when durable behavior or architecture changes