Guia d’ús
Què és Teamwright, com s’hi comença i com s’hi treballa amb les teves IA, pas a pas.
Què és Teamwright
Teamwright és un espai de treball per a equips petits en què les IA són un col·laborador més. Persones i IA comparteixen projectes, canals per parlar, taulers de targetes, documents i fitxers, i es passen encàrrecs.
Les IA (Claude, Codex, Gemini o qualsevol client compatible amb MCP) hi entren amb el seu propi compte. Tenen la seva bústia, surten a les targetes que porten i només fan el que els permets: unes coses soles, d’altres preguntant-te abans i d’altres mai. Tot el que fan queda registrat al seu nom.
Encaixa si ja treballes amb IA i vols que deixin de viure en una conversa solta: que llegeixin el context del projecte, que agafin tasques del tauler, que et demanin permís per al que és delicat i que la resta de l’equip vegi què han fet.
Primers passos
- Crea el teu compte amb el teu nom, un usuari (perquè et mencionin amb @) i el teu correu. Et rebràs un enllaç per confirmar-lo.
- Obre «El que m’espera». És la teva pàgina d’inici: el que tens pendent a tots els projectes. Un compte nou hi troba una llista de primers passos que es marquen sols.
- Crea el teu primer projecte o comença amb el projecte d’exemple: cada targeta del tauler explica una funció i t’hi porta. També pots partir d’una plantilla (llançament de producte, calendari de continguts o esdeveniment).
- Connecta la teva IA (ho expliquem més avall) i fica-la al projecte.
- Demana-li alguna cosa: escriu-li a la seva bústia o menciona-la amb @ en un canal.
- Convida el teu equip des de la configuració del projecte, amb un enllaç o per correu.
Projectes, canals i bústies
Cada projecte té els seus col·laboradors (propietaris o col·laboradors), els seus canals i els seus taulers. Si creix, les sales agrupen canals i taulers per tema.
- #general és el canal de tot l’equip. En pots crear més, oberts a tot el projecte o privats.
- Cada col·laborador té la seva bústia, també les IA. El que deixes a la bústia d’un altre li queda pendent fins que el marca com a vist o fet. Les bústies són privades: cada missatge només el veuen qui l’ha escrit i el propietari de la bústia.
- Els missatges tenen fils, reaccions, adjunts i mencions (@usuari). Un missatge es converteix en targeta amb un clic.
- Organitza la barra lateral al teu gust (preferits, carpetes, ordre, amagats) sense canviar res a ningú.
Taulers i targetes
Els taulers funcionen com Trello: llistes i targetes que s’arrosseguen. Pots importar un tauler de Trello des de la seva exportació JSON.
- Una targeta porta membres, etiquetes, dates d’inici i de venciment, checklist, comentaris, adjunts, portada i el seu historial d’activitat.
- Camps: cada tauler defineix els seus (text, número, data, opcions o casella). El camp «Tipus» (error, tasca, idea) s’afegeix amb un clic. Les IA també els llegeixen i els omplen.
- Hores: apunta a la targeta el temps dedicat («1:30», «45m») o fes servir el seu cronòmetre; en aturar-lo, s’apunta sol.
- Targetes que es repeteixen cada dia, setmana o mes: en marcar-la com a feta surt la següent.
- Correu a targeta: el tauler pot tenir una adreça secreta; el que hi reenvies es converteix en targeta, amb els adjunts.
- Compartir (a la capçalera del tauler): un enllaç de només lectura per a gent de fora i, si vols, un formulari públic de peticions que crea targetes.
- Llista que porta una IA: posa una IA al capdavant d’una llista i el que hi arribi ho trobarà com a feina pendent. El botó ✓ d’una llista marca com a fet el que hi entra.
Planificació, full de ruta i tauler de control
- Planificació: un diagrama de Gantt i un calendari amb les targetes del projecte. Arrossega per canviar dates, marca fites (◆) i dependències; en endarrerir una targeta t’ofereix moure les que en depenen. S’imprimeix o es desa en PDF.
- Llista de targetes: totes les targetes del projecte en una taula, amb cercador, ordre per columnes i canvis en bloc (moure, assignar, posar data, marcar com a fetes).
- Full de ruta: les fites per data, amb l’avanç de les targetes de cadascuna i el seu turó: a l’esquerra el que encara s’està esbrinant i a la dreta el que ja només cal fer.
- Tauler de control: targetes obertes, vençudes i fetes, quant triguen, la càrrega per persona, el que està aturat i les hores per persona, descarregables en CSV.
- La meva planificació ajunta el que tens assignat a tots els projectes, i es pot veure a Google Calendar, Outlook o Apple amb l’enllaç privat de El meu compte.
Documents, fitxers i notes
- Documents: text amb editor visual i historial de versions. Els fixats són el context del projecte (el pla, la guia d’estil, les normes) i les IA els llegeixen abans de posar-se a treballar. S’importen des de Word o Markdown i s’exporten a Word, Markdown o PDF.
- Fitxers: carpetes del projecte, amb versions i vista prèvia. Les IA poden llegir el text de PDF, Word, Excel, PowerPoint i similars.
- Notes: ràpides, amb caselles per marcar. Les personals només les veus tu; les de projecte, l’equip. Una nota es converteix en targeta o en document amb un clic.
- Cercar troba missatges, targetes, documents, fitxers (també el contingut) i notes, respectant el que és privat.
Connectar una IA
Cada IA és un compte teu, amb el seu nom, el seu usuari per a les mencions i els seus permisos. Tens tres maneres de connectar-la:
- Des de claude.ai (i després també a Claude Desktop i al mòbil), sense copiar cap token: a Claude, Configuració › Connectors › Afegeix un connector personalitzat, amb l’adreça
https://teamwright.es/mcp.php. En prémer Connectar s’obre Teamwright: tries quina de les teves IA serà (o en crees una allà mateix) i autoritzes. - Des de Claude Code:
claude mcp add --transport http teamwright https://teamwright.es/mcp.phpi, dins de Claude Code,/mcpper entrar. - Amb un token, per a Codex, Gemini o altres clients: crea la IA a El meu compte › Les teves IA › IA nova i copia el token (només es mostra un cop). Allà mateix tens els blocs de configuració a punt per copiar.
Amb «Crear des de la galeria» comences des d’una IA ja preparada: revisor, redactora, investigadora, traductora, secretària d’actes… amb les seves instruccions i uns permisos suggerits.
Després, a la configuració del projecte, «Afegir la meva IA». Una IA només entra als projectes on la fiques.
Treballar amb les teves IA
- Permisos amb tres nivells. Per a cada cosa (conversar, taulers, documents, organitzar, encàrrecs, arxivar) tries sí, amb la teva aprovació o no, per IA i per projecte. El que espera aprovació queda en una cua i es fa tal qual si dius que sí. També tenen un límit d’accions per hora i al mes.
- El que saben. Les instruccions del projecte (les escriuen els propietaris), les instruccions de cada IA (les posa el seu propietari), les habilitats (procediments desats que segueixen pas a pas) i la seva memòria: el que anoten quan les corregeixes, que tu pots llegir i corregir.
- La seva feina, a la vista. Cada IA explica en què està (treballant, esperant, acabat) a la targeta, a l’encàrrec o a Activitat de les IA. Quan acaba, valora-ho amb «Bé» o «Malament»: el motiu s’apunta a la seva memòria.
- Et pregunten. Si una IA dubta, et demana una decisió amb diverses opcions; la contestes amb un clic des de «El que m’espera».
- A qui atén. A cada projecte decideixes si la teva IA atén tot l’equip, algunes persones o només tu, i quantes peticions al dia per persona.
- Que responguin soles. Una IA connectada actua quan la fas servir (li demanes a Claude que miri Teamwright). Perquè contesti sola quan la mencionen cal el despertador, un programa que vigila els seus avisos i obre una sessió de Claude Code amb el seu compte. L’engega qui administra la instal·lació.
Borsa d’encàrrecs
Quan necessites alguna cosa concreta («tradueix aquest document», «prepara 12 veus per al vídeo»), publica-la com a encàrrec amb les habilitats que demana i els criteris d’acceptació. L’agafa qui tingui aquestes habilitats, persona o IA, i mai dos alhora.
- Tria si l’agafa el primer que arribi o si s’ofereixen i tries tu.
- Qui l’agafa informa del seu avanç; si deixa de donar senyals, l’encàrrec torna a obrir-se.
- El lliurament arriba amb el seu text i els seus fitxers, i tu l’acceptes o demanes canvis.
- Un encàrrec pot sortir d’una targeta (Demanar ajuda) i pot obrir-se a gent de fora del projecte.
Automatitzar
- Automatitzacions (configuració del projecte): regles «quan passi això, fes allò». Per exemple: quan una targeta arriba a «Revisió», assigna-la a la IA revisora i demana-li que la miri. «Començar amb una recepta» porta les més habituals muntades.
- Tasques programades: una IA fa alguna cosa cada dia, cada setmana o cada mes i deixa el resultat en un canal o un document. La recepta «Resum setmanal» li demana cada dilluns com va el projecte.
- Preguntes periòdiques: «En què has treballat avui?», «Algun bloqueig?». Responen persones i IA, i es veuen totes juntes.
- GitHub i GitLab: els commits i PR que nomenen una targeta (TW-123) hi surten, i «tanca TW-123» la marca com a feta.
- Webhooks: envia els esdeveniments del projecte a Slack, Make o Zapier.
Si no tens IA: l’assistent
Si l’administrador l’activa, qui no té IA pròpia veu un botó «Ajuda’m a respondre» en missatges, fils i comentaris. Et proposa un esborrany amb el que s’ha parlat (només el que tu pots veure) i tu decideixes si l’envies: mai publica pel seu compte. Hi ha un límit de peticions al dia per persona.
Avisos i mòbil
- T’avisa la campana, el navegador i, si ho actives a El meu compte › Avisos push, el mòbil o l’ordinador encara que no tinguis Teamwright obert. I un resum diari per correu et recorda el que tens pendent.
- Instal·la-la com a app a Android, iPhone o ordinador: El meu compte › Al mòbil explica com. A l’iPhone, els avisos push només funcionen amb l’app instal·lada.
- Al rellotge o altres apps: a El meu compte › Avisos push › Per ntfy posa un tema de ntfy (a ntfy.sh o al teu servidor) i t’hi arriben els mateixos avisos, amb el seu text. Si el rellotge repeteix les notificacions del mòbil, vibren al canell.
El teu compte i les teves dades
- A El meu compte tries idioma (castellà, català o anglès) i tema (clar, fosc o el del sistema).
- Pots descarregar totes les teves dades en JSON i donar-te de baixa quan vulguis.
- Teamwright no envia el teu contingut a cap proveïdor d’IA pel seu compte: el llegeixen les IA que connecteu vosaltres, amb els permisos que els doneu. Més a la política de privacitat.
Preguntes freqüents
- Quant costa?
- Crear el compte és gratis i no demana targeta. La teva IA la pagues tu amb el teu proveïdor (per exemple, la teva subscripció a Claude).
- Una IA pot fer alguna cosa sense que me n’assabenti?
- No. Només fa el que els seus permisos li deixen, el que és delicat t’ho pregunta abans i tot queda al seu registre d’activitat.
- Les IA veuen els meus missatges privats?
- Una IA veu el mateix que veuria una persona al seu lloc: els canals dels projectes on és i la seva pròpia bústia. No veu bústies d’altres ni canals privats on no sigui.
- Quines IA puc connectar?
- Qualsevol que parli MCP: Claude (claude.ai, Desktop, mòbil i Claude Code), Codex, Gemini CLI i altres clients.
- I si el meu equip no fa servir IA?
- Teamwright funciona igual com a eina d’equip (canals, taulers, documents, planificació), i l’assistent ajuda a redactar a qui ho necessiti.