BPM Together — powered by AI
=================================

The BPM cycle applied to a REAL process from your own work. Everything in one
folder -- including Python (the python\ folder). You install NOTHING.

HOW TO USE IT
  1. Extract the .zip (right-click > Extract All). Actually extract it: do not
     run it from inside the zip.
  2. Create your free account at projectadm.com and generate a token
     (your profile > API Keys).
  3. Double-click Iniciar.bat (Windows) or Iniciar.command (Mac). It asks for
     the token -- and THAT IS ALL. Then it creates your BOARD in ProjectAdm,
     saves everything in the .env and opens the course MENU.
  4. Follow the steps from the menu, reading the lesson for each one.

  Never share the .env: it holds your token.

THE STEPS
  01_configurar_board_processo.py  creates the 5 lists of the BPM cycle
  02_modelar_as_is.py              models the current process (AS-IS)
  03_analisar_processo.py          points out bottlenecks and opportunities
  04_desenhar_to_be.py             designs the future process (TO-BE)
  05_indicadores.py                defines the indicators (Phase 5)

  The name of the process you are going to manage is asked for in step 01 --
  you do not need to edit the .env by hand.

FOLLOW YOUR PROGRESS
  verificar_processo.py   at any time: shows where you are in the BPM cycle,
                          the 4 measures (M1..M4) and the next step.
  apresentacao_final.py   at the end: consolidates everything into
                          apresentacao_dados.txt plus a Lessons Learned
                          template for you to fill in.
  Every finished task is recorded in the "Completed (course)" list on your board.

THE METHOD
  At each step the script hands you the prompt ready. You paste it into the AI
  you already use in your browser (ChatGPT, Gemini, Claude...), it answers, you
  review it and the script takes the result to your board. The AI proposes,
  YOU decide.

  BEFORE YOU SEND, LOOK AT THE END OF THE PROMPT
  Some prompts end with a passage between «...». That is NOT content: it is a
  reminder of what YOU write there (your process). Replace that passage -- the
  « » quotes go with it -- and only then send the message; the rest of the
  prompt stays the same. The step itself warns you when one is still unfilled.
  From step 3 onwards the prompt already comes filled in with your process.

RUNNING IT TWICE DOES NOT DUPLICATE
  If you redo a step -- and you will, it is part of the method -- the activities
  are RECOGNIZED by name and updated in place, even if the AI rewrote "Check
  compliance" as "Check THE compliance". No repeated cards on the board.

DIAGRAM (bpmn.io)
  Steps 02 and 04 generate, in the _saida/ folder, a .bpmn file and a .mmd one.
  Open demo.bpmn.io in your browser (nothing to install, no account) and use
  'Open file' to open the .bpmn -- then refine the drawing. The .mmd is a quick
  preview.
