[{"data":1,"prerenderedAt":581},["ShallowReactive",2],{"doc:en:\u002Fzekoder-workflow\u002Foverview":3,"navigation:en":497,"surround:en:\u002Fzekoder-workflow\u002Foverview":576},{"page":4,"fallback":496},{"id":5,"title":6,"body":7,"description":487,"extension":488,"meta":489,"navigation":490,"path":492,"seo":493,"stem":494,"__hash__":495},"docs_en\u002Fzekoder-workflow\u002Foverview.md","How the workflow works",{"type":8,"value":9,"toc":476},"minimark",[10,25,30,82,89,93,191,195,205,313,323,327,332,347,363,370,380,390,394,418,439,447,456,464,468],[11,12,13,14,18,19,24],"p",{},"The Zekoder workflow keeps a repository's planned work as files inside the repository, in a ",[15,16,17],"code",{},".zekoder\u002F"," folder. Agents read and write those files through the Zekoder MCP server, and the ",[20,21,23],"a",{"href":22},"\u002Fzekoder-workflow\u002Fissues","Issues screen"," shows the same data.",[26,27,29],"h2",{"id":28},"the-path-from-idea-to-merge","The path from idea to merge",[31,32,33,45,61,76],"ol",{},[34,35,36,44],"li",{},[37,38,39,43],"strong",{},[20,40,42],{"href":41},"\u002Fzekoder-workflow\u002Fcommands#capture","Capture","."," Write down an idea, a bug, a followup, or a decision with a quick command. Nothing is planned yet.",[34,46,47,53,54,57,58,43],{},[37,48,49,43],{},[20,50,52],{"href":51},"\u002Fzekoder-workflow\u002Fcommands#what-zekoder-plan-does","Plan"," ",[15,55,56],{},"\u002Fzekoder-plan"," turns an item into a plan: it asks you questions, studies the code, writes the plan, and has a reviewer agent check it. You approve the plan before it is committed. The item becomes ",[37,59,60],{},"planned",[34,62,63,53,69,72,73,75],{},[37,64,65,43],{},[20,66,68],{"href":67},"\u002Fzekoder-workflow\u002Fcommands#what-zekoder-implement-does","Implement",[15,70,71],{},"\u002Fzekoder-implement"," (or ",[37,74,68],{}," on the Issues screen) hands the plan to a supervisor agent. It splits the work into tasks, runs each task in its own git worktree with a coding agent, reviews and checks each one, and merges the result.",[34,77,78,81],{},[37,79,80],{},"Done."," The item closes as completed or fixed.",[11,83,84,85,43],{},"You approve every commit the workflow makes to your main branch: plans before they land, and code through a pull request or a local merge, depending on your ",[20,86,88],{"href":87},"\u002Fzekoder-workflow\u002Fproject-settings#merge","merge mode",[26,90,92],{"id":91},"item-types","Item types",[94,95,96,112],"table",{},[97,98,99],"thead",{},[100,101,102,106,109],"tr",{},[103,104,105],"th",{},"Type",[103,107,108],{},"What it is",[103,110,111],{},"Can be implemented",[113,114,115,129,141,153,166,178],"tbody",{},[100,116,117,123,126],{},[118,119,120],"td",{},[37,121,122],{},"Feature",[118,124,125],{},"New behavior. Large features split into packages.",[118,127,128],{},"Yes",[100,130,131,136,139],{},[118,132,133],{},[37,134,135],{},"Bug",[118,137,138],{},"Something broken in this repository.",[118,140,128],{},[100,142,143,148,151],{},[118,144,145],{},[37,146,147],{},"Followup",[118,149,150],{},"Technical debt or deferred work.",[118,152,128],{},[100,154,155,160,163],{},[118,156,157],{},[37,158,159],{},"Vendor issue",[118,161,162],{},"A bug in a third-party tool or service you depend on.",[118,164,165],{},"No, tracked only",[100,167,168,173,176],{},[118,169,170],{},[37,171,172],{},"Decision",[118,174,175],{},"An architecture decision record (ADR).",[118,177,165],{},[100,179,180,185,188],{},[118,181,182],{},[37,183,184],{},"Idea",[118,186,187],{},"A loose thought, not yet worth planning.",[118,189,190],{},"No, promote it first",[26,192,194],{"id":193},"statuses","Statuses",[11,196,197,198,201,202,43],{},"Every item has a status and a sub-status, such as ",[15,199,200],{},"open\u002Fplanned"," or ",[15,203,204],{},"closed\u002Fcompleted",[94,206,207,217],{},[97,208,209],{},[100,210,211,214],{},[103,212,213],{},"Status",[103,215,216],{},"Meaning",[113,218,219,254,280,303],{},[100,220,221,226],{},[118,222,223],{},[15,224,225],{},"open",[118,227,228,229,232,233,232,236,238,239,232,242,245,246,249,250,253],{},"Not started. Sub-statuses: ",[15,230,231],{},"new",", ",[15,234,235],{},"planning",[15,237,60],{}," (",[15,240,241],{},"triage",[15,243,244],{},"confirmed"," for bugs; ",[15,247,248],{},"captured"," for ideas; ",[15,251,252],{},"proposed"," for decisions).",[100,255,256,261],{},[118,257,258],{},[15,259,260],{},"in-progress",[118,262,263,264,232,267,232,270,232,273,232,276,279],{},"Being implemented (",[15,265,266],{},"coding",[15,268,269],{},"review",[15,271,272],{},"ready-to-merge",[15,274,275],{},"code-merged",[15,277,278],{},"pushed",") or discussed.",[100,281,282,287],{},[118,283,284],{},[15,285,286],{},"closed",[118,288,289,290,232,293,232,296,232,299,302],{},"Finished: ",[15,291,292],{},"completed",[15,294,295],{},"fixed",[15,297,298],{},"promoted",[15,300,301],{},"accepted",", and so on.",[100,304,305,310],{},[118,306,307],{},[15,308,309],{},"cancelled",[118,311,312],{},"Dropped.",[11,314,315,316,318,319,322],{},"Only ",[15,317,200],{}," features, bugs, and followups can be implemented. Only ",[15,320,321],{},"open\u002Fcaptured"," ideas can be promoted from the Issues screen.",[26,324,326],{"id":325},"light-and-full-plans","Light and full plans",[11,328,329,331],{},[15,330,56],{}," picks a size for each plan:",[333,334,335,341],"ul",{},[34,336,337,340],{},[37,338,339],{},"Light",": one document and one branch, for changes of about five files or fewer in one area with no new contracts or dependencies. When in doubt, Zekoder recommends light.",[34,342,343,346],{},[37,344,345],{},"Full",": extra investigation agents and a thorough review. A full feature gets its own folder with an overview, a checklist, contracts, external dependencies, and one document per package.",[11,348,349,350,353,354,357,358,362],{},"Set ",[37,351,352],{},"Planning tier"," to ",[37,355,356],{},"Always full"," in ",[20,359,361],{"href":360},"\u002Fzekoder-workflow\u002Fproject-settings","project settings"," to skip light plans.",[26,364,366,367,369],{"id":365},"the-zekoder-folder","The ",[15,368,17],{}," folder",[371,372,378],"pre",{"className":373,"code":375,"language":376,"meta":377},[374],"language-text",".zekoder\u002F\n  this.md            what the repository is, its rules and quality gates\n  kb\u002F                longer reference notes: architecture, conventions, goals, guardrails\n  features\u002F          one file per light feature, one folder per full feature\n  bugs\u002F\n  followups\u002F\n  vendor-issues\u002F\n  decisions\u002F\n  ideas\u002F\n  config.json        your workflow settings (not committed)\n","text","",[15,379,375],{"__ignoreMap":377},[11,381,382,383,385,386,389],{},"Commit everything in ",[15,384,17],{}," except ",[15,387,388],{},"config.json",", which holds each developer's own settings and stays out of git.",[26,391,393],{"id":392},"set-up-a-repository","Set up a repository",[11,395,396,397,399,400,232,402,232,405,232,408,232,411,414,415,417],{},"You do not create ",[15,398,17],{}," by hand. The first time you run ",[15,401,56],{},[15,403,404],{},"\u002Fzekoder-bug-report",[15,406,407],{},"\u002Fzekoder-debt",[15,409,410],{},"\u002Fzekoder-decision",[15,412,413],{},"\u002Fzekoder-goals",", or ",[15,416,71],{}," in a repository without it, Zekoder asks to set it up. A first-time agent then:",[31,419,420,425,436],{},[34,421,422,423,43],{},"Creates the folders and ",[15,424,388],{},[34,426,427,428,431,432,435],{},"Reads the repository and writes ",[15,429,430],{},"this.md"," and the ",[15,433,434],{},"kb\u002F"," notes.",[34,437,438],{},"Shows you the result and commits it after you approve.",[11,440,441,442,444,445,43],{},"The first ",[15,443,56],{}," also asks three one-time questions: the maximum number of packages per feature, the default merge mode, and the simplify mode. You can change them later in ",[20,446,361],{"href":360},[11,448,449,450,455],{},"Run ",[20,451,453],{"href":452},"\u002Fzekoder-workflow\u002Fcommands#repository-and-settings",[15,454,413],{}," to write down the repository's purpose, goals, and guardrails, which planners follow.",[11,457,458,463],{},[20,459,460],{"href":41},[15,461,462],{},"\u002Fzekoder-idea"," never sets up a repository. Run one of the commands above first.",[26,465,467],{"id":466},"where-the-workflow-runs","Where the workflow runs",[11,469,470,471,475],{},"The workflow's skills, agents, and MCP server are installed once for your user on each host, not into each repository. Zekoder installs and updates them automatically; see ",[20,472,474],{"href":473},"\u002Fzekoder-workflow\u002Fversion","Versions and updates",". They work with Claude Code and Codex by default, and with OpenCode and Oh My Pi when you select them.",{"title":377,"searchDepth":477,"depth":477,"links":478},2,[479,480,481,482,483,485,486],{"id":28,"depth":477,"text":29},{"id":91,"depth":477,"text":92},{"id":193,"depth":477,"text":194},{"id":325,"depth":477,"text":326},{"id":365,"depth":477,"text":484},"The .zekoder\u002F folder",{"id":392,"depth":477,"text":393},{"id":466,"depth":477,"text":467},"Work items, plans, the .zekoder folder, and the path an item takes from idea to merged code.","md",{},{"order":491},1,"\u002Fzekoder-workflow\u002Foverview",{"title":6,"description":487},"zekoder-workflow\u002Foverview","Fktc2x6jI9Q1uxXoTZDr48HiofQvYirp6MgFIqAL2pI",false,[498,503,520,548,571],{"title":499,"path":500,"stem":501,"order":502},"Zekoder documentation","\u002F","index",-1,{"title":504,"path":505,"stem":506,"children":507,"page":496},"Getting started","\u002Fgetting-started","getting-started",[508,512,516],{"title":509,"path":510,"stem":511},"Install","\u002Fgetting-started\u002Finstall","getting-started\u002Finstall",{"title":513,"path":514,"stem":515,"order":491},"Quick start","\u002Fgetting-started\u002Fquick-start","getting-started\u002Fquick-start",{"title":517,"path":518,"stem":519,"order":477},"Connect a host","\u002Fgetting-started\u002Fconnect-a-host","getting-started\u002Fconnect-a-host",{"title":521,"path":522,"stem":523,"children":524,"page":496},"Using Zekoder","\u002Fusing-zekoder","using-zekoder",[525,529,533,538,543],{"title":526,"path":527,"stem":528,"order":491},"Projects and workspaces","\u002Fusing-zekoder\u002Fprojects-and-workspaces","using-zekoder\u002Fprojects-and-workspaces",{"title":530,"path":531,"stem":532,"order":477},"Agents and the composer","\u002Fusing-zekoder\u002Fagents","using-zekoder\u002Fagents",{"title":534,"path":535,"stem":536,"order":537},"Review changes","\u002Fusing-zekoder\u002Freview-changes","using-zekoder\u002Freview-changes",3,{"title":539,"path":540,"stem":541,"order":542},"Keyboard shortcuts","\u002Fusing-zekoder\u002Fkeyboard-shortcuts","using-zekoder\u002Fkeyboard-shortcuts",4,{"title":544,"path":545,"stem":546,"order":547},"Settings and updates","\u002Fusing-zekoder\u002Fsettings-and-updates","using-zekoder\u002Fsettings-and-updates",5,{"title":549,"path":550,"stem":551,"children":552,"page":496},"Zekoder workflow","\u002Fzekoder-workflow","zekoder-workflow",[553,554,558,561,564,568],{"title":6,"path":492,"stem":494,"order":491},{"title":555,"path":556,"stem":557,"order":477},"Commands","\u002Fzekoder-workflow\u002Fcommands","zekoder-workflow\u002Fcommands",{"title":559,"path":22,"stem":560,"order":537},"The Issues screen","zekoder-workflow\u002Fissues",{"title":562,"path":360,"stem":563,"order":542},"Project settings","zekoder-workflow\u002Fproject-settings",{"title":565,"path":566,"stem":567,"order":547},"Coding health reports","\u002Fzekoder-workflow\u002Freports","zekoder-workflow\u002Freports",{"title":474,"path":473,"stem":569,"order":570},"zekoder-workflow\u002Fversion",6,{"title":572,"path":573,"stem":574,"order":575},"What changed","\u002Fwhats-changed","whats-changed",99,[577,579],{"title":559,"path":22,"stem":560,"description":578,"order":537,"children":-1},"Browse, search, and read every work item in your Zekoder projects, then implement or promote them in one click.",{"title":562,"path":360,"stem":563,"description":580,"order":542,"children":-1},"Configure merge mode, planning, simplify, custom prompts, and the providers and models Zekoder agents start with.",1792573526857]