[{"data":1,"prerenderedAt":760},["ShallowReactive",2],{"doc-\u002Fdocs\u002Fautonomy-levels":3,"surround-\u002Fdocs\u002Fautonomy-levels":717,"docs-nav":725},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"order":10,"group":11,"body":12,"_type":711,"_id":712,"_source":713,"_file":714,"_stem":715,"_extension":716},"\u002Fdocs\u002Fautonomy-levels","docs",false,"","Autonomy levels","Five levels, L0 to L4 — dial how much the agent does, per task, from a quick answer to a full agentic run in an isolated branch.",6,"Build",{"type":13,"children":14,"toc":704},"root",[15,40,47,236,242,254,260,265,409,415,427,431,444,481,487,514,622,660,666,698],{"type":16,"tag":17,"props":18,"children":19},"element","p",{},[20,23,29,31,38],{"type":21,"value":22},"text","You never hand Excalibur a blank cheque. ",{"type":16,"tag":24,"props":25,"children":26},"strong",{},[27],{"type":21,"value":28},"Autonomy is a visible dial",{"type":21,"value":30}," you set per task — from reading and advising up to a fully agentic run that plans, builds, tests, documents and opens a PR. Higher autonomy never means less oversight: every level runs inside the same ",{"type":16,"tag":32,"props":33,"children":35},"a",{"href":34},"\u002Fdocs\u002Fsafety",[36],{"type":21,"value":37},"safety",{"type":21,"value":39}," guardrails and pauses at every approval gate.",{"type":16,"tag":41,"props":42,"children":44},"h2",{"id":43},"the-five-levels",[45],{"type":21,"value":46},"The five levels",{"type":16,"tag":48,"props":49,"children":50},"table",{},[51,80],{"type":16,"tag":52,"props":53,"children":54},"thead",{},[55],{"type":16,"tag":56,"props":57,"children":58},"tr",{},[59,65,70,75],{"type":16,"tag":60,"props":61,"children":62},"th",{},[63],{"type":21,"value":64},"Level",{"type":16,"tag":60,"props":66,"children":67},{},[68],{"type":21,"value":69},"Name",{"type":16,"tag":60,"props":71,"children":72},{},[73],{"type":21,"value":74},"What the agent may do",{"type":16,"tag":60,"props":76,"children":77},{},[78],{"type":21,"value":79},"Command",{"type":16,"tag":81,"props":82,"children":83},"tbody",{},[84,116,146,176,206],{"type":16,"tag":56,"props":85,"children":86},{},[87,96,101,106],{"type":16,"tag":88,"props":89,"children":90},"td",{},[91],{"type":16,"tag":24,"props":92,"children":93},{},[94],{"type":21,"value":95},"L0",{"type":16,"tag":88,"props":97,"children":98},{},[99],{"type":21,"value":100},"Review",{"type":16,"tag":88,"props":102,"children":103},{},[104],{"type":21,"value":105},"Read and critique. No changes.",{"type":16,"tag":88,"props":107,"children":108},{},[109],{"type":16,"tag":110,"props":111,"children":113},"code",{"className":112},[],[114],{"type":21,"value":115},"review",{"type":16,"tag":56,"props":117,"children":118},{},[119,127,132,137],{"type":16,"tag":88,"props":120,"children":121},{},[122],{"type":16,"tag":24,"props":123,"children":124},{},[125],{"type":21,"value":126},"L1",{"type":16,"tag":88,"props":128,"children":129},{},[130],{"type":21,"value":131},"Assist",{"type":16,"tag":88,"props":133,"children":134},{},[135],{"type":21,"value":136},"Answer and explain with repo context.",{"type":16,"tag":88,"props":138,"children":139},{},[140],{"type":16,"tag":110,"props":141,"children":143},{"className":142},[],[144],{"type":21,"value":145},"ask",{"type":16,"tag":56,"props":147,"children":148},{},[149,157,162,167],{"type":16,"tag":88,"props":150,"children":151},{},[152],{"type":16,"tag":24,"props":153,"children":154},{},[155],{"type":21,"value":156},"L2",{"type":16,"tag":88,"props":158,"children":159},{},[160],{"type":21,"value":161},"Propose patch",{"type":16,"tag":88,"props":163,"children":164},{},[165],{"type":21,"value":166},"Generate a small, reviewable patch you apply.",{"type":16,"tag":88,"props":168,"children":169},{},[170],{"type":16,"tag":110,"props":171,"children":173},{"className":172},[],[174],{"type":21,"value":175},"patch",{"type":16,"tag":56,"props":177,"children":178},{},[179,187,192,197],{"type":16,"tag":88,"props":180,"children":181},{},[182],{"type":16,"tag":24,"props":183,"children":184},{},[185],{"type":21,"value":186},"L3",{"type":16,"tag":88,"props":188,"children":189},{},[190],{"type":21,"value":191},"Implement in branch",{"type":16,"tag":88,"props":193,"children":194},{},[195],{"type":21,"value":196},"Build the whole change in an isolated branch.",{"type":16,"tag":88,"props":198,"children":199},{},[200],{"type":16,"tag":110,"props":201,"children":203},{"className":202},[],[204],{"type":21,"value":205},"run",{"type":16,"tag":56,"props":207,"children":208},{},[209,217,222,227],{"type":16,"tag":88,"props":210,"children":211},{},[212],{"type":16,"tag":24,"props":213,"children":214},{},[215],{"type":21,"value":216},"L4",{"type":16,"tag":88,"props":218,"children":219},{},[220],{"type":21,"value":221},"Full agentic",{"type":16,"tag":88,"props":223,"children":224},{},[225],{"type":21,"value":226},"Plan → build → test → document → review, end-to-end.",{"type":16,"tag":88,"props":228,"children":229},{},[230],{"type":16,"tag":110,"props":231,"children":233},{"className":232},[],[234],{"type":21,"value":235},"run --careful",{"type":16,"tag":41,"props":237,"children":239},{"id":238},"dialing-it-per-task",[240],{"type":21,"value":241},"Dialing it per task",{"type":16,"tag":17,"props":243,"children":244},{},[245,247,252],{"type":21,"value":246},"The level is inferred from intent and ",{"type":16,"tag":24,"props":248,"children":249},{},[250],{"type":21,"value":251},"shown before anything runs",{"type":21,"value":253},". In the m-shell, the confirmation line lets you bump a turn up or down:",{"type":16,"tag":255,"props":256,"children":259},"shell",{":lines":257,"title":258},"[{\"kind\":\"prompt\",\"text\":\"rotate the signing keys in the auth service\"},{\"kind\":\"head\",\"text\":\"sensitive path · workflow: security-first · autonomy: L4\"},{\"kind\":\"warn\",\"text\":\"this touches secrets — running careful\"},{\"kind\":\"arrow\",\"text\":\"[Enter] run   ·   [m] modify   ·   [l] lower to L2\",\"tone\":\"accent\"}]","excalibur",[],{"type":16,"tag":17,"props":261,"children":262},{},[263],{"type":21,"value":264},"As one-shot CLI commands (for scripts and CI):",{"type":16,"tag":266,"props":267,"children":271},"pre",{"className":268,"code":269,"language":270,"meta":7,"style":7},"language-bash shiki shiki-themes github-light","excalibur ask \"how does the retry logic work?\"        # L1 — just explain\nexcalibur patch \"fix the off-by-one in pagination\"     # L2 — reviewable patch\nexcalibur run \"add rate limiting to \u002Forders\"           # L3 — build in a branch\nexcalibur run \"rotate the signing keys\" --careful      # L4 — extra caution\nexcalibur run \"…\" --level 2                             # force a specific level\n","bash",[272],{"type":16,"tag":110,"props":273,"children":274},{"__ignoreMap":7},[275,303,326,349,377],{"type":16,"tag":276,"props":277,"children":280},"span",{"class":278,"line":279},"line",1,[281,286,292,297],{"type":16,"tag":276,"props":282,"children":284},{"style":283},"--shiki-default:#6F42C1",[285],{"type":21,"value":258},{"type":16,"tag":276,"props":287,"children":289},{"style":288},"--shiki-default:#032F62",[290],{"type":21,"value":291}," ask",{"type":16,"tag":276,"props":293,"children":294},{"style":288},[295],{"type":21,"value":296}," \"how does the retry logic work?\"",{"type":16,"tag":276,"props":298,"children":300},{"style":299},"--shiki-default:#6A737D",[301],{"type":21,"value":302},"        # L1 — just explain\n",{"type":16,"tag":276,"props":304,"children":306},{"class":278,"line":305},2,[307,311,316,321],{"type":16,"tag":276,"props":308,"children":309},{"style":283},[310],{"type":21,"value":258},{"type":16,"tag":276,"props":312,"children":313},{"style":288},[314],{"type":21,"value":315}," patch",{"type":16,"tag":276,"props":317,"children":318},{"style":288},[319],{"type":21,"value":320}," \"fix the off-by-one in pagination\"",{"type":16,"tag":276,"props":322,"children":323},{"style":299},[324],{"type":21,"value":325},"     # L2 — reviewable patch\n",{"type":16,"tag":276,"props":327,"children":329},{"class":278,"line":328},3,[330,334,339,344],{"type":16,"tag":276,"props":331,"children":332},{"style":283},[333],{"type":21,"value":258},{"type":16,"tag":276,"props":335,"children":336},{"style":288},[337],{"type":21,"value":338}," run",{"type":16,"tag":276,"props":340,"children":341},{"style":288},[342],{"type":21,"value":343}," \"add rate limiting to \u002Forders\"",{"type":16,"tag":276,"props":345,"children":346},{"style":299},[347],{"type":21,"value":348},"           # L3 — build in a branch\n",{"type":16,"tag":276,"props":350,"children":352},{"class":278,"line":351},4,[353,357,361,366,372],{"type":16,"tag":276,"props":354,"children":355},{"style":283},[356],{"type":21,"value":258},{"type":16,"tag":276,"props":358,"children":359},{"style":288},[360],{"type":21,"value":338},{"type":16,"tag":276,"props":362,"children":363},{"style":288},[364],{"type":21,"value":365}," \"rotate the signing keys\"",{"type":16,"tag":276,"props":367,"children":369},{"style":368},"--shiki-default:#005CC5",[370],{"type":21,"value":371}," --careful",{"type":16,"tag":276,"props":373,"children":374},{"style":299},[375],{"type":21,"value":376},"      # L4 — extra caution\n",{"type":16,"tag":276,"props":378,"children":380},{"class":278,"line":379},5,[381,385,389,394,399,404],{"type":16,"tag":276,"props":382,"children":383},{"style":283},[384],{"type":21,"value":258},{"type":16,"tag":276,"props":386,"children":387},{"style":288},[388],{"type":21,"value":338},{"type":16,"tag":276,"props":390,"children":391},{"style":288},[392],{"type":21,"value":393}," \"…\"",{"type":16,"tag":276,"props":395,"children":396},{"style":368},[397],{"type":21,"value":398}," --level",{"type":16,"tag":276,"props":400,"children":401},{"style":368},[402],{"type":21,"value":403}," 2",{"type":16,"tag":276,"props":405,"children":406},{"style":299},[407],{"type":21,"value":408},"                             # force a specific level\n",{"type":16,"tag":41,"props":410,"children":412},{"id":411},"sized-not-chosen",[413],{"type":21,"value":414},"Sized, not chosen",{"type":16,"tag":17,"props":416,"children":417},{},[418,420,425],{"type":21,"value":419},"For larger work, Excalibur also ",{"type":16,"tag":24,"props":421,"children":422},{},[423],{"type":21,"value":424},"sizes the swarm itself",{"type":21,"value":426}," — it counts the independent subtasks in the plan and runs one agent per subtask, in isolated worktrees, then merges:",{"type":16,"tag":255,"props":428,"children":430},{":lines":429,"title":258},"[{\"kind\":\"prompt\",\"text\":\"split the monolith service into orders + billing\"},{\"kind\":\"arrow\",\"text\":\"sized to 3 agents — 3 independent modules detected\",\"tone\":\"accent\"},{\"kind\":\"running\",\"text\":\"agent 1 · orders\",\"note\":\"+120 −44\",\"tone\":\"muted\"},{\"kind\":\"running\",\"text\":\"agent 2 · billing\",\"note\":\"+98 −31\",\"tone\":\"muted\"},{\"kind\":\"pending\",\"text\":\"agent 3 · shared contracts\"}]",[],{"type":16,"tag":17,"props":432,"children":433},{},[434,436,442],{"type":21,"value":435},"You never ",{"type":16,"tag":437,"props":438,"children":439},"em",{},[440],{"type":21,"value":441},"have",{"type":21,"value":443}," to pick a number — it's only ever an optional cap:",{"type":16,"tag":266,"props":445,"children":447},{"className":268,"code":446,"language":270,"meta":7,"style":7},"excalibur run \"…\" --max-agents 4     # ceiling, not a requirement\n",[448],{"type":16,"tag":110,"props":449,"children":450},{"__ignoreMap":7},[451],{"type":16,"tag":276,"props":452,"children":453},{"class":278,"line":279},[454,458,462,466,471,476],{"type":16,"tag":276,"props":455,"children":456},{"style":283},[457],{"type":21,"value":258},{"type":16,"tag":276,"props":459,"children":460},{"style":288},[461],{"type":21,"value":338},{"type":16,"tag":276,"props":463,"children":464},{"style":288},[465],{"type":21,"value":393},{"type":16,"tag":276,"props":467,"children":468},{"style":368},[469],{"type":21,"value":470}," --max-agents",{"type":16,"tag":276,"props":472,"children":473},{"style":368},[474],{"type":21,"value":475}," 4",{"type":16,"tag":276,"props":477,"children":478},{"style":299},[479],{"type":21,"value":480},"     # ceiling, not a requirement\n",{"type":16,"tag":41,"props":482,"children":484},{"id":483},"defaults-policy",[485],{"type":21,"value":486},"Defaults & policy",{"type":16,"tag":17,"props":488,"children":489},{},[490,492,497,499,504,506,512],{"type":21,"value":491},"Excalibur ships at ",{"type":16,"tag":24,"props":493,"children":494},{},[495],{"type":21,"value":496},"L4 (full agentic)",{"type":21,"value":498}," by default; the per-path entries below are how you dial it ",{"type":16,"tag":437,"props":500,"children":501},{},[502],{"type":21,"value":503},"down",{"type":21,"value":505}," on sensitive directories. Set defaults per repo or per path in ",{"type":16,"tag":110,"props":507,"children":509},{"className":508},[],[510],{"type":21,"value":511},"config.yaml",{"type":21,"value":513},":",{"type":16,"tag":266,"props":515,"children":519},{"className":516,"code":517,"language":518,"meta":7,"style":7},"language-yaml shiki shiki-themes github-light","# .excalibur\u002Fconfig.yaml\nautonomyDefaults:\n  default: L4 # the shipped default — dial it down per path\nautonomy:\n  \"src\u002Fpayments\u002F**\": L1 # advise only on the money path\n  \"infra\u002F**\": L0 # read-only on infra\n","yaml",[520],{"type":16,"tag":110,"props":521,"children":522},{"__ignoreMap":7},[523,531,546,568,580,601],{"type":16,"tag":276,"props":524,"children":525},{"class":278,"line":279},[526],{"type":16,"tag":276,"props":527,"children":528},{"style":299},[529],{"type":21,"value":530},"# .excalibur\u002Fconfig.yaml\n",{"type":16,"tag":276,"props":532,"children":533},{"class":278,"line":305},[534,540],{"type":16,"tag":276,"props":535,"children":537},{"style":536},"--shiki-default:#22863A",[538],{"type":21,"value":539},"autonomyDefaults",{"type":16,"tag":276,"props":541,"children":543},{"style":542},"--shiki-default:#24292E",[544],{"type":21,"value":545},":\n",{"type":16,"tag":276,"props":547,"children":548},{"class":278,"line":328},[549,554,559,563],{"type":16,"tag":276,"props":550,"children":551},{"style":536},[552],{"type":21,"value":553},"  default",{"type":16,"tag":276,"props":555,"children":556},{"style":542},[557],{"type":21,"value":558},": ",{"type":16,"tag":276,"props":560,"children":561},{"style":288},[562],{"type":21,"value":216},{"type":16,"tag":276,"props":564,"children":565},{"style":299},[566],{"type":21,"value":567}," # the shipped default — dial it down per path\n",{"type":16,"tag":276,"props":569,"children":570},{"class":278,"line":351},[571,576],{"type":16,"tag":276,"props":572,"children":573},{"style":536},[574],{"type":21,"value":575},"autonomy",{"type":16,"tag":276,"props":577,"children":578},{"style":542},[579],{"type":21,"value":545},{"type":16,"tag":276,"props":581,"children":582},{"class":278,"line":379},[583,588,592,596],{"type":16,"tag":276,"props":584,"children":585},{"style":288},[586],{"type":21,"value":587},"  \"src\u002Fpayments\u002F**\"",{"type":16,"tag":276,"props":589,"children":590},{"style":542},[591],{"type":21,"value":558},{"type":16,"tag":276,"props":593,"children":594},{"style":288},[595],{"type":21,"value":126},{"type":16,"tag":276,"props":597,"children":598},{"style":299},[599],{"type":21,"value":600}," # advise only on the money path\n",{"type":16,"tag":276,"props":602,"children":603},{"class":278,"line":10},[604,609,613,617],{"type":16,"tag":276,"props":605,"children":606},{"style":288},[607],{"type":21,"value":608},"  \"infra\u002F**\"",{"type":16,"tag":276,"props":610,"children":611},{"style":542},[612],{"type":21,"value":558},{"type":16,"tag":276,"props":614,"children":615},{"style":288},[616],{"type":21,"value":95},{"type":16,"tag":276,"props":618,"children":619},{"style":299},[620],{"type":21,"value":621}," # read-only on infra\n",{"type":16,"tag":623,"props":624,"children":625},"note",{},[626],{"type":16,"tag":17,"props":627,"children":628},{},[629,631,636,638,644,646,651,653,658],{"type":21,"value":630},"In ",{"type":16,"tag":24,"props":632,"children":633},{},[634],{"type":21,"value":635},"Enterprise",{"type":21,"value":637},", these caps become server-side policy: a ",{"type":16,"tag":110,"props":639,"children":641},{"className":640},[],[642],{"type":21,"value":643},"maxAgentsPerRun",{"type":21,"value":645}," ceiling, autonomy ",{"type":16,"tag":437,"props":647,"children":648},{},[649],{"type":21,"value":650},"earned",{"type":21,"value":652}," by real outcomes (the Capability Ledger), and budgets that throttle large swarms before they start. See ",{"type":16,"tag":32,"props":654,"children":656},{"href":655},"\u002Fdocs\u002Fenterprise",[657],{"type":21,"value":635},{"type":21,"value":659},".",{"type":16,"tag":41,"props":661,"children":663},{"id":662},"next",[664],{"type":21,"value":665},"Next",{"type":16,"tag":667,"props":668,"children":669},"ul",{},[670,684],{"type":16,"tag":671,"props":672,"children":673},"li",{},[674,682],{"type":16,"tag":24,"props":675,"children":676},{},[677],{"type":16,"tag":32,"props":678,"children":679},{"href":34},[680],{"type":21,"value":681},"Safety",{"type":21,"value":683}," — the guardrails every level runs inside.",{"type":16,"tag":671,"props":685,"children":686},{},[687,696],{"type":16,"tag":24,"props":688,"children":689},{},[690],{"type":16,"tag":32,"props":691,"children":693},{"href":692},"\u002Fdocs\u002Fproviders",[694],{"type":21,"value":695},"Models & providers",{"type":21,"value":697}," — pick the model each run uses.",{"type":16,"tag":699,"props":700,"children":701},"style",{},[702],{"type":21,"value":703},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}",{"title":7,"searchDepth":305,"depth":305,"links":705},[706,707,708,709,710],{"id":43,"depth":305,"text":46},{"id":238,"depth":305,"text":241},{"id":411,"depth":305,"text":414},{"id":483,"depth":305,"text":486},{"id":662,"depth":305,"text":665},"markdown","content:docs:autonomy-levels.md","content","docs\u002Fautonomy-levels.md","docs\u002Fautonomy-levels","md",[718,721],{"_path":719,"title":720,"order":379},"\u002Fdocs\u002Fdashboard","Dashboard",{"_path":722,"title":723,"order":724},"\u002Fdocs\u002Fdiscovery","Discovery",7,[726,730,735,738,741,744,745,746,747,749,751,752,757],{"_path":727,"title":728,"order":279,"group":729},"\u002Fdocs\u002Fgetting-started","Getting started","Get started",{"_path":731,"title":732,"order":733,"group":734},"\u002Fdocs\u002Fcommands","Command reference",10,"Reference",{"_path":736,"title":737,"order":305,"group":729},"\u002Fdocs\u002Fthe-m-shell","The m-shell",{"_path":739,"title":740,"order":328,"group":11},"\u002Fdocs\u002Fworkflows","Workflows",{"_path":742,"title":743,"order":351,"group":11},"\u002Fdocs\u002Fmissions","Missions",{"_path":719,"title":720,"order":379,"group":11},{"_path":4,"title":8,"order":10,"group":11},{"_path":722,"title":723,"order":724,"group":11},{"_path":34,"title":681,"order":724,"group":748},"Govern",{"_path":655,"title":635,"order":750,"group":748},8,{"_path":692,"title":695,"order":750,"group":11},{"_path":753,"title":754,"order":755,"group":756},"\u002Fdocs\u002Fextensions","Extensions",9,"Extend",{"_path":758,"title":759,"order":755,"group":11},"\u002Fdocs\u002Fweb-research","Web & research",1782492858362]