Personas and Use Cases

Example workflows for different experience levels.

Example: Senior Engineer — Cross-Repo Feature

A senior engineer needs to build a feature that touches multiple services. They want spec review before code lands.

1. Create a Spec and Build task

   Open the Spec and Build card, describe the feature, attach a product brief. Zenflow seeds plan.md, requirements.md, and spec.md.

2. Configure agent and integrations

   In Advanced, select a Codex preset with GitHub + MCP integrations so the agent can run tests, push branches, and open PRs.

3. Let it run

   Enable Auto-start steps. The agent moves through Spec → Implementation Plan → Implementation, pausing only at review checkpoints.

4. Review and merge

   Check the Changes tab for diffs, verify the agent’s commits, and merge from the Task Overview. Zenflow pushes the branch and opens the PR.

Example: Junior Developer — Bug Fix

A junior developer needs to fix a regression but isn’t sure where to start. The Fix Bug workflow provides structure.

1. Create a Fix Bug task

   Describe the failing behavior, attach screenshots or error logs. Zenflow creates investigation.md, solution.md, and implementation.md.

2. Follow the investigation

   In the right-column chat, keep Plan mode enabled. The agent surfaces logs, stack traces, and hypotheses. Ask clarifying questions as needed.

3. Review the proposed fix

   When the agent proposes a solution, review diffs in the Changes tab. Run tests to confirm the fix works.

4. Document what happened

   Add a summary to implementation.md with root cause, fix details, and any remaining risks. This stays in the worktree for future reference.