Workflow guides

Run, isolate, coordinate, verify, and deliver agent work safely in Tejus.

Tejus workflows are built around one rule: every body of work needs a clear owner and a verifiable result. The tools—threads, worktrees, forks, handoffs, the in-app browser, automations, and agent-to-agent coordination—are useful only when they preserve that boundary.

Start with the smallest workflow

NeedStart here
One focused changeOne thread in a known checkout
Independent work in the same repositorySeparate worktree-backed threads
Another path from the same conversationThread fork
Another provider continuing the same objectiveProvider handoff
A defect whose cause is still unknownDebug mode
Visual or web behavior verificationBrowser verification
Review and delivery through GitHubPull requests
Recurring workAutomations
One Tejus agent coordinating other Tejus threadsAgent Gateway
Another local application creating restricted threadsExternal MCP

Do not begin with maximum parallelism. First learn the complete loop: objective, execution, supervision, verification, review, and delivery.

Core workflow

Begin from a known state

Confirm the project, branch, existing changes, provider, model, and whether the thread works in the local checkout or a worktree before sending work.

Give one owner a bounded objective

State the outcome, scope, constraints, and verification. Split work when those cannot be expressed clearly.

Supervise the work

Watch plans, tool activity, approvals, questions, background tasks, and the growing diff. Correct wrong assumptions early.

Verify independently

Inspect every changed file and run the relevant checks. Use the in-app browser when visible behavior matters, and read any Security review findings reported after the turn.

Preserve and deliver intentionally

Commit only reviewed changes. Push, open a pull request, or archive the thread only after its ownership and state are understood.

Guides

Last updated on