Personal TODO Agent Interface

Operating contract for agents that submit durable updates to the private personal TODO dashboard. The write interface is predefined repository skills plus JSON data contracts, not a public API.

Full Markdown contract

Boundary

Use repository-backed JSON as the write interface. Do not build or call a public write API, write directly to Cloudflare D1/KV, use browser local storage, or treat the private dashboard login as agent authentication. App-internal APIs such as /api/session and /api/student-statuses are for the dashboard UI and testing, not agent submission.

Target

Repository neardws/personal-todo-dashboard
Remote https://github.com/neardws/personal-todo-dashboard.git
Branch main
Local path /Users/neardws/Documents/TODO
Private dashboard https://todo.neardws.com

Operating Loop

  1. Choose one predefined skill.
  2. Read the relevant existing JSON before editing.
  3. Make the smallest repository file change that represents the source evidence.
  4. Keep unrelated local changes out of the commit.
  5. Run npm run validate:data and npm run build.
  6. Run npm run lint when time allows.
  7. Commit and push only when publishing is part of the task.

Predefined Skills

Skill Write target
project-progress-update src/data/project-progress/*.json
project-master-update src/data/projects.json
paper-status-sync src/data/paper-submissions.json
student-progress-note src/data/students.json
personal-research-update src/data/personal-research.json
code-project-inventory src/data/code-projects.json
misc-task-update src/data/misc.json
agent-contract-update docs/agent-submission.md, public-agent/agent-submission.md, optionally this page

The full Markdown contract contains required fields, optional fields, grouping rules, security rules, and stop conditions.

Checks

npm run validate:data
npm run build
npm run lint

Stop and report instead of guessing when source dates, statuses, titles, or IDs are ambiguous, when validation fails, or when the requested update would store secrets or signed portal URLs.