Common situations

#I have a new idea

Add one line to inbox.md, then commit and push the hub. If it cannot wait, press New, and describe it.

#I found a bug

Press New, and describe what happens and what should happen. intake makes a task. If it blocks your work, build it next.

#I do not like the pull request

Write your comments on the pull request, then press Triage. It sets the task to ready, with your changes under ## Rework. Press Build, then Review.

If the idea is wrong and not only the code, close the pull request. Then change the task, and discard it if you need to.

#A build stopped with a question

The card is in Draft with blocked. Press Probe, and answer. Then press Build. The build continues on the same branch.

#The review is wrong about something

Reply on the comment on the pull request, and say why. For a finding that you accept for good, add it under accepted: in .flow/review.yml in the app. A critical or major finding turns flow/review red, and GitHub does not stop you from merging. You decide.

#I do not need this task any more

Discard it. Change status: in the task file to discarded, then commit and push the hub. Close its pull request, if it has one. The file stays as a record.

cd ~/code/fieldnote/fieldnote-hub
git add tasks && git commit -m "task: T-012 discarded" && git push

#I changed my mind about a decision

Change the file in context/ yourself, then commit and push the hub. You can do this at any time. If tasks that are not done depend on the old decision, open each one, and press Probe.

#The direction changed

Go back to 6. Explore. Stop building for now. Discard the tasks that no longer fit, and write the new direction in context/positioning.md. This is normal. It costs less the earlier it happens.

#I need to change a task that is ready

Change the file, then commit and push the hub. To let the agent check it, press Probe. You can only press Probe on a task in Draft, so first set status: to draft.

#The task needs something on the server

The factory does not deploy. Before you merge, read ## Deployment requirements in the pull request. It lists each variable, secret, migration and command.

#I closed the Herdr window

Sessions keep running, because they run in hc. Open Herdr again, and find them in the Sessions tab.

#I want to add a frontend app to a monorepo

Add it as a task, so that it goes through the checks. See Monorepos.

#I work on another computer

Do 1. Set up your computer. Clone the hub and the app, as repos/fieldnote in the hub. Run npm ci and npx flow install --ci in the app. The hub holds all the work, so nothing is lost.