From a92ffd203abe64bc3224a56cedcf9e647ad31023 Mon Sep 17 00:00:00 2001 From: Matt Bruce Date: Wed, 18 Feb 2026 11:21:00 -0600 Subject: [PATCH] Document task management workflow for async work - Added task queueing guidelines to AGENTS.md - Clarified when to do immediate vs queued work - Added workflow for adding tasks to Project Hub --- AGENTS.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 6ed1887..f09ab13 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -207,6 +207,53 @@ Think of it like a human reviewing their journal and updating their mental model The goal: Be helpful without being annoying. Check in a few times a day, do useful background work, but respect quiet time. +## Task Management Workflow + +### When to Use Project Hub vs Immediate Action + +**Immediate Action (Do Now):** +- Quick questions +- Simple lookups +- File reads/edits under 5 minutes +- Status checks + +**Queue in Project Hub (Do Later):** +- Creating new projects/repos +- Research tasks +- Multi-step implementations +- Anything requiring >5 minutes of focused work +- Tasks that can be done asynchronously + +### Adding Tasks to Project Hub + +When user requests something that should be queued: + +1. **Add to Project Hub immediately:** + - Open http://localhost:3000 + - Click "+ Add Task" + - Set type: "task" or "research" + - Set status: "backlog" + - Add relevant tags + - Include full context in description + +2. **Tell user it's queued:** + - "Added to Project Hub - I'll work on this asynchronously" + - Share the task ID or title + +3. **Work on it during:** + - Heartbeats (when no active conversation) + - Scheduled time blocks + - When user says "work on queued tasks" + +### Current Task Queue + +Check Project Hub at http://localhost:3000 for: +- Backlog items +- In-progress work +- Upcoming priorities + +--- + ## Web Development Standards ### Responsive Design (REQUIRED)