By name: story-state description: > Manage the state file for an active investigation. Activate when the user asks to start a new investigation, update what's known, record a source or finding, log a WOO request, or get a summary of where an investigation stands. Reads and writes state.md in the current investigation directory. version: 0.1.0
Story State Manager
Each investigation lives in its own directory. The state file is state.md.
State file format
# [Investigation Title]
**Status:** [Verkenning / Actief / Publicatie / Gepubliceerd / On hold]
**Gestart:** YYYY-MM-DD
**Laatste update:** YYYY-MM-DD
**Publicatiedeadline:** YYYY-MM-DD of "n.v.t."
---
## Centrale vraag
[The core investigative question in one sentence.]
## Wat we weten (bevestigd)
- [Fact] — bron: [source], datum: [date]
## Wat we vermoeden (onbevestigd)
- [Hypothesis] — aanwijzing: [what suggests this]
## Openstaande vragen
- [ ] [Question]
## Bronnen geraadpleegd
| Bron | Wat gevonden | Datum | Notitie |
|---|---|---|---|
| CBS tabel 12345NED | Asielaanvragen per gemeente 2019-2024 | 2024-02-10 | Gedownload als CSV |
## WOO verzoeken
| Bestuursorgaan | Onderwerp | Verzonden | Deadline | Status |
|---|---|---|---|---|
| COA | Incidentenrapportages AZC Utrecht | 2024-02-15 | 2024-03-15 | Wachtend |
## Gesproken bronnen
- [Name/role] — [date] — [key point, can be kept vague for source protection]
## Tijdlijn
- YYYY-MM-DD: [Event]
## Bestanden
- [filename] — [what it contains]
## Notities
[Freeform notes, dead ends, context]
Operations
Create new state file
When /journalist:new-investigation is called or user says "start new investigation":
- Ask for: title, central question, publication deadline
- Create directory:
~/investigations/[slug]/ - Create
state.mdusing the template above - Offer to immediately run a first source lookup
Update state
When user says "add to state", "log this finding", "record source", etc.:
- Read current
state.md - Determine which section to update
- Append entry with today's date
- Write back
WOO tracking
When a WOO request is drafted and user confirms sending:
- Add row to "WOO verzoeken" table
- Calculate deadline (sent date + 28 days)
- Note: "Herinnering instellen voor [deadline - 3 days]"
Status summary
When user asks "where are we" / "what's the status":
- Read
state.md - Report: central question, # confirmed facts, # open questions, pending WOO requests with deadlines, suggested next action
Suggested next action logic
- If no sources in "Bronnen geraadpleegd" → suggest running CBS/DUO lookup
- If open questions > confirmed facts → suggest prioritizing source lookup or WOO
- If WOO deadline passed with no response → suggest sending reminder letter
- If all WOO received and questions answered → suggest drafting story outline