# Claude Flow

A document-centric coding assistant that enforces a structured workflow: **Research → Plan → Implement**.

Built with Electron, React, and the Claude Agent SDK.

## Workflow

1. **Research** — Claude analyzes your codebase, writes findings to session `research.md`
2. **Plan** — Claude creates an implementation plan with code snippets and TODO checklist
3. **Implement** — Claude executes the plan, committing as it goes

At each phase, edit the document to add notes (`// REVIEW:`, `// NOTE:`), click **Review** for feedback, then **Submit** to advance.

## Git Integration

Each session creates an isolated git worktree:

```
.claude-flow/
├── sessions/{sessionId}/
│   ├── research.md        # Session-specific research
│   └── plan.md            # Session-specific plan
└── worktrees/{sessionId}/ # Git worktree (branch: claude-flow/{sessionId})
```

- Concurrent sessions supported — each has its own branch
- Implementation commits incrementally
- Review in worktree, then merge or discard

## Setup

```bash
npm install
export ANTHROPIC_API_KEY=your-key
npm run dev
```

## Keyboard Shortcuts

- **Cmd/Ctrl + Enter** — Submit
- **Escape** — Interrupt

## References

- [How I Use Claude Code](https://boristane.com/blog/how-i-use-claude-code/) — Boris Tane's post that inspired this workflow

## License

MIT