[{"data":1,"prerenderedAt":30},["ShallowReactive",2],{"doc:en:shared-board":3},{"title":4,"lede":5,"html":6,"headings":7},"Sharing the Kanban with the team","A shared ticket is a file of the repository that you commit with your work: your teammates find it on their Kanban at their pull, with your name, and its status follows everyone’s work.","\u003Ch2 id=\"share-a-ticket\">Share a ticket\u003C\u002Fh2>\n\u003Cp>Right-click the card, “Share with the team”, or the switch of the same name in the ticket’s form. Escouade then writes a file \u003Ccode>.escouade\u002Ftickets\u002F<id>.yml\u003C\u002Fcode> in the project’s folder, and a small mark shows beside the ticket’s key; its tooltip gives the file.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Escouade writes the file again at each change that matters: an agent takes the ticket, it moves to “To review”, it is approved, sent back or put back in “To do”, its title, description or criteria change. Never at each loop.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Escouade never commits or pushes this file.\u003C\u002Fstrong> It shows among the uncommitted files of the \u003Ca href=\"\u002Fen\u002Fdocs\u002Fgit\u002F\">Git panel\u003C\u002Fa>, on “Whole project”, in a “Shared tickets” group: each file is named by its ticket’s key and title. Commit it with your work; the team gets it at their pull.\u003C\u002Fli>\n\u003Cli>These files block neither a merge nor a ticket’s approval: a folder where only the tickets’ files changed counts as clean.\u003C\u002Fli>\n\u003Cli>The ticket’s images are shared in a folder beside the file, \u003Ccode>.escouade\u002Ftickets\u002F<id>\u002F\u003C\u002Fcode>; its joined files too, up to 5 MB. A bigger joined file stays with you, and the form says so.\u003C\u002Fli>\n\u003Cli>“Stop sharing” deletes the file (the deletion is to be committed); the ticket stays with you as it is. Deleting a shared ticket deletes its file too.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>In Settings › Projects, the “Shared Kanban” group says how many tickets the project shares, and “Share every new ticket” shares from the start those you make, by hand, by an import or through MCP.\u003C\u002Fp>\n\u003Ch2 id=\"your-name\">Your name\u003C\u002Fh2>\n\u003Cp>Each file carries its author’s name, and the name of whoever took the ticket. Escouade asks for yours at the first launch, filled in from \u003Ccode>git config user.name\u003C\u002Fcode>; “Later” puts the question off until your first share.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>You change it in Settings › Application › Team, “Your name”.\u003C\u002Fli>\n\u003Cli>A project may have its own: Settings › Projects › Shared Kanban, “Your name in this project”. Empty, it is the application’s.\u003C\u002Fli>\n\u003Cli>Your name stays on your machine: it is never written in \u003Ca href=\"\u002Fen\u002Fdocs\u002Fescouade-yml\u002F\">.escouade.yml\u003C\u002Fa>.\u003C\u002Fli>\n\u003Cli>Beside the name, an id made from your git e-mail (the e-mail itself is written nowhere) tells your tickets from a namesake’s. It is what says whether a ticket is yours; it is the same on your other machines.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"someone-else-s-ticket\">Someone else’s ticket\u003C\u002Fh2>\n\u003Cp>After your pull, a ticket Alice shared shows on your Kanban, in the column of its status, with her name and a disc of her initial on the card.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>In “To do”, the card says “Added by Alice · the autopilot never starts it”: your \u003Ca href=\"\u002Fen\u002Fdocs\u002Fautopilot\u002F\">autopilot\u003C\u002Fa> never takes it, even at the top of the column. The “Start” button starts it by hand, autopilot on or off.\u003C\u002Fli>\n\u003Cli>Started on your machine, it behaves like one of yours (worktree, loops, approval), and its file says you took it. It keeps its author.\u003C\u002Fli>\n\u003Cli>Under way on someone else’s machine, the card says “Taken by Alice”; to review, “To review at Alice’s”; finished, “Done by Alice”. These tickets take no place on your Kanban and your Escouade never takes them up: only whoever took it approves it.\u003C\u002Fli>\n\u003Cli>Its menu also offers “Edit” (what you change goes into its file, for the whole team), “Hide for me” (the file stays; a band of the Kanban says how many tickets are hidden and shows them on demand) and “Delete for the team…” (deletes its file, to be committed).\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Escouade reads the \u003Ccode class=\"key\">.escouade\u002Ftickets\u002F\u003C\u002Fcode> folder again as soon as it changes: after a pull, another branch, an edit by hand. A ticket Alice finished moves to “Done” on your Kanban after your pull.\u003C\u002Fp>\n\u003Ch2 id=\"the-file-s-format\">The file’s format\u003C\u002Fh2>\n\u003Cpre>\u003Ccode class=\"language-yaml\"># A ticket of the Kanban shared by Escouade: https:\u002F\u002Fescouade.dev\u002Fen\u002Fdocs\u002Fshared-board\n# Escouade writes it again at each status; commit it with your work, Escouade never does.\n# yaml-language-server: $schema=https:\u002F\u002Fescouade.dev\u002Fschemas\u002Fescouade-ticket.schema.json\nversion: 1\nid: q4w7c2na\nkey: DEM-7\ntitle: Login audit log\nstatus: in-progress\nauthor: { name: Alice Martin, id: a91f03c2 }\ntaken_by: { name: Bob Durand, id: 5d0e77b1 }\nupdated_by: { name: Bob Durand, id: 5d0e77b1 }\ncreated: 2026-10-26T09:12:04+01:00\nupdated: 2026-10-26T15:02:40+01:00\nafter: [p2v8c4ma]\ndescription: |-\n  Each login attempt leaves a line: who, when, from where.\ncriteria:\n  - Every login, successful or not, is logged\n  - Tests pass\nimages:\n  - { name: mockup.png, file: 3f2a9c01b7de.png }\nfiles: []\nexternal: null\noutcome: null\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"table\">\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Key\u003C\u002Fth>\n\u003Cth>What it says\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode class=\"key\">id\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The ticket’s stable id, its file’s name; never its key.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode class=\"key\">key\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Its key, as its author’s Kanban gave it.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode class=\"key\">status\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode class=\"key\">todo\u003C\u002Fcode>, \u003Ccode class=\"key\">in-progress\u003C\u002Fcode>, \u003Ccode class=\"key\">review\u003C\u002Fcode> or \u003Ccode class=\"key\">done\u003C\u002Fcode>.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode class=\"key\">author\u003C\u002Fcode>, \u003Ccode class=\"key\">taken_by\u003C\u002Fcode>, \u003Ccode class=\"key\">updated_by\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Who shared it, who started it, who last changed the file: \u003Ccode>{ name, id }\u003C\u002Fcode>.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode class=\"key\">after\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The \u003Ccode class=\"key\">id\u003C\u002Fcode>s of the shared tickets it waits for (“After”).\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode class=\"key\">images\u003C\u002Fcode>, \u003Ccode class=\"key\">files\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Its images and joined files, in the folder of its \u003Ccode class=\"key\">id\u003C\u002Fcode>.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode class=\"key\">external\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The Jira, Trello, GitHub, Linear, ClickUp, GitLab or Azure Boards ticket it was imported from.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode class=\"key\">outcome\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>What its approval did, once done.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\n\u003Cp>Stay on your machine: the loops, the cost, the agent’s progress, the criteria met, the account, the model, the agent and its branch. The format’s JSON schema is published at \u003Ccode>https:\u002F\u002Fescouade.dev\u002Fschemas\u002Fescouade-ticket.schema.json\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp>For a project of several repositories whose folder is not a repository itself, the \u003Ccode class=\"key\">.escouade\u002Ftickets\u002F\u003C\u002Fcode> folder goes in the first repository.\u003C\u002Fp>\n\u003Ch2 id=\"keys\">Keys\u003C\u002Fh2>\n\u003Cp>A shared ticket keeps everywhere the key its author gave it: Alice’s DEM-12 is DEM-12 on your Kanban. Your new tickets never take the key of a shared ticket you received. If Alice and you each made a DEM-12 before pulling, yours keeps its key and hers carries Alice’s name on its card; for the \u003Ca href=\"\u002Fen\u002Fdocs\u002Fmcp\u002F\">MCP server\u003C\u002Fa>, it is named \u003Ccode class=\"key\">DEM-12@alice\u003C\u002Fcode>, or by its id.\u003C\u002Fp>\n\u003Ch2 id=\"when-it-gets-stuck\">When it gets stuck\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Two people on the same ticket.\u003C\u002Fstrong> If the file you get says Alice took it while your agent works on it, your agent goes on and the card says so; your next status writes the file again.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>A file in a git conflict.\u003C\u002Fstrong> Escouade does not read it: the card keeps its last state and offers “Keep mine” (Escouade writes the file again with your version, which settles the conflict) or “Take theirs” (the side merged in). Nothing is committed.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>A file that can’t be read.\u003C\u002Fstrong> It becomes a “Shared ticket that can’t be read” card, with the line in cause; Escouade never writes it nor starts it.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>A ticket its author no longer shares.\u003C\u002Fstrong> It leaves your Kanban at your pull, unless you had started it: it then stays with you, as one of yours.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>An import already shared.\u003C\u002Fstrong> Importing a Jira, Trello, GitHub, Linear, ClickUp, GitLab or Azure Boards ticket a teammate already shared makes no duplicate: your import, if not started, becomes the shared ticket.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>A private project.\u003C\u002Fstrong> It is shared too: “private” is about what Escouade’s other projects see, not your team on the repository. Its shared tickets stay out of sight of the other projects’ agents.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"with-the-mcp-server\">With the MCP server\u003C\u002Fh2>\n\u003Cp>The ticket tools of the \u003Ca href=\"\u002Fen\u002Fdocs\u002Fmcp\u002F\">MCP server\u003C\u002Fa> say whether a ticket is shared (\u003Ccode class=\"key\">shared\u003C\u002Fcode>: by whom, whether it is you, who took it, its file). \u003Ccode class=\"key\">create_ticket\u003C\u002Fcode> and \u003Ccode class=\"key\">update_ticket\u003C\u002Fcode> take \u003Ccode>shared: true\u003C\u002Fcode> to share, \u003Ccode class=\"key\">false\u003C\u002Fcode> to stop. An agent never starts a ticket someone else shared: \u003Ccode class=\"key\">start_ticket\u003C\u002Fcode> refuses it, and so does \u003Ccode class=\"key\">delete_ticket\u003C\u002Fcode>; only you start, hide or delete it, from the Kanban.\u003C\u002Fp>\n",[8,12,15,18,21,24,27],{"id":9,"text":10,"depth":11},"share-a-ticket","Share a ticket",2,{"id":13,"text":14,"depth":11},"your-name","Your name",{"id":16,"text":17,"depth":11},"someone-else-s-ticket","Someone else’s ticket",{"id":19,"text":20,"depth":11},"the-file-s-format","The file’s format",{"id":22,"text":23,"depth":11},"keys","Keys",{"id":25,"text":26,"depth":11},"when-it-gets-stuck","When it gets stuck",{"id":28,"text":29,"depth":11},"with-the-mcp-server","With the MCP server",1793278986668]