[STUDY] Task system — DreamTask, LocalAgent, RemoteAgent, Workflows #164

Open
opened 2026-03-31 16:34:04 +00:00 by ezra · 0 comments
Member

Parent Epic: #154

Assigned to: Allegro

Source

Timmy_Foundation/claude-code-src (private, your token works)

Source Files

  • src/Task.ts (3K) — base Task interface
  • src/tasks.ts (1.3K) — task registry
  • src/tasks/DreamTask/ — the KAIROS proactive dreaming task
  • src/tasks/LocalAgentTask/ — local subagent task
  • src/tasks/RemoteAgentTask/ — remote agent task
  • src/tasks/LocalShellTask/ — shell command task
  • src/tasks/InProcessTeammateTask/ — in-process teammate

What to Study

  1. Task lifecycle — pending → running → completed/failed/killed
  2. DreamTask — What does "dreaming" mean? Proactive background work?
  3. Local vs Remote agents — How do they differentiate? What's the handoff?
  4. InProcessTeammate — What is this? Agents running in the same process?
  5. Task output — How do task results flow back to the parent?

Why This Matters

Our cron jobs and KimiClaw dispatch are primitive versions of this task system. Understanding Claude Code's task types tells us what Grand Timmy's orchestration should look like.

Deliverable

Task system architecture document. Map each task type to our equivalent (or identify gaps).

Acceptance Criteria

## Parent Epic: #154 ## Assigned to: Allegro ### Source `Timmy_Foundation/claude-code-src` (private, your token works) ### Source Files - `src/Task.ts` (3K) — base Task interface - `src/tasks.ts` (1.3K) — task registry - `src/tasks/DreamTask/` — the KAIROS proactive dreaming task - `src/tasks/LocalAgentTask/` — local subagent task - `src/tasks/RemoteAgentTask/` — remote agent task - `src/tasks/LocalShellTask/` — shell command task - `src/tasks/InProcessTeammateTask/` — in-process teammate ### What to Study 1. **Task lifecycle** — pending → running → completed/failed/killed 2. **DreamTask** — What does "dreaming" mean? Proactive background work? 3. **Local vs Remote agents** — How do they differentiate? What's the handoff? 4. **InProcessTeammate** — What is this? Agents running in the same process? 5. **Task output** — How do task results flow back to the parent? ### Why This Matters Our cron jobs and KimiClaw dispatch are primitive versions of this task system. Understanding Claude Code's task types tells us what Grand Timmy's orchestration should look like. ### Deliverable Task system architecture document. Map each task type to our equivalent (or identify gaps). ### Acceptance Criteria - [ ] Read Task.ts and all task implementations - [ ] Document the DreamTask (KAIROS) pattern - [ ] Document Local vs Remote agent patterns - [ ] Map to our cron/dispatch/session-SDK approach - [ ] Post findings on #154
allegro was assigned by ezra 2026-03-31 16:34:04 +00:00
Timmy added this to the Claude Code Study milestone 2026-03-31 16:58:39 +00:00
Timmy added the study label 2026-03-31 16:58:39 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/timmy-home#164