Pair Programmer
wf chat works as your AI pair programmer through the full development lifecycle: requirements gathering, architecture, implementation, QA, and merge, while keeping full workstream context across every handoff.
Terminal
You: In @story, implement the caching guard from @diff and explain any behavior changes before merge.
AI: I reviewed @story requirements and applied the cache invalidation guard from @diff in src/cache/session.ts.
AI: Behavior change: stale sessions now short-circuit to refresh instead of returning partially cached state.
AI: Added regression coverage for refresh-on-stale and no-op on warm cache; tests pass locally.
AI: Ready for your review, then I can prepare the merge summary and handoff notes.Pair Chat
What it is
wf chat is a single pair programming surface that carries full workstream context: the story, diffs, review feedback, and implementation history.
Instead of stitching context from separate tools, the chat assists end-to-end through requirements gathering, architecture decisions, development, QA, and merge readiness in one thread.
Context Injection
@ Artifacts
Use artifact shortcuts to inject scoped project context directly into chat prompts. Each artifact maps to a concrete source of truth in the active workstream.
| Artifact | Injected Context |
|---|---|
@diff |
Current git diff. |
@log |
Latest stage log. |
@review |
Review feedback. |
@story |
Story details and criteria. |
@timeline |
Story/workstream timeline. |
@file:path |
Specific file content. |
@clq |
Clarification history. |
@reqs |
REQS.md content. |
@spec |
SPEC.md content. |
@commits |
Commit history. |
@stories |
List of project stories. |
@workstreams |
List of active workstreams. |
@STORY-xxxx |
Cross-reference another story. |
@BUG-xxxx |
Cross-reference a bug. |
Session Continuity
Persistent History
Pair chat conversations persist within each workstream across sessions. Reopen a workstream later and the full thread context is still available, so decisions, tradeoffs, and prior implementation notes carry forward instead of being re-entered from scratch.
Workflow Shortcut
TUI Integration
From any TUI screen, press C to open pair chat for the active workstream. You can jump into contextual collaboration immediately without leaving your
current workflow stage.