# Riffpad Agent Guide

## 项目

Riffpad 是 AI coding agent 的移动遥控器：本地 daemon 桥接电脑上的 CLI 会话，加密中继推送事件，手机端负责监督、审批与转向。

## 规则

1. **先读 `docs/prd.md` 与 `docs/tsd.md`**——产品定位与技术方案以它们为准；`docs/design.md` 是快速总览。
2. **最小改动**——只做被要求的事。
3. **安全优先**——中继零信任、端到端加密、移动端默认只读；任何涉及凭据/密钥的改动都要特别谨慎。
4. **测试与验证**——改动后运行相关测试并构建。
5. **协议同步**——事件协议变更必须同步更新 `packages/protocol` 与 `docs/design.md`。
6. **使用 `gh` CLI**——issue、分支、PR 用 GitHub 工作流管理。
7. **同步 dev plan**——`docs/dev-plan.md` 是开发进度追踪表：新任务、完成勾选、阻塞说明都更新到这里（遵守文件内“更新规则”）。
8. **记录人工测试**——`test-notes/`（已 gitignore）存放人工测试记录，命名 `test-note-YYYY-MM-DD.txt`；测试发现的问题记录在此，并在修复时关联 issue 编号。

## 代码规范

- 分支：`feature/<n>-<slug>` / `bugfix/<n>-<slug>`
- Commit：`feat(daemon): ... (#n)` / `fix(relay): ... (#n)`
- PR 标题 + 验证步骤，body 写 `Closes #n`

## Done Means

- 代码可构建、可测试
- 协议与文档一致
- PR 已评审合并