Version 0.54.0 
Toolsuite for the situational picture at portfolio and solution level: flow metrics from Jira, governance registers, Value-Stream-Conference preparation, forecasts and AI-drafted narration — running locally on your own machine.
Documentation: https://jaegerfeld.github.io/situation-report/
Memoranda (Denkschriften): English · Deutsch
Architecture: https://jaegerfeld.github.io/situation-report/architecture/
Roadmap: https://github.com/users/Jaegerfeld/projects/1
Changelog: CHANGELOG.md
The software is the tool; the memoranda (Denkschriften) are its conceptual foundation. Six memoranda examine how large IT portfolios and solutions are led: with an honest situational picture, trained staffs, and — most recently — AI as a staff member. Written for decision-makers, no military, agile or AI background required. Freely available in English and German, each with the single most important sentence up front.
→ Read the memoranda (English) · Die Denkschriften lesen (Deutsch)
This project was created as an exploration of the possibilities of AI-driven development. More than 98% of the code is written by AI — currently using Claude Code (Anthropic).
The primary goal is to study the challenges, solutions, and risks that arise when AI authors production software. At some point this may transition to a regular project with more human authorship — but not yet.
The software is intended to be genuinely useful and will continue to evolve. Feel free to use it and share feedback.
Don't be surprised if something feels a little off — even the quirks were produced by Claude.
— Robert "Jaegerfeld" Seebauer
| Module | Description | Status |
|---|---|---|
launcher |
Central entry point – launches all modules | available |
transform_data |
Transform raw Jira data into stage-time metrics | available |
build_reports |
Generate flow metrics and reports | available |
portfolio |
Aggregated Large-Solution & Portfolio reports across several ARTs — governance registers, conference pre-read, delta briefing, one-pager | available (Alpha) |
helper |
Helper tools (JSON Merger) | available (Alpha) |
testdata_generator |
Generate synthetic test data — realism knobs, continuation of a data set, learning from real transitions | available (Beta) |
get_data |
Retrieve data from Jira — REST or export validation, person data minimised at the source | available (Alpha) |
sources |
Pluggable external metric sources (SLO, DORA, quality) | available (Alpha) |
llm |
Pluggable AI narration (local Ollama, Claude API, prompt export, mock) | available (Alpha) |
simulate |
Simulations and forecasting models | available (Alpha) |
harmonisation |
Harmonisation score per end-to-end process — decision matrix for the board | available (Alpha) |
git clone https://github.com/Jaegerfeld/situation-report.git
cd situation-report
python -m venv .venv
.venv\Scripts\activate
pip install -e .Start the launcher GUI:
- Windows: double-click
SituationReport.bat - macOS: double-click
SituationReport.command - Linux: run
./SituationReport.sh - Terminal (all platforms):
python -m launcher
The launcher opens a central window from which all available modules can be started.
BSD-3-Clause — see LICENSE