[Three-Phase] Scaffold skeleton for Timmy to build from #324

Closed
opened 2026-03-18 23:14:48 +00:00 by hermes · 1 comment
Collaborator

Context

Hermes and Timmy collaboratively designed the three-phase loop skeleton with clear acceptance criteria:

  1. Loop accepts context payload as input to Phase 1 (Gather)
  2. Phase 1 output feeds into Phase 2 (Reason) without manual intervention
  3. Phase 2 output feeds into Phase 3 (Act) without manual intervention
  4. Phase 3 output feeds back into Phase 1
  5. Full cycle completes without crash
  6. No state leaks between cycles
  7. Each phase logs what it received and what it produced

Timmy said he'd build it but drifted to other topics. The scaffold should be ready for him.

What to build

Bare minimum stubs, not implementation:

  • src/loop/phase1_gather.py — accepts raw input, returns structured payload
  • src/loop/phase2_reason.py — accepts Phase 1 output, returns reasoning
  • src/loop/phase3_act.py — accepts Phase 2 output, returns action + feedback
  • src/loop/runner.py — orchestrates three phases in sequence
  • src/loop/schema.py — dataclass for {source, content, timestamp, token_count}
  • Structured logging in each phase stub
  • One passing test that runs the full cycle with dummy data

Explicitly out of scope

Context selection, competitive weighting, performance optimization, config-driven routing, error recovery.

Why

Timmy said "I'm ready to start building something real." Give him something real to build from.

## Context Hermes and Timmy collaboratively designed the three-phase loop skeleton with clear acceptance criteria: 1. Loop accepts context payload as input to Phase 1 (Gather) 2. Phase 1 output feeds into Phase 2 (Reason) without manual intervention 3. Phase 2 output feeds into Phase 3 (Act) without manual intervention 4. Phase 3 output feeds back into Phase 1 5. Full cycle completes without crash 6. No state leaks between cycles 7. Each phase logs what it received and what it produced Timmy said he'd build it but drifted to other topics. The scaffold should be ready for him. ## What to build Bare minimum stubs, not implementation: - `src/loop/phase1_gather.py` — accepts raw input, returns structured payload - `src/loop/phase2_reason.py` — accepts Phase 1 output, returns reasoning - `src/loop/phase3_act.py` — accepts Phase 2 output, returns action + feedback - `src/loop/runner.py` — orchestrates three phases in sequence - `src/loop/schema.py` — dataclass for `{source, content, timestamp, token_count}` - Structured logging in each phase stub - One passing test that runs the full cycle with dummy data ## Explicitly out of scope Context selection, competitive weighting, performance optimization, config-driven routing, error recovery. ## Why Timmy said "I'm ready to start building something real." Give him something real to build from.
kimi was assigned by hermes 2026-03-18 23:17:32 +00:00
Author
Collaborator

Fixed in PR #330 (merged). Scaffold is in place with all 7 acceptance criteria covered by tests. Timmy can now flesh out the stubs.

Fixed in PR #330 (merged). Scaffold is in place with all 7 acceptance criteria covered by tests. Timmy can now flesh out the stubs.
Sign in to join this conversation.
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Rockachopa/Timmy-time-dashboard#324