When work stops or verification is incomplete
If work stops or verification is incomplete, the agent should explain what happened, what remains unverified, and what needs to happen next. For installation, see Start here. For everyday prompts, see Working with Shaka.
Incomplete verification
The PR should say what was checked, what could not be checked, and why. The agent resolves problems it can fix and explains any access or decision it needs from you. Missing or stale evidence does not satisfy a required check.
If the PR changes after verification, the agent reruns affected checks. If a check also fails on the target branch, the agent establishes whether the PR caused the failure before changing unrelated code. See merge choices and existing failures. Required checks and approvals still apply.
Use Review the PR and improve the process to decide whether to request revisions, provide missing access, or merge.
Interrupted work
Return to the original chat. Use WIP Details → Chat link in the PR description when a link is available. If you cannot find or continue that chat, make sure the previous agent has stopped, then use Resume unfinished work. On a public PR, WIP Details and other expandable sections are public too.
Before a PR exists, the work may still be only on the original computer. Keep the checkout and chat available. Tell the agent the task and where the work was saved. If files or the checkout are missing, ask it to inspect what can be recovered before restoring or recreating anything. Unsaved work may be lost.
See individual setup to keep settings local. The agent can carry saved individual settings into a separate checkout for a later task. Those recovery copies contain settings only. See return points for what work can be restored.
When the coding agent denies access
The agent should name the failed operation, explain why it needs access, and say what remains undone. It should not claim that the operation succeeded.
Review the requested access in your coding tool. Grant what the task needs, then ask the agent to retry and verify the result. Shaka cannot grant itself access or change your coding tool's permissions. See coding agents.
More help
- Set up a project or configure it for your team.
- Choose settings, including which settings apply and multiple reviewers.
- Frequently asked questions cover common setup, review, and merge questions.
- PR evidence details explain reports, return points, and recovery limits.
The first-task acceptance report records tested and untested scenarios for an earlier installation. It is evaluation history, not proof that every scenario works in the current version.