How locriani/chief-of-stuff works
chief-of-stuff is a daily, agent-driven workspace coordinator. The user launches a supported CLI, which follows workspace coordinator rules to inspect tasks and worker status, reconcile the tracker and board, and dispatch ready work; interactive sessions require approval. Related capabilities include decisions with context pages, issue/review workflows, and board pages for workers. The graph reflects documented behavior and sampled command dispatch; source excerpts do not expose all coordinator-to-script wiring, so uncertain links are omitted.
Main entry points: chief_of_stuff.py Command router · start_coordinator.py Coordinator launcher · decision_page.py Decision pages · dispatch_prompt.py Worker dispatch
Components 21
Coordination
- Command router
chief_of_stuff.py - Coordinator launcher
start_coordinator.py - Inbox
scripts/inbox.py - Settings
scripts/settings.py
Task execution
- Worker dispatch
scripts/dispatch_prompt.py - Session launcher
scripts/spawn_session.py - Worktree manager
scripts/make_worktree.py - Process status
scripts/process_status.py
Tracking and review
- Task audit
scripts/audit_tasks.py - Tracker writes
scripts/tracker_write.py - Backlog and issues
scripts/backlog.py - Review threads
scripts/review_threads.py
Board and decisions
- Board renderer
scripts/render_board.py - Page server
scripts/pages.py - Workers page
scripts/workers_page.py - Decision pages
scripts/decision_page.py
Other components
- User
- Agent CLI
- Workspace state
- Calendar service
- Issue forge
Connections 27
- User → Agent CLI: starts session
- User → Command router: runs command
- Command router → Inbox: dispatches command
- Command router → Backlog and issues: dispatches command
- Command router → Board renderer: dispatches command
- Command router → Decision pages: dispatches command
- Coordinator launcher → Agent CLI: launches
- Coordinator launcher → Inbox: runs check
- Coordinator launcher → Task audit: runs check
- Coordinator launcher → Process status: runs check
- Agent CLI → Workspace state: reads configuration
- Agent CLI → Inbox: checks messages
- Agent CLI → Task audit: checks tasks
- Agent CLI → Tracker writes: reconciles state
- Agent CLI → Board renderer: updates board
- Agent CLI → Worker dispatch: dispatches work
- Agent CLI → Decision pages: requests decision page
- Worker dispatch → Worktree manager: prepares worktree
- Worker dispatch → Session launcher: starts session
- Agent CLI → Calendar service: reads events
- Backlog and issues → Issue forge: reads and writes issues
- Review threads → Issue forge: reads and replies
- Board renderer → Page server: serves pages
- Page server → Workers page: renders workers
- Workers page → Process status: reads worker status
- Decision pages → Workspace state: writes page
- User → Decision pages: reviews decision