[{"data":1,"prerenderedAt":706},["ShallowReactive",2],{"doc-\u002Fdocs\u002Fdiscovery":3,"surround-\u002Fdocs\u002Fdiscovery":663,"docs-nav":669},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"order":10,"group":11,"body":12,"_type":657,"_id":658,"_source":659,"_file":660,"_stem":661,"_extension":662},"\u002Fdocs\u002Fdiscovery","docs",false,"","Discovery","Decide what to build — or whether to build at all — before a line of code. The one gate no other AI tool has.",7,"Build",{"type":13,"children":14,"toc":649},"root",[15,43,50,75,80,137,143,149,154,262,277,283,288,360,365,424,430,442,465,512,544,550,606,612,643],{"type":16,"tag":17,"props":18,"children":19},"element","p",{},[20,26,28,34,36,41],{"type":16,"tag":21,"props":22,"children":23},"strong",{},[24],{"type":25,"value":8},"text",{"type":25,"value":27}," is lightweight pre-work: clarify an idea, ticket or piece of feedback ",{"type":16,"tag":29,"props":30,"children":31},"em",{},[32],{"type":25,"value":33},"before",{"type":25,"value":35}," committing engineering to it. It's the capability no other AI coding tool has — the judgment to recommend ",{"type":16,"tag":21,"props":37,"children":38},{},[39],{"type":25,"value":40},"not",{"type":25,"value":42}," building something yet, and to route ambiguous work to validation instead of code.",{"type":16,"tag":44,"props":45,"children":47},"h2",{"id":46},"how-it-runs",[48],{"type":25,"value":49},"How it runs",{"type":16,"tag":17,"props":51,"children":52},{},[53,55,60,62,67,69,73],{"type":25,"value":54},"Discovery runs ",{"type":16,"tag":21,"props":56,"children":57},{},[58],{"type":25,"value":59},"read-only",{"type":25,"value":61}," (L0–L1). It asks adaptive questions, scores the idea on deterministic, explainable criteria, and produces a recommendation — then ",{"type":16,"tag":21,"props":63,"children":64},{},[65],{"type":25,"value":66},"creates or enriches a work item",{"type":25,"value":68},". It is ",{"type":16,"tag":29,"props":70,"children":71},{},[72],{"type":25,"value":40},{"type":25,"value":74}," an implementation run.",{"type":16,"tag":17,"props":76,"children":77},{},[78],{"type":25,"value":79},"In the m-shell, just ask — or run it as a command:",{"type":16,"tag":81,"props":82,"children":86},"pre",{"className":83,"code":84,"language":85,"meta":7,"style":7},"language-bash shiki shiki-themes github-light","excalibur discovery \"should we add contract-renewal reminders?\"\nexcalibur discovery --from-file .\u002Fnotes\u002Ffeedback.md\n","bash",[87],{"type":16,"tag":88,"props":89,"children":90},"code",{"__ignoreMap":7},[91,114],{"type":16,"tag":92,"props":93,"children":96},"span",{"class":94,"line":95},"line",1,[97,103,109],{"type":16,"tag":92,"props":98,"children":100},{"style":99},"--shiki-default:#6F42C1",[101],{"type":25,"value":102},"excalibur",{"type":16,"tag":92,"props":104,"children":106},{"style":105},"--shiki-default:#032F62",[107],{"type":25,"value":108}," discovery",{"type":16,"tag":92,"props":110,"children":111},{"style":105},[112],{"type":25,"value":113}," \"should we add contract-renewal reminders?\"\n",{"type":16,"tag":92,"props":115,"children":117},{"class":94,"line":116},2,[118,122,126,132],{"type":16,"tag":92,"props":119,"children":120},{"style":99},[121],{"type":25,"value":102},{"type":16,"tag":92,"props":123,"children":124},{"style":105},[125],{"type":25,"value":108},{"type":16,"tag":92,"props":127,"children":129},{"style":128},"--shiki-default:#005CC5",[130],{"type":25,"value":131}," --from-file",{"type":16,"tag":92,"props":133,"children":134},{"style":105},[135],{"type":25,"value":136}," .\u002Fnotes\u002Ffeedback.md\n",{"type":16,"tag":138,"props":139,"children":142},"shell",{":lines":140,"title":141},"[{\"kind\":\"prompt\",\"text\":\"\u002Fdiscovery add an AI summary to every invoice\"},{\"kind\":\"arrow\",\"text\":\"Q  Who asked for this, and how often?\"},{\"kind\":\"cmd\",\"text\":\"two enterprise accounts last quarter\"},{\"kind\":\"arrow\",\"text\":\"Q  What breaks if we don't build it?\"},{\"kind\":\"cmd\",\"text\":\"nothing urgent — a nice-to-have\"},{\"kind\":\"blank\"},{\"kind\":\"head\",\"text\":\"clarity ▓▓▓▓▓▓▓░░  evidence ▓▓▓▓░░░░░░  scope ▓▓▓▓▓▓░░░░\"},{\"kind\":\"warn\",\"text\":\"recommendation: needs_validation\"},{\"kind\":\"ok\",\"text\":\"validate demand with 3 design-partner calls first\"},{\"kind\":\"arrow\",\"text\":\"work item created · WI-142 (Backlog)\",\"tone\":\"accent\"}]","excalibur — discovery",[],{"type":16,"tag":44,"props":144,"children":146},{"id":145},"the-diagnosis",[147],{"type":25,"value":148},"The diagnosis",{"type":16,"tag":17,"props":150,"children":151},{},[152],{"type":25,"value":153},"Every session scores five dimensions and lands on a recommendation:",{"type":16,"tag":155,"props":156,"children":157},"table",{},[158,177],{"type":16,"tag":159,"props":160,"children":161},"thead",{},[162],{"type":16,"tag":163,"props":164,"children":165},"tr",{},[166,172],{"type":16,"tag":167,"props":168,"children":169},"th",{},[170],{"type":25,"value":171},"Dimension",{"type":16,"tag":167,"props":173,"children":174},{},[175],{"type":25,"value":176},"Question it answers",{"type":16,"tag":178,"props":179,"children":180},"tbody",{},[181,198,214,230,246],{"type":16,"tag":163,"props":182,"children":183},{},[184,193],{"type":16,"tag":185,"props":186,"children":187},"td",{},[188],{"type":16,"tag":21,"props":189,"children":190},{},[191],{"type":25,"value":192},"Clarity",{"type":16,"tag":185,"props":194,"children":195},{},[196],{"type":25,"value":197},"Is the problem actually well understood?",{"type":16,"tag":163,"props":199,"children":200},{},[201,209],{"type":16,"tag":185,"props":202,"children":203},{},[204],{"type":16,"tag":21,"props":205,"children":206},{},[207],{"type":25,"value":208},"Evidence",{"type":16,"tag":185,"props":210,"children":211},{},[212],{"type":25,"value":213},"Is there real signal it matters?",{"type":16,"tag":163,"props":215,"children":216},{},[217,225],{"type":16,"tag":185,"props":218,"children":219},{},[220],{"type":16,"tag":21,"props":221,"children":222},{},[223],{"type":25,"value":224},"Scope",{"type":16,"tag":185,"props":226,"children":227},{},[228],{"type":25,"value":229},"Is it sized right, or should it be split?",{"type":16,"tag":163,"props":231,"children":232},{},[233,241],{"type":16,"tag":185,"props":234,"children":235},{},[236],{"type":16,"tag":21,"props":237,"children":238},{},[239],{"type":25,"value":240},"Risk",{"type":16,"tag":185,"props":242,"children":243},{},[244],{"type":25,"value":245},"What could go wrong, and how reversible is it?",{"type":16,"tag":163,"props":247,"children":248},{},[249,257],{"type":16,"tag":185,"props":250,"children":251},{},[252],{"type":16,"tag":21,"props":253,"children":254},{},[255],{"type":25,"value":256},"Readiness",{"type":16,"tag":185,"props":258,"children":259},{},[260],{"type":25,"value":261},"Is it ready for an agent to build?",{"type":16,"tag":81,"props":263,"children":266},{"className":264,"code":265,"language":25,"meta":7,"style":7},"language-text shiki shiki-themes github-light","build_now → build_soon → needs_validation → needs_prototype → do_not_build\n",[267],{"type":16,"tag":88,"props":268,"children":269},{"__ignoreMap":7},[270],{"type":16,"tag":92,"props":271,"children":272},{"class":94,"line":95},[273],{"type":16,"tag":92,"props":274,"children":275},{},[276],{"type":25,"value":265},{"type":16,"tag":44,"props":278,"children":280},{"id":279},"where-it-goes",[281],{"type":25,"value":282},"Where it goes",{"type":16,"tag":17,"props":284,"children":285},{},[286],{"type":25,"value":287},"Sessions are stored locally with the full transcript and artifacts:",{"type":16,"tag":81,"props":289,"children":291},{"className":83,"code":290,"language":85,"meta":7,"style":7},".excalibur\u002Fdiscovery\u002F\u003Cid>\u002F\n├── transcript.md\n├── discovery.json     # scores, recommendation, rationale\n└── artifacts\u002F         # scope notes, acceptance criteria, …\n",[292],{"type":16,"tag":88,"props":293,"children":294},{"__ignoreMap":7},[295,309,322,341],{"type":16,"tag":92,"props":296,"children":297},{"class":94,"line":95},[298,303],{"type":16,"tag":92,"props":299,"children":300},{"style":99},[301],{"type":25,"value":302},".excalibur\u002Fdiscovery\u002F",{"type":16,"tag":92,"props":304,"children":306},{"style":305},"--shiki-default:#24292E",[307],{"type":25,"value":308},"\u003Cid>\u002F\n",{"type":16,"tag":92,"props":310,"children":311},{"class":94,"line":116},[312,317],{"type":16,"tag":92,"props":313,"children":314},{"style":99},[315],{"type":25,"value":316},"├──",{"type":16,"tag":92,"props":318,"children":319},{"style":105},[320],{"type":25,"value":321}," transcript.md\n",{"type":16,"tag":92,"props":323,"children":325},{"class":94,"line":324},3,[326,330,335],{"type":16,"tag":92,"props":327,"children":328},{"style":99},[329],{"type":25,"value":316},{"type":16,"tag":92,"props":331,"children":332},{"style":105},[333],{"type":25,"value":334}," discovery.json",{"type":16,"tag":92,"props":336,"children":338},{"style":337},"--shiki-default:#6A737D",[339],{"type":25,"value":340},"     # scores, recommendation, rationale\n",{"type":16,"tag":92,"props":342,"children":344},{"class":94,"line":343},4,[345,350,355],{"type":16,"tag":92,"props":346,"children":347},{"style":99},[348],{"type":25,"value":349},"└──",{"type":16,"tag":92,"props":351,"children":352},{"style":105},[353],{"type":25,"value":354}," artifacts\u002F",{"type":16,"tag":92,"props":356,"children":357},{"style":337},[358],{"type":25,"value":359},"         # scope notes, acceptance criteria, …\n",{"type":16,"tag":17,"props":361,"children":362},{},[363],{"type":25,"value":364},"From the result you can promote the outcome — in-shell actions or CLI:",{"type":16,"tag":81,"props":366,"children":368},{"className":83,"code":367,"language":85,"meta":7,"style":7},"discovery create-work-item     # enrich the backlog (default)\ndiscovery create-run           # build it now (confirms if not \"build_now\")\ndiscovery save-decision        # record the rationale to project memory\n",[369],{"type":16,"tag":88,"props":370,"children":371},{"__ignoreMap":7},[372,390,407],{"type":16,"tag":92,"props":373,"children":374},{"class":94,"line":95},[375,380,385],{"type":16,"tag":92,"props":376,"children":377},{"style":99},[378],{"type":25,"value":379},"discovery",{"type":16,"tag":92,"props":381,"children":382},{"style":105},[383],{"type":25,"value":384}," create-work-item",{"type":16,"tag":92,"props":386,"children":387},{"style":337},[388],{"type":25,"value":389},"     # enrich the backlog (default)\n",{"type":16,"tag":92,"props":391,"children":392},{"class":94,"line":116},[393,397,402],{"type":16,"tag":92,"props":394,"children":395},{"style":99},[396],{"type":25,"value":379},{"type":16,"tag":92,"props":398,"children":399},{"style":105},[400],{"type":25,"value":401}," create-run",{"type":16,"tag":92,"props":403,"children":404},{"style":337},[405],{"type":25,"value":406},"           # build it now (confirms if not \"build_now\")\n",{"type":16,"tag":92,"props":408,"children":409},{"class":94,"line":324},[410,414,419],{"type":16,"tag":92,"props":411,"children":412},{"style":99},[413],{"type":25,"value":379},{"type":16,"tag":92,"props":415,"children":416},{"style":105},[417],{"type":25,"value":418}," save-decision",{"type":16,"tag":92,"props":420,"children":421},{"style":337},[422],{"type":25,"value":423},"        # record the rationale to project memory\n",{"type":16,"tag":44,"props":425,"children":427},{"id":426},"the-domain-model",[428],{"type":25,"value":429},"The domain model",{"type":16,"tag":17,"props":431,"children":432},{},[433,435,440],{"type":25,"value":434},"Discovery sits at the front of the cycle and produces the ",{"type":16,"tag":21,"props":436,"children":437},{},[438],{"type":25,"value":439},"unit of work",{"type":25,"value":441},":",{"type":16,"tag":81,"props":443,"children":445},{"className":264,"code":444,"language":25,"meta":7,"style":7},"Idea → (Discovery) → Work item [Backlog → Ready] → Run(s) [Building → Review] → Done\n                                                   └→ or: do_not_build → closed\n",[446],{"type":16,"tag":88,"props":447,"children":448},{"__ignoreMap":7},[449,457],{"type":16,"tag":92,"props":450,"children":451},{"class":94,"line":95},[452],{"type":16,"tag":92,"props":453,"children":454},{},[455],{"type":25,"value":456},"Idea → (Discovery) → Work item [Backlog → Ready] → Run(s) [Building → Review] → Done\n",{"type":16,"tag":92,"props":458,"children":459},{"class":94,"line":116},[460],{"type":16,"tag":92,"props":461,"children":462},{},[463],{"type":25,"value":464},"                                                   └→ or: do_not_build → closed\n",{"type":16,"tag":466,"props":467,"children":468},"ul",{},[469,480,490],{"type":16,"tag":470,"props":471,"children":472},"li",{},[473,478],{"type":16,"tag":21,"props":474,"children":475},{},[476],{"type":25,"value":477},"Work item",{"type":25,"value":479}," — the base unit of work (a backlog ticket). It can exist with zero runs.",{"type":16,"tag":470,"props":481,"children":482},{},[483,488],{"type":16,"tag":21,"props":484,"children":485},{},[486],{"type":25,"value":487},"Run",{"type":25,"value":489}," — the agentic execution that fulfils a work item (a work item can have 0..N runs).",{"type":16,"tag":470,"props":491,"children":492},{},[493,497,499,504,506,510],{"type":16,"tag":21,"props":494,"children":495},{},[496],{"type":25,"value":8},{"type":25,"value":498}," — pre-work that ",{"type":16,"tag":29,"props":500,"children":501},{},[502],{"type":25,"value":503},"creates or enriches",{"type":25,"value":505}," a work item. It is ",{"type":16,"tag":21,"props":507,"children":508},{},[509],{"type":25,"value":40},{"type":25,"value":511}," a run.",{"type":16,"tag":513,"props":514,"children":515},"note",{},[516],{"type":16,"tag":17,"props":517,"children":518},{},[519,521,526,528,534,536,542],{"type":25,"value":520},"In ",{"type":16,"tag":21,"props":522,"children":523},{},[524],{"type":25,"value":525},"Enterprise",{"type":25,"value":527},", Discovery also runs from issue comments (",{"type":16,"tag":88,"props":529,"children":531},{"className":530},[],[532],{"type":25,"value":533},"@excalibur discovery|refine|readiness|…",{"type":25,"value":535},") and Slack threads, writing results straight back to Linear\u002FJira and the team backlog. See ",{"type":16,"tag":537,"props":538,"children":540},"a",{"href":539},"\u002Fdocs\u002Fenterprise",[541],{"type":25,"value":525},{"type":25,"value":543},".",{"type":16,"tag":44,"props":545,"children":547},{"id":546},"plan-shaping-co-create-the-plan-before-building",[548],{"type":25,"value":549},"Plan-shaping — co-create the plan before building",{"type":16,"tag":17,"props":551,"children":552},{},[553,555,560,562,567,569,574,576,581,583,588,590,596,598,604],{"type":25,"value":554},"Once you ",{"type":16,"tag":29,"props":556,"children":557},{},[558],{"type":25,"value":559},"are",{"type":25,"value":561}," building, Excalibur shapes the plan ",{"type":16,"tag":29,"props":563,"children":564},{},[565],{"type":25,"value":566},"with",{"type":25,"value":568}," you instead of guessing. Before a multi-step build runs, it proposes a few ",{"type":16,"tag":21,"props":570,"children":571},{},[572],{"type":25,"value":573},"clarifying questions",{"type":25,"value":575}," whose answers would change the plan, plus a ",{"type":16,"tag":21,"props":577,"children":578},{},[579],{"type":25,"value":580},"multi-select list of recommendations",{"type":25,"value":582}," — related or commonly-forgotten work (tests, error handling, a migration, a feature flag, telemetry) with the high-value ones pre-checked. Your choices refine the scope before any code is written. It is ",{"type":16,"tag":21,"props":584,"children":585},{},[586],{"type":25,"value":587},"gated",{"type":25,"value":589},": it stays silent on small or already-clear tasks and only surfaces when it genuinely helps (a large or under-specified plan). On a large build, an automatic read-only ",{"type":16,"tag":537,"props":591,"children":593},{"href":592},"\u002Fdocs\u002Fthe-m-shell#understand-first-scope",[594],{"type":25,"value":595},"scope",{"type":25,"value":597}," map runs first so the questions and recommendations are grounded in your real code, not guesses. The web ",{"type":16,"tag":537,"props":599,"children":601},{"href":600},"\u002Fdocs\u002Fdashboard",[602],{"type":25,"value":603},"dashboard",{"type":25,"value":605}," has a plan-shaping panel for the same flow.",{"type":16,"tag":44,"props":607,"children":609},{"id":608},"next",[610],{"type":25,"value":611},"Next",{"type":16,"tag":466,"props":613,"children":614},{},[615,629],{"type":16,"tag":470,"props":616,"children":617},{},[618,627],{"type":16,"tag":21,"props":619,"children":620},{},[621],{"type":16,"tag":537,"props":622,"children":624},{"href":623},"\u002Fdocs\u002Fworkflows",[625],{"type":25,"value":626},"Workflows",{"type":25,"value":628}," — the recipe a ready work item runs through.",{"type":16,"tag":470,"props":630,"children":631},{},[632,641],{"type":16,"tag":21,"props":633,"children":634},{},[635],{"type":16,"tag":537,"props":636,"children":638},{"href":637},"\u002Fdocs\u002Fautonomy-levels",[639],{"type":25,"value":640},"Autonomy levels",{"type":25,"value":642}," — how the resulting run executes.",{"type":16,"tag":644,"props":645,"children":646},"style",{},[647],{"type":25,"value":648},"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":116,"depth":116,"links":650},[651,652,653,654,655,656],{"id":46,"depth":116,"text":49},{"id":145,"depth":116,"text":148},{"id":279,"depth":116,"text":282},{"id":426,"depth":116,"text":429},{"id":546,"depth":116,"text":549},{"id":608,"depth":116,"text":611},"markdown","content:docs:discovery.md","content","docs\u002Fdiscovery.md","docs\u002Fdiscovery","md",[664,666],{"_path":637,"title":640,"order":665},6,{"_path":667,"title":668,"order":10},"\u002Fdocs\u002Fsafety","Safety",[670,674,679,682,683,686,689,690,691,693,695,698,703],{"_path":671,"title":672,"order":95,"group":673},"\u002Fdocs\u002Fgetting-started","Getting started","Get started",{"_path":675,"title":676,"order":677,"group":678},"\u002Fdocs\u002Fcommands","Command reference",10,"Reference",{"_path":680,"title":681,"order":116,"group":673},"\u002Fdocs\u002Fthe-m-shell","The m-shell",{"_path":623,"title":626,"order":324,"group":11},{"_path":684,"title":685,"order":343,"group":11},"\u002Fdocs\u002Fmissions","Missions",{"_path":600,"title":687,"order":688,"group":11},"Dashboard",5,{"_path":637,"title":640,"order":665,"group":11},{"_path":4,"title":8,"order":10,"group":11},{"_path":667,"title":668,"order":10,"group":692},"Govern",{"_path":539,"title":525,"order":694,"group":692},8,{"_path":696,"title":697,"order":694,"group":11},"\u002Fdocs\u002Fproviders","Models & providers",{"_path":699,"title":700,"order":701,"group":702},"\u002Fdocs\u002Fextensions","Extensions",9,"Extend",{"_path":704,"title":705,"order":701,"group":11},"\u002Fdocs\u002Fweb-research","Web & research",1782492858386]