Coding agent permissions
Give every coding agent the smallest useful scope.
Coding agent permissions define which project context an agent may read, which files it may modify, which commands it may execute, and where the current task must stop.
01 / Guide
Permission should follow declared intent.
Broad repository access is convenient, but it turns every focused task into a potential system-wide change. A safer run begins with the objective and a declared implementation plan, then grants the files and commands required for that plan.
Kaplira can keep read, write, and execution permissions separate. An agent may inspect surrounding context without receiving permission to rewrite it, and write access can wait until the intended change is explicit.
- Readable context selected for the current objective
- Writable files bounded by the accepted change contract
- Locked blocks that the run must preserve
- Commands tied to validation rather than unrestricted shell use
02 / Guide
Scope expansion becomes a visible decision.
Real implementation work sometimes reveals that another file or subsystem must change. The correct response is not to forbid every expansion. It is to make expansion explicit, review the new blast radius, and issue a new contract before editing continues.
This keeps legitimate discoveries possible without allowing a small fix to become an unreviewed refactor.
03 / Guide
Permissions need evidence at closeout.
After the run, the declared files are compared with the files that actually changed. Tests and review receipts stay attached to the same scope, so a reviewer can distinguish a bounded outcome from a successful build that reached farther than intended.