From bfbb0ec713e0912840c758fafcf45fd8cfd0657e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Francisco=20Ign=C3=A1cio=20Fontoura=20Solla?= Date: Fri, 31 Jul 2026 13:16:22 -0300 Subject: [PATCH] style: prettier-format public-release docs Fixes format job failure on stage/main after the public-tip sanitize commit. --- docs/AGENT-OPS.md | 8 +-- docs/CUSTOMER.md | 52 +++++++++---------- ...sessao-observada-coordenador-cheatsheet.md | 24 ++++----- 3 files changed, 42 insertions(+), 42 deletions(-) diff --git a/docs/AGENT-OPS.md b/docs/AGENT-OPS.md index 762978fc..0c4c874b 100644 --- a/docs/AGENT-OPS.md +++ b/docs/AGENT-OPS.md @@ -97,9 +97,9 @@ Supervisor **remoto** que mantém até 5 Cursor Cloud Agents rodando `work-issue O repo GitHub é **público** e proprietário (All Rights Reserved). Discovery de campo com áudio, transcrição bruta, nomes reais, deltas operacionais de voto e planilhas de projeção **não** sobem no tip público. -| Quem | Onde grava | O que faz | -|------|------------|-----------| -| **Agente local** | `/private/` (gitignored; só `private/README.md` versionado) | Lê/escreve notas sensíveis aí. Publica em `docs/` só uma **versão limpa** (JTBD/insights sem PII operacional). Nunca `git add` de áudio/transcribe/sheets/notas verbatim. | -| **Agente cloud** (Cursor Cloud, Devin, etc.) | Clone **sem** `/private/` | Baseia-se em `docs/CUSTOMER.md` e planos públicos limpos. Se o entregável for sensível, **informa no chat** e **não commitá** — o humano salva em `/private/` no checkout local. | +| Quem | Onde grava | O que faz | +| -------------------------------------------- | ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **Agente local** | `/private/` (gitignored; só `private/README.md` versionado) | Lê/escreve notas sensíveis aí. Publica em `docs/` só uma **versão limpa** (JTBD/insights sem PII operacional). Nunca `git add` de áudio/transcribe/sheets/notas verbatim. | +| **Agente cloud** (Cursor Cloud, Devin, etc.) | Clone **sem** `/private/` | Baseia-se em `docs/CUSTOMER.md` e planos públicos limpos. Se o entregável for sensível, **informa no chat** e **não commitá** — o humano salva em `/private/` no checkout local. | Regra de ouro: o que um cloud agent não deveria ver no GitHub público também não deve ser commitado por um agente local. diff --git a/docs/CUSTOMER.md b/docs/CUSTOMER.md index da082217..f74c74b5 100644 --- a/docs/CUSTOMER.md +++ b/docs/CUSTOMER.md @@ -22,37 +22,37 @@ Quando preciso coordenar uma campanha de deputado federal pelo estado da Bahia ## Job Dimensions -| Dimension | Description | Where the app underdelivers today | -| ---------- | ----------- | --------------------------------- | +| Dimension | Description | Where the app underdelivers today | +| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Functional | See municipalities (predefined territories), base, declared-vs-estimated votes, and agenda in one place; record updates and decide the next action | Entity-first screens invert the **Action → Place → Who** model; discovery requires scroll; confirmations invisible; fragmented forms. Hit: filtered “no advisor” lists × prior-cycle votes. Jargon still blocks. | -| Emotional | Feel in control and trust that the picture is current | **Worst today.** Competence anxiety (“I can’t see / handle it”), not only stale data. Without action-first flows, Little Hire does not start. | -| Social | Be seen as serious, aligned coordination | Real work still “wins” on WhatsApp; tool users can look bureaucratic while informal channels set the pace | +| Emotional | Feel in control and trust that the picture is current | **Worst today.** Competence anxiety (“I can’t see / handle it”), not only stale data. Without action-first flows, Little Hire does not start. | +| Social | Be seen as serious, aligned coordination | Real work still “wins” on WhatsApp; tool users can look bureaucratic while informal channels set the pace | ## Competing Alternatives -| Alternative | Why hired today | Weakness | -| ----------- | --------------- | -------- | -| WhatsApp groups / 1:1 | Fast, everyone is already there | Fragments; no analysis; useful history disappears | -| Spreadsheets (projection maps) | Flexible; one advisor’s “source of truth” | Divergent versions; weak on phone | -| Notebook / memory / phone calls | Zero tool friction | Doesn’t scale; doesn’t share | -| Other campaign platforms (past attempts) | Promise of a single system | Team stops updating → stale data → abandonment | -| Non-consumption | Avoids another login | Burns the 45-day window | +| Alternative | Why hired today | Weakness | +| ---------------------------------------- | ----------------------------------------- | ------------------------------------------------- | +| WhatsApp groups / 1:1 | Fast, everyone is already there | Fragments; no analysis; useful history disappears | +| Spreadsheets (projection maps) | Flexible; one advisor’s “source of truth” | Divergent versions; weak on phone | +| Notebook / memory / phone calls | Zero tool friction | Doesn’t scale; doesn’t share | +| Other campaign platforms (past attempts) | Promise of a single system | Team stops updating → stale data → abandonment | +| Non-consumption | Avoids another login | Burns the 45-day window | ## Big Hire vs Little Hire -| Moment | What it is here | Status / intervention | -| ------ | --------------- | --------------------- | -| Big Hire | First login, trust the system enough to start | Mitigated offline: in-person onboarding; seed initial data when needed | +| Moment | What it is here | Status / intervention | +| ----------- | ------------------------------------------------------ | --------------------------------------------------------------------------------------- | +| Big Hire | First login, trust the system enough to start | Mitigated offline: in-person onboarding; seed initial data when needed | | Little Hire | Come back and update so the shared picture stays alive | **Primary leak.** Past tools died here. Reduce emotional cost of “updating again today” | ## Forces of Progress -| Force | Notes | -| ----- | ----- | -| Push | Fragmentation; statewide scope; 45-day crunch; cannot follow dynamics by hand | -| Pull | One operational picture; smarter targeting; instrument the team can update; territory dossier before agenda | -| Habit | WhatsApp + spreadsheet as default — “Zap is the field”; projection sheet is the morning ritual | -| Anxiety | “If others don’t update, I’m wasting time”; competence anxiety; LGPD / real-data hold; “legs” constraint | +| Force | Notes | +| ------- | ----------------------------------------------------------------------------------------------------------- | +| Push | Fragmentation; statewide scope; 45-day crunch; cannot follow dynamics by hand | +| Pull | One operational picture; smarter targeting; instrument the team can update; territory dossier before agenda | +| Habit | WhatsApp + spreadsheet as default — “Zap is the field”; projection sheet is the morning ritual | +| Anxiety | “If others don’t update, I’m wasting time”; competence anxiety; LGPD / real-data hold; “legs” constraint | ## Opportunity Solution Tree (sanitized) @@ -75,12 +75,12 @@ Outcome: weekly Little Hire ## Leap-of-Faith Assumptions -| Assumption | Type | Cheap test | Success if | -| ---------- | ---- | ---------- | ---------- | -| Seeded picture + onboarding → returns within 7 days | Desirability / Little Hire | Count logins + ≥1 real update after action-first redesign | ≥1 spontaneous update in 7 days | -| Action queues answer “where do I start?” | Usability | Filtered “no advisor” × prior-cycle votes | Finds queue/action without help | -| Entity-first “edit where you see” is discoverable | Usability | Observed: editable cells not discovered in free exploration | Opens vote adjust without demo — **FAILED**; pivot O9 | -| Inline glossary / plain language cuts confusion | Usability | Field jargon needed live translation | Zero “what is…?” in 2nd session after copy | +| Assumption | Type | Cheap test | Success if | +| --------------------------------------------------- | -------------------------- | ----------------------------------------------------------- | ----------------------------------------------------- | +| Seeded picture + onboarding → returns within 7 days | Desirability / Little Hire | Count logins + ≥1 real update after action-first redesign | ≥1 spontaneous update in 7 days | +| Action queues answer “where do I start?” | Usability | Filtered “no advisor” × prior-cycle votes | Finds queue/action without help | +| Entity-first “edit where you see” is discoverable | Usability | Observed: editable cells not discovered in free exploration | Opens vote adjust without demo — **FAILED**; pivot O9 | +| Inline glossary / plain language cuts confusion | Usability | Field jargon needed live translation | Zero “what is…?” in 2nd session after copy | ## Discovery method (no raw evidence here) diff --git a/docs/plans/sessao-observada-coordenador-cheatsheet.md b/docs/plans/sessao-observada-coordenador-cheatsheet.md index b1fbd04d..b8e468f4 100644 --- a/docs/plans/sessao-observada-coordenador-cheatsheet.md +++ b/docs/plans/sessao-observada-coordenador-cheatsheet.md @@ -4,26 +4,26 @@ One-page notary sheet for observed-use sessions. Print or keep on tablet. One line per relevant event. -**Date:** ____/____/2026 · **Start:** __:__ · **End:** __:__ -**Facilitator:** ________ · **Notary:** ________ · **Recording:** [ ] screen+audio OK +**Date:** \_**\_/\_\_**/2026 · **Start:** **:** · **End:** **:** +**Facilitator:** **\_\_\_\_** · **Notary:** **\_\_\_\_** · **Recording:** [ ] screen+audio OK ## Quick codes -| Symbol | Meaning | -| ------ | ------- | -| `?` | hesitated / asked what something is | -| `✗` | wrong path / backed out | -| `✓` | found alone | -| `Z` | talked about going back to WhatsApp | -| `P` | talked about going back to spreadsheet | -| `J` | jargon (note the word) | -| `→` | navigated to | +| Symbol | Meaning | +| ------ | -------------------------------------- | +| `?` | hesitated / asked what something is | +| `✗` | wrong path / backed out | +| `✓` | found alone | +| `Z` | talked about going back to WhatsApp | +| `P` | talked about going back to spreadsheet | +| `J` | jargon (note the word) | +| `→` | navigated to | **Screens (generic):** Home · Map · Municipality list · Municipality detail · Dossier · Leaderships · Suggestions · Territories · Phone ## Block 1 — Free exploration (10–12′) -First click: ________ · Within ≤2′ reached municipality/map? [ ] yes [ ] no +First click: **\_\_\_\_** · Within ≤2′ reached municipality/map? [ ] yes [ ] no Notes: …