smlflg commited on
Commit
2ad02e3
·
verified ·
1 Parent(s): 7355ee8

Initial public upload from Projekte/ProjectIntakeTower

Browse files
.codex/config.toml ADDED
@@ -0,0 +1,31 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Coding MCPs: project-local registration (2026-09-07).
2
+
3
+ [mcp_servers.serena]
4
+ command = "/home/smlflg/.local/share/coding-mcp/serena/.venv/bin/serena"
5
+ args = ["start-mcp-server", "--context=codex", "--project", "/home/smlflg/Projekte/ProjectIntakeTower", "--enable-web-dashboard", "false", "--open-web-dashboard", "false", "--enable-gui-log-window", "false"]
6
+ cwd = "/home/smlflg/Projekte/ProjectIntakeTower"
7
+ enabled = true
8
+ startup_timeout_sec = 120
9
+ tool_timeout_sec = 180
10
+
11
+ [mcp_servers.serena.env]
12
+ "SERENA_HOME" = "/home/smlflg/.local/share/coding-mcp/serena/state"
13
+
14
+ [mcp_servers.gitnexus]
15
+ command = "/home/smlflg/.nvm/versions/node/v24.13.0/bin/node"
16
+ args = ["/home/smlflg/.local/share/coding-mcp/gitnexus/node_modules/gitnexus/dist/cli/index.js", "mcp"]
17
+ cwd = "/home/smlflg/Projekte/ProjectIntakeTower"
18
+ enabled = true
19
+ startup_timeout_sec = 120
20
+ tool_timeout_sec = 180
21
+
22
+ [mcp_servers.gitnexus.env]
23
+ "GITNEXUS_HOME" = "/home/smlflg/.local/share/coding-mcp/gitnexus/runtime"
24
+
25
+ [mcp_servers.context7]
26
+ command = "/home/smlflg/.nvm/versions/node/v24.13.0/bin/node"
27
+ args = ["/home/smlflg/.local/share/coding-mcp/context7/node_modules/@upstash/context7-mcp/dist/index.js"]
28
+ cwd = "/home/smlflg/Projekte/ProjectIntakeTower"
29
+ enabled = true
30
+ startup_timeout_sec = 120
31
+ tool_timeout_sec = 180
.hermes/plans/2026-05-04_194718-project-intake-audit-briefings.md ADDED
@@ -0,0 +1,141 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Plan — ProjectIntakeTower Audit Briefings Setup
2
+
3
+ ## Goal
4
+
5
+ Create the requested ProjectIntakeTower intake structure and the first read-only audit briefing for `smlfg/KommandoZentrale`, without touching the source repo and without making any consolidation decision.
6
+
7
+ Requested target root:
8
+
9
+ `/home/smlflg/Projekte/ProjectIntakeTower`
10
+
11
+ ## Current Context / Assumptions
12
+
13
+ - The user supplied a shell-style setup snippet that would create:
14
+ - `briefings/`
15
+ - `audits/kommandozentrale/`
16
+ - `audits/zentrale/`
17
+ - `audits/megaharness/`
18
+ - `briefings/01_audit_kommandozentrale.md`
19
+ - This plan mode turn must not execute that setup yet.
20
+ - Only this markdown plan is written during plan mode.
21
+ - The actual audit described by the briefing is read-only against the source repo.
22
+ - The only future audit output writes allowed by the briefing are under:
23
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/`
24
+ - Luis owns final consolidation decisions. Any decision-shaped conclusion must be marked `NEEDS_HUMAN`.
25
+
26
+ ## Proposed Approach
27
+
28
+ 1. After plan approval, create the ProjectIntakeTower directory structure exactly as requested.
29
+ 2. Write the KommandoZentrale audit briefing file exactly at the requested path.
30
+ 3. Treat the briefing as an execution contract for a later bounded read-only audit lane/agent.
31
+ 4. Keep source repo inspection read-only and record source `git status --short` before and after the audit.
32
+ 5. Produce exactly the four requested audit artifacts for KommandoZentrale.
33
+
34
+ ## Step-by-Step Plan
35
+
36
+ ### 1. Create target directories
37
+
38
+ Create these directories if missing:
39
+
40
+ - `/home/smlflg/Projekte/ProjectIntakeTower/briefings/`
41
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/`
42
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/zentrale/`
43
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/megaharness/`
44
+
45
+ Verification:
46
+
47
+ - Check that each directory exists.
48
+
49
+ ### 2. Write the KommandoZentrale audit briefing
50
+
51
+ Create or replace:
52
+
53
+ `/home/smlflg/Projekte/ProjectIntakeTower/briefings/01_audit_kommandozentrale.md`
54
+
55
+ Content should preserve the user's supplied audit contract, including:
56
+
57
+ - Mission: audit public/local repo `smlfg/KommandoZentrale`.
58
+ - Read-only source repo rules.
59
+ - No branches, commits, pushes, PRs, refactors, or source modifications.
60
+ - Only allowed audit writes under:
61
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/`
62
+ - Context files to read if available:
63
+ - `/home/smlflg/Projekte/megaHarness/BRIEFING_LUIS.md`
64
+ - `/home/smlflg/Projekte/megaHarness/Höhlengleichnis.md`
65
+ - Allowed investigation commands/tools.
66
+ - Required source `git status --short` before and after.
67
+ - Required output files and exact structure for `AGENT_FINDINGS.md`.
68
+
69
+ Verification:
70
+
71
+ - Read back the file path and confirm the expected title exists:
72
+ - `# READY — READ_ONLY_AUDIT — KommandoZentrale`
73
+
74
+ ### 3. Later audit execution contract
75
+
76
+ When the audit is executed, the auditor should produce exactly these files:
77
+
78
+ 1. `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/AGENT_FINDINGS.md`
79
+ 2. `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/ARCHITECTURE_MAP.md`
80
+ 3. `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/RISK_REGISTER.md`
81
+ 4. `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/NEXT_ISSUES.md`
82
+
83
+ The auditor must not write elsewhere.
84
+
85
+ ### 4. Recommended audit execution shape
86
+
87
+ Use a bounded read-only audit worker/lane rather than a broad autonomous implementation agent.
88
+
89
+ Minimum contract:
90
+
91
+ - Objective: compact factual repo intake for Samuel and Luis.
92
+ - Source repo: `smlfg/KommandoZentrale`, local path if available.
93
+ - Mode: `READ_ONLY_AUDIT`.
94
+ - Allowed source actions: inspect files, docs, configs, tests, git status/log.
95
+ - Forbidden source actions: modify, branch, commit, push, PR, refactor.
96
+ - Output directory: `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/`.
97
+ - Stop condition: any consolidation verdict, archive decision, or architecture-anchor decision becomes `NEEDS_HUMAN`.
98
+
99
+ ## Files Likely To Change After Approval
100
+
101
+ Only these setup files/directories should be created or changed:
102
+
103
+ - `/home/smlflg/Projekte/ProjectIntakeTower/briefings/`
104
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/`
105
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/zentrale/`
106
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/megaharness/`
107
+ - `/home/smlflg/Projekte/ProjectIntakeTower/briefings/01_audit_kommandozentrale.md`
108
+
109
+ During the later audit, only these files should be written:
110
+
111
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/AGENT_FINDINGS.md`
112
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/ARCHITECTURE_MAP.md`
113
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/RISK_REGISTER.md`
114
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/NEXT_ISSUES.md`
115
+
116
+ ## Tests / Validation
117
+
118
+ After setup:
119
+
120
+ 1. Verify all target directories exist.
121
+ 2. Verify `01_audit_kommandozentrale.md` exists.
122
+ 3. Verify the briefing file contains:
123
+ - `READY — READ_ONLY_AUDIT — KommandoZentrale`
124
+ - `READ ONLY for the source repo`
125
+ - all four required output paths.
126
+
127
+ After later audit:
128
+
129
+ 1. Verify source repo `git status --short` was recorded before and after.
130
+ 2. Verify all four audit output files exist.
131
+ 3. Verify no source repo files changed.
132
+ 4. Verify decision-shaped items are in `NEEDS_HUMAN`, not recommendations.
133
+ 5. Verify artifact content is compact and factual, without raw log dumps.
134
+
135
+ ## Risks, Tradeoffs, Open Questions
136
+
137
+ - Risk: The local source repo path for `KommandoZentrale` may not exist. Mitigation: auditor should use local path if available or remote/public repo if accessible, and record which was used.
138
+ - Risk: Context files in `/home/smlflg/Projekte/megaHarness/` may be missing. Mitigation: briefing explicitly says continue and do not block.
139
+ - Risk: Audit drifts into consolidation recommendation. Mitigation: stop that reasoning and mark as `NEEDS_HUMAN`.
140
+ - Risk: An audit agent might write outside the allowed output directory. Mitigation: use a strict lane/worker contract and verify output paths after completion.
141
+ - Open question: Whether Samuel wants the setup file written exactly as supplied or wants additional briefing files for `zentrale` and `megaharness` next. This first plan only covers the supplied KommandoZentrale briefing.
00_OPERATOR_CHECKLIST.md ADDED
@@ -0,0 +1,63 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # ProjectIntakeTower Operator Checklist
2
+
3
+ Status: prepared for read-only audit night
4
+ Target root: `/home/smlflg/Projekte/ProjectIntakeTower`
5
+ Primary rule: generate audit facts, not architecture verdicts.
6
+
7
+ ## 1. Preflight
8
+
9
+ - [ ] Confirm `briefings/` contains all four READY prompts.
10
+ - [ ] Confirm `audits/` contains exactly these repo folders:
11
+ - `kommandozentrale/`
12
+ - `zentrale/`
13
+ - `megaharness/`
14
+ - [ ] Do not use or modify `/home/smlflg/Projekte/project-intake-tower/artifacts/`.
15
+ - [ ] Treat all dirty repo state as pre-existing unless an audit proves otherwise.
16
+ - [ ] Do not create branches, commits, pushes, PRs, labels, or GitHub issues.
17
+
18
+ ## 2. Start Order
19
+
20
+ - [ ] Start Session 1 with `briefings/01_audit_kommandozentrale.md`.
21
+ - [ ] Start Session 2 with `briefings/02_audit_zentrale.md`.
22
+ - [ ] Start Session 3 with `briefings/03_audit_megaharness.md`.
23
+ - [ ] Wait until the three repo audits are done or clearly partial.
24
+ - [ ] Start Session 4 with `briefings/04_aggregator.md`.
25
+
26
+ ## 3. Required Audit Outputs
27
+
28
+ Each repo folder must contain exactly these four human-readable Markdown files:
29
+
30
+ - [ ] `AGENT_FINDINGS.md`
31
+ - [ ] `ARCHITECTURE_MAP.md`
32
+ - [ ] `RISK_REGISTER.md`
33
+ - [ ] `NEXT_ISSUES.md`
34
+
35
+ The aggregator must write:
36
+
37
+ - [ ] `audits/TOWER_HEALTH_OVERVIEW.md`
38
+
39
+ ## 4. Stop Conditions
40
+
41
+ Stop the active session and write `NEEDS_HUMAN` when any of these happen:
42
+
43
+ - [ ] The session needs to edit source code to continue.
44
+ - [ ] The session wants to pick an architecture anchor.
45
+ - [ ] The session wants to archive, fuse, or deprecate a repo.
46
+ - [ ] The session finds secrets or credentials.
47
+ - [ ] The session needs missing context outside the allowed scope.
48
+ - [ ] The session starts planning PRs, branches, labels, or implementation work.
49
+
50
+ ## 5. Morning Verification
51
+
52
+ - [ ] `audits/kommandozentrale/` has the four required files.
53
+ - [ ] `audits/zentrale/` has the four required files.
54
+ - [ ] `audits/megaharness/` has the four required files.
55
+ - [ ] `audits/TOWER_HEALTH_OVERVIEW.md` exists.
56
+ - [ ] The overview has no anchor verdict and no archive/fusion decision.
57
+ - [ ] `git status --short` in `KomandoZentral` is unchanged from preflight.
58
+ - [ ] `git status --short` in `Zentrale` has no new changes caused by this audit.
59
+ - [ ] `git status --short` in `megaHarness` has no new changes caused by this audit.
60
+
61
+ ## 6. Success Definition
62
+
63
+ The night is successful if Samuel can read the overview first, then scan each repo audit in under 5 minutes, and Luis receives factual inputs without losing ownership of the consolidation decision.
NIGHT_RUN_CHECKLIST.md ADDED
@@ -0,0 +1,69 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # ProjectIntakeTower Night Run Checklist
2
+
3
+ Date: 2026-05-04
4
+ Goal: convert expiring Codex quota into useful, local, read-only audit artifacts without creating code drift, branches, PRs, or conflicts with Luis' consolidation assignment.
5
+
6
+ ## Hard Rules
7
+
8
+ - Do not edit existing repo worktrees under `/home/smlflg/Projekte/KomandoZentral`, `/home/smlflg/Projekte/Zentrale`, or `/home/smlflg/Projekte/megaHarness`.
9
+ - Prefer fresh source clones under `/tmp/project-intake-tower-src-2026-05-04/` when starting manual sessions.
10
+ - If an existing local worktree is inspected, record its `git status --short` and treat dirty state as pre-existing context.
11
+ - Write durable outputs only under `/home/smlflg/Projekte/ProjectIntakeTower/`.
12
+ - Do not create branches, commits, pushes, issues, labels, or pull requests.
13
+ - Do not make an anchor-repo recommendation, archive/keep verdict, or target architecture decision. That stays with Luis.
14
+ - If an agent hits uncertainty that would require an architecture or product decision, mark `NEEDS_HUMAN` and continue documenting facts.
15
+
16
+ ## Source Snapshot
17
+
18
+ | Repo | Local Path | Branch / Commit Signal |
19
+ |---|---|---|
20
+ | `smlfg/KommandoZentrale` | `/home/smlflg/Projekte/KomandoZentral` | `master`, `af2aa3f7479443803991239610add5343ccf43b3` |
21
+ | `smlfg/Zentrale` | `/home/smlflg/Projekte/Zentrale` | `master`, `3153996 Prepare control tower prototype public handoff` |
22
+ | `smlfg/MegaHarness` | `/home/smlflg/Projekte/megaHarness` | `master`, `452f9d5ebfb4e6b5f569b1804fdcfe880e08629e` |
23
+
24
+ ## Session Order
25
+
26
+ - [x] Prepare Audit 1 with `briefings/01_audit_kommandozentrale.md`.
27
+ - [x] Prepare Audit 2 with `briefings/02_audit_zentrale.md`.
28
+ - [x] Prepare Audit 3 with `briefings/03_audit_megaharness.md`.
29
+ - [x] Write the four required Markdown files for all three audit folders.
30
+ - [x] Write `audits/TOWER_HEALTH_OVERVIEW.md`.
31
+
32
+ ## Required Output Per Repo
33
+
34
+ Each repo output folder must contain:
35
+
36
+ - [x] `AGENT_FINDINGS.md`
37
+ - [x] `ARCHITECTURE_MAP.md`
38
+ - [x] `RISK_REGISTER.md`
39
+ - [x] `NEXT_ISSUES.md`
40
+
41
+ Repo output folders:
42
+
43
+ - [x] `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/`
44
+ - [x] `/home/smlflg/Projekte/ProjectIntakeTower/audits/zentrale/`
45
+ - [x] `/home/smlflg/Projekte/ProjectIntakeTower/audits/megaharness/`
46
+
47
+ ## Aggregator Output
48
+
49
+ - [x] `/home/smlflg/Projekte/ProjectIntakeTower/audits/TOWER_HEALTH_OVERVIEW.md`
50
+
51
+ The overview contains:
52
+
53
+ - [x] Source snapshot table.
54
+ - [x] Cross-repo capability comparison.
55
+ - [x] Overlap and duplication map.
56
+ - [x] Shared risk themes.
57
+ - [x] Test and verifier gaps.
58
+ - [x] `NEEDS_HUMAN` index.
59
+ - [x] Morning review checklist.
60
+ - [x] Explicit note: no architecture verdict.
61
+
62
+ ## Morning Verification
63
+
64
+ - [x] `find /home/smlflg/Projekte/ProjectIntakeTower/audits -maxdepth 2 -type f | sort` shows the expected files.
65
+ - [x] `git -C /home/smlflg/Projekte/KomandoZentral status --short` has no new audit-caused changes.
66
+ - [x] `git -C /home/smlflg/Projekte/Zentrale status --short` still shows pre-existing dirty state, but no ProjectIntakeTower audit files.
67
+ - [x] `git -C /home/smlflg/Projekte/megaHarness status --short` still shows pre-existing dirty state, but no ProjectIntakeTower audit files.
68
+ - [x] No GitHub PRs, branches, or pushes were created by this run.
69
+ - [x] Every file is concise enough to skim quickly.
README.md ADDED
@@ -0,0 +1,63 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # ProjectIntakeTower
2
+
3
+ Local read-only audit tower for the 2026-05-04 Codex quota night run.
4
+
5
+ ## Purpose
6
+
7
+ This folder contains briefings and durable Markdown artifacts for three isolated repo audits plus one cross-repo synthesis. The goal is useful morning review material for Samuel and Luis without code drift, GitHub noise, or premature consolidation decisions.
8
+
9
+ ## Directory Layout
10
+
11
+ ```text
12
+ ProjectIntakeTower/
13
+ ├── README.md
14
+ ├── 00_OPERATOR_CHECKLIST.md
15
+ ├── NIGHT_RUN_CHECKLIST.md
16
+ ├── briefings/
17
+ │ ├── 01_audit_kommandozentrale.md
18
+ │ ├── 02_audit_zentrale.md
19
+ │ ├── 03_audit_megaharness.md
20
+ │ └── 04_aggregator.md
21
+ └── audits/
22
+ ├── kommandozentrale/
23
+ ├── zentrale/
24
+ ├── megaharness/
25
+ └── TOWER_HEALTH_OVERVIEW.md
26
+ ```
27
+
28
+ ## Source Handling
29
+
30
+ Briefings are written for disposable source clones under:
31
+
32
+ ```text
33
+ /tmp/project-intake-tower-src-2026-05-04/
34
+ ```
35
+
36
+ The final audit artifacts are the source of truth for what was actually inspected. If an audit used an existing local worktree, it records that explicitly and treats dirty state as pre-existing context.
37
+
38
+ Durable output belongs only under this `ProjectIntakeTower/` directory.
39
+
40
+ ## Rules
41
+
42
+ - Existing local worktrees stay untouched.
43
+ - No branches, commits, pushes, PRs, labels, or GitHub issues.
44
+ - Audit agents write only Markdown artifacts.
45
+ - Luis owns the consolidation verdict.
46
+ - Use `NEEDS_HUMAN` when a question requires a product or architecture decision.
47
+
48
+ ## Quick Verification
49
+
50
+ ```bash
51
+ find /home/smlflg/Projekte/ProjectIntakeTower/audits -maxdepth 2 -type f | sort
52
+ ```
53
+
54
+ Expected per repo:
55
+
56
+ - `AGENT_FINDINGS.md`
57
+ - `ARCHITECTURE_MAP.md`
58
+ - `RISK_REGISTER.md`
59
+ - `NEXT_ISSUES.md`
60
+
61
+ Expected cross-repo output:
62
+
63
+ - `audits/TOWER_HEALTH_OVERVIEW.md`
REPO_OBSERVATION.md ADDED
@@ -0,0 +1,75 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Repo Observation
2
+
3
+ ## Sicher beobachtet
4
+
5
+ - `ProjectIntakeTower` ist in `/home/smlflg/Projekte/ProjectIntakeTower` kein Git-Repository. `git status --short` und `git log --oneline -5` liefern `fatal: not a git repository`.
6
+ - Top-Level-Dateien und Ordner:
7
+ - `README.md`
8
+ - `00_OPERATOR_CHECKLIST.md`
9
+ - `NIGHT_RUN_CHECKLIST.md`
10
+ - `briefings/`
11
+ - `audits/`
12
+ - `night_logs/`
13
+ - `.hermes/`
14
+ - Es wurden keine Projekt-Manifeste gefunden: kein `package.json`, kein `pyproject.toml`, kein `Cargo.toml`, kein `go.mod`.
15
+ - Es wurden keine App- oder Source-Verzeichnisse im Tower selbst gefunden: kein `src/`, kein `app/`, kein `tests/`.
16
+ - Laut `README.md` ist der Zweck ein lokaler read-only Audit-Tower fuer drei isolierte Repo-Audits plus eine Cross-Repo-Synthese.
17
+ - Laut `README.md` gehoeren dauerhafte Outputs nur in diesen `ProjectIntakeTower/` Ordner.
18
+ - Laut `README.md`, `00_OPERATOR_CHECKLIST.md` und `NIGHT_RUN_CHECKLIST.md` gelten harte Grenzen: keine Branches, Commits, Pushes, PRs, Labels, Issues, Source-Edits oder Architektur-Verdikte.
19
+ - Vorhandene Briefings:
20
+ - `briefings/01_audit_kommandozentrale.md`
21
+ - `briefings/02_audit_zentrale.md`
22
+ - `briefings/03_audit_megaharness.md`
23
+ - `briefings/04_aggregator.md`
24
+ - Vorhandene Audit-Artefakte pro auditiertem Projekt:
25
+ - `audits/kommandozentrale/AGENT_FINDINGS.md`
26
+ - `audits/kommandozentrale/ARCHITECTURE_MAP.md`
27
+ - `audits/kommandozentrale/RISK_REGISTER.md`
28
+ - `audits/kommandozentrale/NEXT_ISSUES.md`
29
+ - `audits/zentrale/AGENT_FINDINGS.md`
30
+ - `audits/zentrale/ARCHITECTURE_MAP.md`
31
+ - `audits/zentrale/RISK_REGISTER.md`
32
+ - `audits/zentrale/NEXT_ISSUES.md`
33
+ - `audits/megaharness/AGENT_FINDINGS.md`
34
+ - `audits/megaharness/ARCHITECTURE_MAP.md`
35
+ - `audits/megaharness/RISK_REGISTER.md`
36
+ - `audits/megaharness/NEXT_ISSUES.md`
37
+ - Vorhandene Cross-Repo-Synthese: `audits/TOWER_HEALTH_OVERVIEW.md`.
38
+ - `NIGHT_RUN_CHECKLIST.md` markiert die drei Repo-Audits und den Aggregator als abgeschlossen.
39
+ - `audits/TOWER_HEALTH_OVERVIEW.md` enthaelt eine Source-Snapshot-Tabelle fuer:
40
+ - `smlfg/KommandoZentrale`
41
+ - `smlfg/Zentrale`
42
+ - `smlfg/MegaHarness`
43
+ - `audits/TOWER_HEALTH_OVERVIEW.md` sagt ausdruecklich, dass keine Anchor-, Archiv-, Merge- oder Implementierungs-Empfehlung getroffen wird.
44
+ - Die Suche nach Hinweisen wie `NEEDS_HUMAN`, `decision`, `gate`, `risk` zeigt viele Treffer in Checklisten, Briefings und Audit-Artefakten.
45
+ - In den gesuchten Treffern wurden keine `TODO`- oder `FIXME`-Hinweise sichtbar.
46
+ - `night_logs/LANDING_NOTE_2026-05-04_19-55.md` dokumentiert, dass nach dem Night Run keine neuen Agenten, Architekturentscheidungen, PRs, Pushes oder Branches gestartet werden sollen.
47
+
48
+ ## Vermutlich
49
+
50
+ - `ProjectIntakeTower` ist vermutlich ein Markdown-only Intake- und Audit-Container, kein ausfuehrbares Produkt. Begruendung: Es gibt keine Manifeste, keine Source-Struktur, keine Tests und die vorhandenen Dokumente beschreiben einen read-only Audit-Tower.
51
+ - Die belastbarsten Daten liegen vermutlich unter `audits/`, nicht unter `briefings/`. Begruendung: Die Briefings sind Arbeitsauftraege; die Audit-Dateien sind laut `README.md` und Checklisten die dauerhaften Outputs.
52
+ - `.hermes/plans/2026-05-04_194718-project-intake-audit-briefings.md` ist vermutlich ein frueheres Setup-Planartefakt, nicht der aktuelle Wahrheitsstand. Begruendung: Die erledigten Audit-Outputs liegen danach unter `audits/`.
53
+ - Fuer Statuskarten je Projekt sind vermutlich vor allem `AGENT_FINDINGS.md`, `ARCHITECTURE_MAP.md`, `RISK_REGISTER.md` und `NEXT_ISSUES.md` nutzbar. Begruendung: Diese Dateien enthalten beobachtete Dateien, Entry Points, Risiken, offene Fragen und naechste Issue-Kandidaten.
54
+
55
+ ## Unklar
56
+
57
+ - Es ist unklar, wann und durch wen der Tower selbst zuletzt geaendert wurde, weil kein Git-Verlauf vorhanden ist.
58
+ - Es ist unklar, ob die vorhandenen Audit-Artefakte bereits final menschlich reviewt wurden oder nur Night-Run-Ergebnisse sind.
59
+ - Es ist unklar, ob lokale Dirty States in `/home/smlflg/Projekte/Zentrale` und `/home/smlflg/Projekte/megaHarness` spaeter beruecksichtigt werden sollen. Die vorhandenen Audits verwenden laut Artefakten Public Clones als Quelle.
60
+ - Es ist unklar, ob einzelne auditierte Projekte Produkt, Experiment, aktiv, tot oder Konsolidierungskandidat sind. Die vorhandenen Dokumente vermeiden diese Entscheidung ausdruecklich.
61
+ - Es ist unklar, ob die auditieren Quell-Repos aktuell lauffaehig sind. Die Audit-Artefakte dokumentieren, dass Tests nicht ausgefuehrt wurden.
62
+ - Es ist unklar, ob `NEXT_ISSUES.md` als echte Backlog-Quelle verwendet werden soll. Die vorhandenen Dokumente behandeln sie als Kandidaten, nicht als automatisch auszufuehrende Arbeit.
63
+
64
+ ## Risiken bei Weiterarbeit
65
+
66
+ - Blindes Bauen wuerde den Tower leicht mit einem App- oder Produkt-Repo verwechseln, obwohl hier keine Codebasis beobachtet wurde.
67
+ - Eine neue App, UI oder Architektur koennte die dokumentierte Rolle als read-only Audit-Container verwischen.
68
+ - Automatisches Umsetzen von `NEXT_ISSUES.md` koennte menschliche Gates und Konsolidierungsentscheidungen ueberspringen.
69
+ - Eine Statusansicht koennte Public-Clone-Fakten mit lokalen Dirty States vermischen, besonders bei `Zentrale` und `MegaHarness`.
70
+ - Eine lauffaehige Annahme ueber auditierte Projekte waere riskant, weil die vorhandenen Audits Tests und Runtime-Verifikation nicht ausgefuehrt haben.
71
+ - Eine Entscheidung ueber Anchor, Archivierung, Fusion oder Produktstatus wuerde den dokumentierten Grenzen des Towers widersprechen.
72
+
73
+ ## Kleinste reversible nächste Aktion
74
+
75
+ Nur Status feststellen: `audits/TOWER_HEALTH_OVERVIEW.md` lesen und danach pro Projekt genau `AGENT_FINDINGS.md` verdichten, ohne zu bauen, zu migrieren, Issues anzulegen oder Architekturentscheidungen zu treffen.
audits/TOWER_HEALTH_OVERVIEW.md ADDED
@@ -0,0 +1,121 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Tower Health Overview
2
+
3
+ ## 1. Executive summary
4
+
5
+ - All three requested public repos were auditable from fresh temporary clones.
6
+ - KommandoZentrale is a compact deterministic routing engine with CLI, FastAPI UI, YAML decisions, and local feedback state.
7
+ - Zentrale is the broadest implemented orchestration prototype with CLI, TUI, Web/API, registries, context packs, run tracking, and OpenCode delegation.
8
+ - MegaHarness is doctrine/handoff material in public HEAD, not an executable implementation repo.
9
+ - The strongest overlap is routing/policy: KommandoZentrale implements it, Zentrale partially implements/bridges it, MegaHarness plans it.
10
+ - The clearest distinct Zentrale asset is generated phase/harness context packs.
11
+ - The clearest distinct KommandoZentrale asset is explainable confidence-gated routing output.
12
+ - The clearest distinct MegaHarness asset is the L0-L4 doctrine plus build-vs-integrate and Höhlengleichnis method.
13
+ - Main shared risk: docs, runtime state, and policy ownership can drift if treated as already consolidated.
14
+ - No anchor, archive, merge, or implementation recommendation is made here.
15
+
16
+ ## 2. Input coverage
17
+
18
+ | Repo | AGENT_FINDINGS | ARCHITECTURE_MAP | RISK_REGISTER | NEXT_ISSUES | Notes |
19
+ |------|----------------|------------------|---------------|-------------|-------|
20
+ | KommandoZentrale | present | present | present | present | Public clone `af2aa3f`; temp clone clean. |
21
+ | Zentrale | present | present | present | present | Public clone `3153996`; local repo is dirty and was not used as truth. |
22
+ | MegaHarness | present | present | present | present | Public clone `452f9d5`; local `BRIEFING_LUIS.md` is dirty and was not used as truth. |
23
+
24
+ ## 3. Cross-repo comparison
25
+
26
+ | Dimension | KommandoZentrale | Zentrale | MegaHarness | Notes |
27
+ |----------|------------------|----------|-------------|-------|
28
+ | apparent purpose | Deterministic harness routing and YAML decision output | Local adaptive agent orchestration/control-tower skeleton | Meta-harness doctrine and Luis handoff | Purposes overlap but maturity differs. |
29
+ | maturity | Small executable prototype with tests/docs | Broad executable prototype with many surfaces and tests/docs | Markdown-only doctrine in public HEAD | Do not compare linearly as equal implementation repos. |
30
+ | entrypoints | `kz`, `kz-web`, FastAPI `/api/route` | `zentrale`, dashboard, serve, web APIs, context-pack/run commands | Docs only | MegaHarness has human-reading entrypoints only. |
31
+ | UI/backend presence | Embedded FastAPI web UI | FastAPI/WebSocket, static SPA, Textual TUI | UI described but not implemented | UI behavior verification differs. |
32
+ | harness integration | Recommendation only | Static route, KZ bridge, OpenCode delegation path | Adapter protocol described | Zentrale has live execution machinery. |
33
+ | state model | `DECISIONS/`, `DATA/outcomes.yaml`, latest cache | `projects/`, context packs, `runs/`, logs, learning/effectiveness | Planned MD-DB and eval JSONL | State contracts need alignment. |
34
+ | verification story | pytest tree; README commands; no CI observed | broad pytest tree; validators/doctor docs; no CI observed | no tests/verifier observed | Controlled verifier pass remains needed. |
35
+ | docs quality | strong schema/architecture docs with some naming drift | broad README/docs/registries with surface drift | strong doctrine docs but no README/schema examples | Different doc gaps. |
36
+ | consolidation relevance | routing policy and confidence evidence | concrete workflow/context/run implementation | conceptual topology and decision method | Relevance is factual, not a verdict. |
37
+ | main unknown | cache/store/naming contract | cwd/phase/web-surface contract | local/public briefing and MD-DB concrete schema | Human questions are concentrated here. |
38
+
39
+ ## 4. Observed overlaps
40
+
41
+ | Overlap | Repos involved | Evidence | Why it matters |
42
+ |---------|----------------|----------|----------------|
43
+ | Routing policy | KommandoZentrale, Zentrale, MegaHarness | KZ `classify/rules/confidence`; Zentrale `routing.py`; MegaHarness Task-Router doctrine. | Multiple routing authorities can diverge. |
44
+ | Harness vocabulary | All three | KZ harness registry; Zentrale harness/profile registry; MegaHarness adapter layer. | Names and capabilities need mapping. |
45
+ | Markdown/context artifacts | Zentrale, MegaHarness, KommandoZentrale | Zentrale context-pack templates; MegaHarness MD-DB doctrine; KZ YAML decisions/docs. | Artifact shapes may become contracts. |
46
+ | Local UI/control tower surface | KommandoZentrale, Zentrale, MegaHarness | KZ web UI; Zentrale TUI/Web/SPAs; MegaHarness L4 UI plan. | UI promises should be tied to implemented behavior. |
47
+ | Feedback/eval loop | All three | KZ outcome updates; Zentrale effectiveness learning; MegaHarness eval JSONL doctrine. | Feedback should not affect routing unless semantics are aligned. |
48
+ | Samuel-specific operating layer | All three | KZ operator-state flags; Zentrale phase/harness profiles; MegaHarness Sidecar/USP docs. | Personalization is a cross-cutting asset. |
49
+
50
+ ## 5. Distinct assets
51
+
52
+ | Repo | Distinct asset | Evidence | Possible relevance |
53
+ |------|----------------|----------|--------------------|
54
+ | KommandoZentrale | Confidence-gated YAML routing decision | `DECISION_OUTPUT_SCHEMA.md`, `src/kz/service.py`, `src/kz/confidence.py`. | Reusable routing-decision contract. |
55
+ | KommandoZentrale | Static harness registry with evidence caps | `src/kz/registry.py`. | Factual input for policy comparison. |
56
+ | Zentrale | Phase/harness-specific context-pack generator | `src/zentrale/context_pack.py`, `templates/context-pack/`. | Concrete implementation of adaptive Markdown context. |
57
+ | Zentrale | Run records and learning/effectiveness loop | `src/zentrale/run_tracking.py`, `src/zentrale/registry_learning.py`. | Execution history and feedback surface. |
58
+ | Zentrale | Multi-surface operator UI | `dashboard/`, `web/`, `src/zentrale/web/`. | Existing control-tower UX experiments. |
59
+ | MegaHarness | L0-L4 doctrine | `ARCHITECTURE.md`. | Shared conceptual map for Luis' review. |
60
+ | MegaHarness | Build-vs-integrate heuristic | `Artefakt_USP.md`. | Prevents commodity-code expansion. |
61
+ | MegaHarness | Höhlengleichnis categories | `Höhlengleichnis.md`. | Candidate classification method, not final verdict. |
62
+
63
+ ## 6. Consolidation risks
64
+
65
+ | Risk | Affected repos | Evidence | Why Luis/Samuel should care |
66
+ |------|----------------|----------|-----------------------------|
67
+ | Policy ownership ambiguity | All three | KZ routing engine; Zentrale static/KZ routing; MegaHarness Task-Router doctrine. | Same task can receive different recommendations. |
68
+ | Runtime maturity mismatch | All three | KZ/Zentrale have code; MegaHarness public clone is docs-only. | Comparing repos as equal codebases would mislead. |
69
+ | State contract drift | KommandoZentrale, Zentrale, MegaHarness | KZ decisions/cache; Zentrale projects/runs/context packs; MegaHarness planned MD-DB. | Data location and schema choices affect future handoff. |
70
+ | UI promise drift | KommandoZentrale, Zentrale, MegaHarness | KZ embedded UI; Zentrale TUI/Web with stub routes; MegaHarness UI doctrine. | UI surfaces may suggest more functionality than exists. |
71
+ | Local/public divergence | Zentrale, MegaHarness | startcheck local dirty state; public temp clones clean. | Tomorrow's reader must know which snapshot is authoritative. |
72
+ | Verification gap | All three | no CI observed; tests not run in audit; MegaHarness has no tests. | Human decisions should not assume green verification. |
73
+ | Scope expansion pressure | Zentrale, MegaHarness | broad Zentrale surfaces; MegaHarness multi-layer/product doctrine. | The audit should support decisions, not create new workstreams. |
74
+
75
+ ## 7. Open questions for Luis
76
+
77
+ 1. Which routing facts from KommandoZentrale are unique policy value versus duplicate implementation?
78
+ 2. Which Zentrale surfaces are evidence of product direction versus experiments?
79
+ 3. Does Zentrale's context-pack generator satisfy part of the MegaHarness MD-context concept?
80
+ 4. Which state contracts must be preserved: YAML decisions, context packs, run logs, eval JSONL, or a subset?
81
+ 5. Which integration surface is safest to treat as a boundary: CLI, Python module, HTTP API, or file contract?
82
+ 6. How should routing feedback be compared across KZ outcomes, Zentrale effectiveness, and MegaHarness eval doctrine?
83
+ 7. Which repo contains implementation evidence and which contains decision doctrine?
84
+ 8. Which current risks block a consolidation memo from being precise?
85
+ 9. What additional evidence, if any, is needed from sibling repos before a verdict?
86
+ 10. Which terminology should be normalized before any topology decision?
87
+
88
+ ## 8. Open questions for Samuel
89
+
90
+ 1. Should Luis read public clones only, or also dirty local Zentrale/megaHarness state?
91
+ 2. Which `BRIEFING_LUIS.md` version is intended for tomorrow?
92
+ 3. What must be emotionally/conceptually preserved from the MegaHarness doctrine?
93
+ 4. Which local UI surface actually feels useful: KZ web, Zentrale TUI, Zentrale browser UI, or none yet?
94
+ 5. Is the latest-decision cache acceptable as normal KZ behavior?
95
+ 6. Should harnesses run from the project root or generated context-pack directory?
96
+ 7. Which spelling should be canonical for KommandoZentrale/KomandoZentral?
97
+ 8. Which artifacts are active work product versus prior art?
98
+ 9. What should be sent to Luis as the exact input package?
99
+ 10. Which decision should not be rushed tomorrow morning?
100
+
101
+ ## 9. Candidate next actions
102
+
103
+ | Action | Owner candidate | Input needed | Output | Human gate |
104
+ |--------|-----------------|--------------|--------|------------|
105
+ | read/review | Samuel | `audits/TOWER_HEALTH_OVERVIEW.md` and three `AGENT_FINDINGS.md` files | Shared factual baseline | no |
106
+ | read/review | Luis | all 13 audit files plus public repo links | Independent consolidation understanding | no |
107
+ | decide | Samuel | local/public dirty-state summary | Which snapshot Luis should inspect | yes |
108
+ | decide | Samuel | KZ naming evidence | Canonical spelling for handoff | yes |
109
+ | compare | Luis | KZ/Zentrale/MegaHarness architecture maps | Routing/context/state comparison notes | yes |
110
+ | extract evidence | Samuel or assistant | sibling repo references from MegaHarness docs | Evidence matrix for Sidecar/eval/UI claims | yes |
111
+ | tag | Samuel | repo list and current intent | Human-readable active/prior-art/context tags | yes |
112
+ | write decision memo | Luis | audit files plus Samuel clarifications | `KONSOLIDIERUNG_LUIS.md` or equivalent memo | yes |
113
+
114
+ ## 10. Morning checklist
115
+
116
+ - Read first: `audits/TOWER_HEALTH_OVERVIEW.md`.
117
+ - Then read: each repo's `AGENT_FINDINGS.md`.
118
+ - Then skim: `ARCHITECTURE_MAP.md` for the repo Luis wants to inspect first.
119
+ - Do not immediately decide which repo is anchor or archive target.
120
+ - Send Luis: this `audits/` folder, public repo URLs, and Samuel's answer about public-vs-local dirty state.
121
+ - Keep `NEXT_ISSUES.md` files as candidate backlog only; do not create GitHub issues from them before human review.
audits/kommandozentrale/AGENT_FINDINGS.md ADDED
@@ -0,0 +1,79 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Agent Findings — KommandoZentrale
2
+
3
+ ## 1. Scope
4
+ - Repo/source: fresh public clone `https://github.com/smlfg/KommandoZentrale.git` at `af2aa3f` in `/tmp/tower-audit-KommandoZentrale`.
5
+ - Inspection mode: read-only file/config inspection; no target repo edits; no branches, commits, pushes, PRs, or issues.
6
+ - Output folder: `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/`.
7
+ - Timestamp: 2026-05-04T18:04:02Z.
8
+ - Auditor: Codex read-only audit operator.
9
+ - Important constraints: no architecture anchor verdict; no consolidation recommendation; tests not executed because audit goal is artifact generation and setup may write caches.
10
+
11
+ ## 2. Repo identity
12
+ - What this repo appears to be: deterministic harness-routing engine for AI work.
13
+ - Primary purpose: classify a task, combine operator state and task modifiers, recommend a harness, and emit explainable YAML decisions.
14
+ - Main language/framework: Python package using PyYAML, FastAPI, uvicorn, pytest, and ruff.
15
+ - Apparent maturity: small public handoff prototype with CLI, local web UI, persistence, docs, and focused tests.
16
+ - Main entry points: `kz = "kz.cli:main"`, `kz-web = "kz.web:run"`, `python -m kz`, FastAPI app in `src/kz/web.py`.
17
+ - Important docs/configs: `README.md`, `pyproject.toml`, `SOFTWARE_ARCHITEKTUR.md`, `DECISION_OUTPUT_SCHEMA.md`, `TASK_TAXONOMY_V1.md`, `WEB_UI_PLAN.md`.
18
+ - Evidence: `README.md` describes CLI/Web/API usage; `pyproject.toml` defines package, dependencies, scripts, pytest paths; `src/kz/service.py` contains the shared routing pipeline.
19
+
20
+ ## 3. Top observations
21
+
22
+ | ID | Observation | Evidence | Why it matters |
23
+ |----|-------------|----------|----------------|
24
+ | KZ-O1 | CLI and Web share one routing service. | `src/kz/cli.py` calls `route_request`; `src/kz/web.py` POST `/api/route` calls the same service. | Reduces ambiguity about the core behavior surface. |
25
+ | KZ-O2 | Routing is deterministic and rule-based, not LLM-driven. | `SOFTWARE_ARCHITEKTUR.md` says heuristic rules instead of ML/LLM; `src/kz/classify.py`, `src/kz/rules.py`, `src/kz/confidence.py`. | Important for consolidation because this is a policy engine, not an execution harness. |
26
+ | KZ-O3 | Output contract is YAML decision data. | `DECISION_OUTPUT_SCHEMA.md`; `src/kz/persist.py` serializes `RoutingDecision` to YAML. | Provides an integration surface for other tools. |
27
+ | KZ-O4 | Persistence is local and CWD-sensitive. | `save_decision()` writes to `os.getcwd()/DECISIONS`; `list_decision_files()` reads `Path(os.getcwd()) / "DECISIONS"`. | Can surprise callers if embedded from another repo. |
28
+ | KZ-O5 | A home-cache side effect exists even for unsaved routes. | `route_request()` calls `write_latest_decision()`; `latest_decision_path()` defaults to `~/.cache/kz/latest-decision.json`. | Read-only callers need to know that route calls can still write cache state. |
29
+ | KZ-O6 | The web app exposes decision review and outcome patching. | Endpoints `/api/decisions`, `/api/decisions/{filename}`, `/api/decisions/{filename}/outcome` in `src/kz/web.py`. | Outcome feedback is more than static routing docs. |
30
+ | KZ-O7 | Harness registry includes confidence caps and evidence status. | `src/kz/registry.py` defines profiles for AgentArena, Claude Code, Hermes, OpenCode, Codex CLI, Aider, Gemini MCP. | Useful factual asset for Luis without deciding repo ownership. |
31
+ | KZ-O8 | Public repo naming still carries a local spelling mismatch. | `pyproject.toml` homepage points to `https://github.com/smlflg/KomandoZentral`; public audit source is `smlfg/KommandoZentrale`. | Naming can confuse handoff readers and automation. |
32
+
33
+ ## 4. Strengths
34
+
35
+ | Strength | Evidence | Relevance for consolidation |
36
+ |----------|----------|-----------------------------|
37
+ | Compact core pipeline | `src/kz/service.py` coordinates classification, operator state, rules, confidence, persistence. | Easy to reason about as a single routing component. |
38
+ | Explicit task taxonomy and schema docs | `TASK_TAXONOMY_V1.md`, `DECISION_OUTPUT_SCHEMA.md`. | Gives Luis concrete contracts to compare against other routing layers. |
39
+ | CLI/API parity at the routing core | `src/kz/cli.py`, `src/kz/web.py`, `src/kz/service.py`. | Reduces duplicate behavior inside this repo. |
40
+ | Focused test tree exists | `tests/test_cli.py`, `tests/test_routing.py`, `tests/test_api.py`, `tests/test_confidence.py`, `tests/test_web_e2e.py`. | Verification path is visible even though tests were not run in this audit. |
41
+ | Explainability is a stated design goal | `SOFTWARE_ARCHITEKTUR.md` says explainable by design and confidence-gated. | Matches the control-tower need for readable routing decisions. |
42
+
43
+ ## 5. Weaknesses / gaps
44
+
45
+ | Gap | Evidence | Risk |
46
+ |-----|----------|------|
47
+ | Cache writes are implicit | `route_request()` catches `OSError` around `write_latest_decision()`. | Read-only invocations may still mutate user cache. |
48
+ | CWD-dependent decision store | `persist.py` builds paths from `os.getcwd()`. | Embedding from Zentrale or another orchestrator can write decisions into unexpected folders. |
49
+ | Public/local repo name mismatch | `pyproject.toml` homepage uses `KomandoZentral`; requested public repo is `KommandoZentrale`. | Handoff confusion and broken links. |
50
+ | No CI config found in inspected tree | `find` showed no `.github/workflows` at depth inspected. | Verification may depend on local discipline. |
51
+ | Web UI is embedded in one Python file | `src/kz/web.py` contains API plus large inline HTML/CSS/JS. | Browser behavior is harder to validate and evolve cleanly. |
52
+
53
+ ## 6. Test / CI / verification situation
54
+ - Existing tests: pytest tests exist for CLI, routing, confidence, API, web string/e2e behavior, and review layer.
55
+ - CI config: no CI workflow file observed in the inspected public tree.
56
+ - How to run: `uv run pytest -q`, `uv run ruff check .`, and `uv build` are documented in `README.md`.
57
+ - Whether tests were run: not run in this execution.
58
+ - If not run: why not: package-manager/test execution can write caches and the user requested a controlled read-only audit; file/config inspection was sufficient for the handoff artifact.
59
+ - Risk: tests may be stale or environment-sensitive until Samuel/Luis run a controlled verifier pass.
60
+
61
+ ## 7. Dependency / setup situation
62
+ - Package managers: `uv` is documented; editable `pip install -e .` is an alternative.
63
+ - Lockfiles: `uv.lock` exists.
64
+ - Runtime assumptions: Python `>=3.12`; PyYAML, FastAPI, uvicorn; dev dependencies include httpx, pytest, ruff.
65
+ - Missing setup docs: no CI setup path observed; no explicit cache/location contract for `KZ_CACHE_DIR`.
66
+ - Fragile assumptions: current working directory determines `DECISIONS/`; default cache path is under the user's home directory.
67
+
68
+ ## 8. Pre-existing local state
69
+ - Public temp clone state: `git status --short` was empty.
70
+ - Local repo caveat: `/home/smlflg/Projekte/KomandoZentral` exists and appeared clean during startcheck, but the audit used the public clone as source of truth.
71
+ - Dirty state interpretation: no local dirty state was interpreted as audit output.
72
+
73
+ ## 9. NEEDS_HUMAN
74
+
75
+ | Question | Why human judgment is needed | Suggested reader |
76
+ |----------|------------------------------|------------------|
77
+ | Should the public handoff standardize on `KommandoZentrale` or legacy `KomandoZentral` spelling? | Both spellings appear in paths/metadata and changing naming affects links. | Samuel |
78
+ | Is implicit `~/.cache/kz/latest-decision.json` writing acceptable for read-only route calls? | This is product/ops intent, not just code mechanics. | Samuel/Luis |
79
+ | Should outcome feedback be part of the current consolidation surface? | Web/API support outcome updates, while docs position the tool mainly as routing decision output. | Luis |
audits/kommandozentrale/ARCHITECTURE_MAP.md ADDED
@@ -0,0 +1,91 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Architecture Map — KommandoZentrale
2
+
3
+ ## 1. High-level map
4
+
5
+ KommandoZentrale is a compact deterministic routing service. The visible layers are:
6
+ - Input adapters: CLI in `src/kz/cli.py`, local FastAPI app in `src/kz/web.py`, and module shims under `kz/`.
7
+ - Core pipeline: `src/kz/service.py` coordinates classifier, operator-state resolver, routing rules, confidence logic, harness registry, and persistence.
8
+ - Domain model: enums/dataclasses in `src/kz/models.py`.
9
+ - Local state: YAML decisions under `DECISIONS/`, outcome updates, and latest-decision cache.
10
+
11
+ ## 2. File / directory map
12
+
13
+ | Path | Role | Notes |
14
+ |------|------|-------|
15
+ | `README.md` | Operator-facing setup and usage | Documents CLI, Web UI, API, tests, and runtime output dirs. |
16
+ | `pyproject.toml` | Python package config | Defines `kz` and `kz-web` scripts, dependencies, pytest/ruff config. |
17
+ | `src/kz/cli.py` | CLI adapter | Builds `RouteRequest`, prints YAML, handles `outcome`. |
18
+ | `src/kz/service.py` | Core routing pipeline | Shared by CLI and API. |
19
+ | `src/kz/classify.py` | Task classifier and modifier parser | Regex keyword classifier. |
20
+ | `src/kz/rules.py` | Harness routing rules | Applies task class, modifiers, operator state. |
21
+ | `src/kz/confidence.py` | Confidence gate | Converts routing confidence to direct/experiment/no recommendation levels. |
22
+ | `src/kz/registry.py` | Harness registry | Static profiles and confidence caps. |
23
+ | `src/kz/persist.py` | YAML persistence | Writes/reads `DECISIONS/` relative to CWD. |
24
+ | `src/kz/latest_decision.py` | Latest decision cache | Defaults to `~/.cache/kz/latest-decision.json`. |
25
+ | `src/kz/web.py` | FastAPI API plus embedded web UI | Exposes routing, decision listing/detail/raw, outcome patch. |
26
+ | `tests/` | Verification suite | Focused pytest files for core and web/API surfaces. |
27
+
28
+ ## 3. Entry points
29
+
30
+ | Entry point | Type | Evidence | Notes |
31
+ |-------------|------|----------|-------|
32
+ | `kz` | CLI script | `pyproject.toml` maps to `kz.cli:main`. | Main routing command. |
33
+ | `python -m kz` | Python module | `README.md`; `kz/__main__.py`; `src/kz/__main__.py`. | Local/module execution path. |
34
+ | `kz outcome` | CLI subcommand | `src/kz/cli.py` handles `raw_args[0] == "outcome"`. | Updates stored decision outcome. |
35
+ | `kz-web` | CLI script | `pyproject.toml` maps to `kz.web:run`. | Starts uvicorn on localhost. |
36
+ | `GET /health` | API | `src/kz/web.py`. | Health probe. |
37
+ | `POST /api/route` | API | `src/kz/web.py`. | Calls the same `route_request()` pipeline as CLI. |
38
+ | `GET /api/decisions` | API | `src/kz/web.py`. | Lists local YAML decisions. |
39
+ | `PATCH /api/decisions/{filename}/outcome` | API | `src/kz/web.py`. | Writes feedback into decision files. |
40
+
41
+ ## 4. Data/control flow
42
+
43
+ - User/input flow: user supplies a task plus optional operator-state/modifier flags through CLI or `/api/route`.
44
+ - Agent/control flow: no live agent execution; the system recommends a harness and fallback with confidence.
45
+ - Persistence/state flow: optional `--save` writes YAML to `DECISIONS/`; outcome updates mutate existing YAML; latest decision cache writes under `KZ_CACHE_DIR` or `~/.cache/kz`.
46
+ - External API/tool flow: local FastAPI server only; no observed GitHub/MCP/remote service calls in runtime routing.
47
+
48
+ ## 5. Interfaces and integration surfaces
49
+
50
+ | Interface | Direction | Evidence | Consolidation relevance |
51
+ |-----------|-----------|----------|-------------------------|
52
+ | CLI `kz` | inbound | `pyproject.toml`, `src/kz/cli.py` | Simple integration point for Zentrale or operator scripts. |
53
+ | YAML decision schema | outbound/inbound | `DECISION_OUTPUT_SCHEMA.md`, `src/kz/persist.py` | Candidate contract for routing decisions. |
54
+ | FastAPI route API | inbound/outbound | `src/kz/web.py` | Local UI/API surface for routing and review. |
55
+ | `DECISIONS/` | local state | `README.md`, `persist.py` | Durable record but CWD-sensitive. |
56
+ | `DATA/outcomes.yaml` | local state | `README.md`, `persist.py` outcome helpers | Feedback learning surface. |
57
+ | Latest cache | local state | `latest_decision.py` | Hidden side effect unless configured. |
58
+ | Harness registry | internal config | `src/kz/registry.py` | Contains reusable harness profile/evidence facts. |
59
+
60
+ ## 6. State and persistence
61
+
62
+ - Files: YAML decisions in `DECISIONS/`; `DATA/outcomes.yaml`; latest-decision JSON cache.
63
+ - Databases: none observed.
64
+ - Logs: no formal log directory observed.
65
+ - Caches: `~/.cache/kz/latest-decision.json` by default.
66
+ - Runtime state: current working directory affects decision paths.
67
+ - Unknowns: whether the cache write is intended for all integrations or only interactive CLI use.
68
+
69
+ ## 7. Configuration model
70
+
71
+ - Where config lives: CLI flags, static registry in Python, pytest/ruff config in `pyproject.toml`.
72
+ - How profiles/env vars are handled: `KZ_CACHE_DIR` can override latest-decision cache location.
73
+ - Secrets risk: no secret files observed; low direct secret risk.
74
+ - Missing config docs: cache override and CWD persistence behavior are not prominent in README.
75
+
76
+ ## 8. Architecture risks
77
+
78
+ | Risk | Evidence | Effect |
79
+ |------|----------|--------|
80
+ | Hidden write on read-like route calls | `route_request()` writes latest-decision cache even when `save` is false. | Harder to embed in strict read-only automation. |
81
+ | CWD-sensitive state | `persist.py` uses `os.getcwd()`. | Parent orchestrator may write/read decisions in the wrong project. |
82
+ | Naming ambiguity | `pyproject.toml` homepage points to legacy spelling. | Public handoff and automation may drift. |
83
+ | Embedded Web UI complexity | `src/kz/web.py` includes API and large inline UI. | Browser behavior can drift without dedicated frontend tests. |
84
+ | Static harness policy | `src/kz/registry.py`, `src/kz/rules.py`. | Needs explicit ownership if multiple repos also route harnesses. |
85
+
86
+ ## 9. Open architecture questions
87
+
88
+ - Should KommandoZentrale be consumed as CLI, Python library, HTTP API, or only as reference policy?
89
+ - Should latest-decision cache writes be opt-in for integrations?
90
+ - Should `DECISIONS/` be rooted in this repo, caller workspace, or a configured path?
91
+ - Which parts of the harness registry are factual evidence versus Samuel-specific preference?
audits/kommandozentrale/NEXT_ISSUES.md ADDED
@@ -0,0 +1,80 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Next Issue Candidates — KommandoZentrale
2
+
3
+ Diese Datei enthält nur Issue-Kandidaten.
4
+ Keine Issues erstellen.
5
+ Keine Labels erstellen.
6
+ Keine PRs öffnen.
7
+
8
+ ## Issue candidates
9
+
10
+ ### ISSUE-1: Clarify Public Repo Naming
11
+
12
+ - Type: docs/metadata
13
+ - Why this matters: Public handoff uses `KommandoZentrale`, while local metadata still points to `KomandoZentral`.
14
+ - Evidence: `pyproject.toml` homepage; requested public repo URL.
15
+ - Suggested scope: Add/update a short naming note and metadata once Samuel confirms canonical spelling.
16
+ - Non-goals: No repo rename, no redirect setup, no archive decision.
17
+ - Acceptance criteria: README/metadata no longer leave readers unsure which repo is meant.
18
+ - Risk reduced: unclear ownership; stale docs.
19
+ - Candidate Höhlengleichnis category: F — Vor-Entscheidung nötig.
20
+ - Human gate needed: yes.
21
+
22
+ ### ISSUE-2: Document Latest-Decision Cache Contract
23
+
24
+ - Type: docs/product-contract
25
+ - Why this matters: Route calls can write cache even without `--save`.
26
+ - Evidence: `src/kz/service.py`; `src/kz/latest_decision.py`.
27
+ - Suggested scope: Document `KZ_CACHE_DIR`, default path, and integration expectations.
28
+ - Non-goals: No behavior change before human review.
29
+ - Acceptance criteria: A reader can predict whether a route call writes state.
30
+ - Risk reduced: hidden state; no verification path.
31
+ - Candidate Höhlengleichnis category: E — Komplementär.
32
+ - Human gate needed: yes.
33
+
34
+ ### ISSUE-3: Make Decision Store Root Explicit For Integrations
35
+
36
+ - Type: data-contract
37
+ - Why this matters: `DECISIONS/` is relative to current working directory.
38
+ - Evidence: `src/kz/persist.py`.
39
+ - Suggested scope: Define intended base-dir behavior in docs and tests.
40
+ - Non-goals: No migration of existing decision files.
41
+ - Acceptance criteria: CLI and library/API callers have documented storage semantics.
42
+ - Risk reduced: hidden state; dependency fragility.
43
+ - Candidate Höhlengleichnis category: F — Vor-Entscheidung nötig.
44
+ - Human gate needed: yes.
45
+
46
+ ### ISSUE-4: Add Classifier Precedence Smoke Cases
47
+
48
+ - Type: test
49
+ - Why this matters: Keyword ordering affects task class and harness recommendation.
50
+ - Evidence: `src/kz/classify.py` checks THINK before BUILD/ANALYZE and defaults to BUILD.
51
+ - Suggested scope: Add focused tests for mixed planning/build/research phrases.
52
+ - Non-goals: No routing redesign.
53
+ - Acceptance criteria: Mixed-task behavior is explicit in tests.
54
+ - Risk reduced: architecture ambiguity; duplicated concept.
55
+ - Candidate Höhlengleichnis category: E — Komplementär.
56
+ - Human gate needed: no.
57
+
58
+ ### ISSUE-5: Document Outcome Feedback Scope
59
+
60
+ - Type: docs/product-contract
61
+ - Why this matters: Outcome PATCH/update exists, but consolidation readers need to know whether it is core.
62
+ - Evidence: `src/kz/web.py`, `src/kz/cli.py`, `src/kz/persist.py`.
63
+ - Suggested scope: Add current-scope note for outcome recording and confidence feedback.
64
+ - Non-goals: No UI redesign.
65
+ - Acceptance criteria: README or architecture doc states whether outcome feedback is MVP/core/experimental.
66
+ - Risk reduced: stale docs; duplicated concept.
67
+ - Candidate Höhlengleichnis category: F — Vor-Entscheidung nötig.
68
+ - Human gate needed: yes.
69
+
70
+ ### ISSUE-6: Add Minimal API Parity Smoke
71
+
72
+ - Type: test
73
+ - Why this matters: CLI and Web use the same service, but parity should remain visible.
74
+ - Evidence: `src/kz/cli.py`; `src/kz/web.py`; existing `tests/`.
75
+ - Suggested scope: One test comparing CLI-style request and `/api/route` payload for the same task.
76
+ - Non-goals: No browser automation.
77
+ - Acceptance criteria: API and CLI route core output remain aligned.
78
+ - Risk reduced: UI/backend mismatch.
79
+ - Candidate Höhlengleichnis category: E — Komplementär.
80
+ - Human gate needed: no.
audits/kommandozentrale/RISK_REGISTER.md ADDED
@@ -0,0 +1,29 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Risk Register — KommandoZentrale
2
+
3
+ ## Risk summary
4
+
5
+ KommandoZentrale has a clear, compact routing role and useful tests/docs. The main risks are not architectural verdicts; they are integration risks: hidden local state, naming ambiguity, duplicated routing policy, and unclear verification baseline.
6
+
7
+ ## Risk table
8
+
9
+ | ID | Risk | Evidence | Severity | Likelihood | Impact | Possible mitigation | NEEDS_HUMAN |
10
+ |----|------|----------|----------|------------|--------|---------------------|-------------|
11
+ | KZ-R1 | Public/local naming drift | Public clone is `smlfg/KommandoZentrale`; `pyproject.toml` homepage references `smlflg/KomandoZentral`. | medium | high | Broken links and confused handoff. | Add a naming note or metadata cleanup after review. | yes |
12
+ | KZ-R2 | Hidden cache writes | `route_request()` calls `write_latest_decision()`; default path is `~/.cache/kz/latest-decision.json`. | medium | medium | Read-only operators may mutate home state. | Document `KZ_CACHE_DIR` and/or make cache explicit. | yes |
13
+ | KZ-R3 | CWD-dependent decision persistence | `persist.py` writes to `os.getcwd()/DECISIONS`. | medium | high | Parent tools can scatter decision files. | Require explicit base dir for integrations. | yes |
14
+ | KZ-R4 | Routing policy duplication with other repos | KZ has `classify/rules/confidence`; Zentrale also has `routing.py`; MegaHarness plans a Task-Router. | high | high | Divergent harness choices for the same task. | Treat KZ policy as evidence until Luis decides ownership. | yes |
15
+ | KZ-R5 | No CI observed | No `.github/workflows` found in inspected tree; README documents manual commands. | medium | medium | Public handoff may lack automated regression signal. | Add CI only after consolidation direction is chosen. | no |
16
+ | KZ-R6 | Web UI behavior harder to verify | `src/kz/web.py` contains API and embedded UI. | medium | medium | API may pass while browser workflow drifts. | Add focused browser/API smoke later. | no |
17
+ | KZ-R7 | Outcome scope ambiguity | API supports outcome patching; docs emphasize routing decision output. | low | medium | Readers may disagree whether feedback is in current scope. | Document current behavior and non-goals. | yes |
18
+
19
+ ## Top 3 risks for Samuel tomorrow
20
+
21
+ - Hidden write behavior could surprise read-only or sandboxed workflows.
22
+ - Name mismatch can make the repo look missing or duplicated.
23
+ - Outcome feedback scope needs a quick human stance before public handoff language changes.
24
+
25
+ ## Top 3 risks for Luis' consolidation work
26
+
27
+ - Routing policy exists here and in Zentrale while MegaHarness also plans one.
28
+ - KZ produces recommendations, not live harness execution.
29
+ - Persistence contracts are local-file based and need a clear integration boundary.
audits/megaharness/AGENT_FINDINGS.md ADDED
@@ -0,0 +1,81 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Agent Findings — MegaHarness
2
+
3
+ ## 1. Scope
4
+ - Repo/source: fresh public clone `https://github.com/smlfg/MegaHarness.git` at `452f9d5` in `/tmp/tower-audit-MegaHarness`.
5
+ - Inspection mode: read-only file inspection; no target repo edits; no branches, commits, pushes, PRs, or issues.
6
+ - Output folder: `/home/smlflg/Projekte/ProjectIntakeTower/audits/megaharness/`.
7
+ - Timestamp: 2026-05-04T18:04:02Z.
8
+ - Auditor: Codex read-only audit operator.
9
+ - Important constraints: no architecture anchor verdict; no consolidation recommendation; doctrine is described, not accepted or rejected by this audit.
10
+
11
+ ## 2. Repo identity
12
+ - What this repo appears to be: doctrine and Luis handoff package for a personal meta-harness/control-tower concept.
13
+ - Primary purpose: describe MegaHarness as a layer over existing coding harnesses, with Markdown artifacts as source of truth and adapters to external execution engines.
14
+ - Main language/framework: Markdown documentation only in the public clone; no package/framework metadata observed.
15
+ - Apparent maturity: conceptual architecture lock and handoff material; not an executable implementation repo in public HEAD.
16
+ - Main entry points: no CLI/API/runtime entry point observed.
17
+ - Important docs/configs: `ARCHITECTURE.md`, `Artefakt_USP.md`, `Höhlengleichnis.md`, `BRIEFING_LUIS.md`, `idea`.
18
+ - Evidence: public clone contains only those five files plus `.git`; no `pyproject.toml`, `package.json`, `src/`, `tests/`, `README.md`, or CI config observed.
19
+
20
+ ## 3. Top observations
21
+
22
+ | ID | Observation | Evidence | Why it matters |
23
+ |----|-------------|----------|----------------|
24
+ | MH-O1 | The repo is doctrine-first, not implementation-first. | `find` shows five top-level docs and no source/test tree. | Maturity must be compared differently from code repos. |
25
+ | MH-O2 | The architecture uses an explicit L0-L4 layered model. | `ARCHITECTURE.md` sections for provider, adapter, MD-DB, kernel, UI layers. | Gives Luis a vocabulary for comparison without deciding anchor. |
26
+ | MH-O3 | Markdown database is central to the concept. | `ARCHITECTURE.md` L2; `idea` point 3; `Artefakt_USP.md` says MD-DB schema/content is 100% own. | Important distinct asset, but schema/examples are absent in public clone. |
27
+ | MH-O4 | The repo favors adapters over forks. | `Artefakt_USP.md` build-vs-integrate heuristic and anti-patterns. | Useful consolidation principle, not a decision by this audit. |
28
+ | MH-O5 | The adapter protocol is described but not implemented. | `ARCHITECTURE.md` lists `spawn`, `status`, `interrupt`, `collect`, `capabilities`. | Integration surface exists as text only. |
29
+ | MH-O6 | Sidecar and eval are referenced as existing elsewhere. | `ARCHITECTURE.md` cites `Sidecar-ng` and `HarnessEcosystem/sidebyside`. | Claims depend on sibling repos not contained here. |
30
+ | MH-O7 | Luis briefing explicitly asks for decisions this audit must not make. | `BRIEFING_LUIS.md` asks for anchor recommendation, verdicts, sequence, risks, topology. | Protects audit boundary. |
31
+ | MH-O8 | Höhlengleichnis provides categories for issue candidates, but final categorization is human/decision work. | `Höhlengleichnis.md` category table A-F. | Audit can use candidate categories only. |
32
+ | MH-O9 | Public clone lacks a self-contained README or verifier. | No `README.md`, no test/check script, no link checker. | Tomorrow's reader must know this is a handoff bundle, not runnable software. |
33
+
34
+ ## 4. Strengths
35
+
36
+ | Strength | Evidence | Relevance for consolidation |
37
+ |----------|----------|-----------------------------|
38
+ | Clear layered vocabulary | `ARCHITECTURE.md` L0-L4 model. | Helps compare UI, orchestration, adapters, state, and providers. |
39
+ | Explicit build-vs-integrate doctrine | `Artefakt_USP.md`. | Reduces risk of building commodity infrastructure. |
40
+ | Project distillation method | `Höhlengleichnis.md`. | Provides a non-code method for judging duplicate/shadow projects. |
41
+ | Boundary-aware Luis handoff | `BRIEFING_LUIS.md`. | Makes decision ownership visible. |
42
+ | Personalization is treated as asset | `Artefakt_USP.md` and `BRIEFING_LUIS.md` preserve Samuel-specific MD/Sidecar/policy layers. | Important non-code requirement for consolidation. |
43
+
44
+ ## 5. Weaknesses / gaps
45
+
46
+ | Gap | Evidence | Risk |
47
+ |-----|----------|------|
48
+ | No executable implementation in public clone | no `src/`, package metadata, tests, or CLI/API entrypoint. | Cannot verify runtime claims from this repo. |
49
+ | No concrete MD-DB schema files | `ARCHITECTURE.md` describes `md-db/`, but no such directory exists. | Central concept remains abstract. |
50
+ | No README entry point | no `README.md` observed. | Reader onboarding depends on knowing which doc to read first. |
51
+ | Sibling repo claims are not reproducible here | references to Sidecar-ng, sidebyside, frontier UI, PromptGarage. | Luis must inspect other repos or treat claims as context. |
52
+ | Local/public briefing divergence exists | startcheck showed `/home/smlflg/Projekte/megaHarness/BRIEFING_LUIS.md` modified locally. | Samuel may have newer private handoff text not in public clone. |
53
+
54
+ ## 6. Test / CI / verification situation
55
+ - Existing tests: none observed.
56
+ - CI config: none observed.
57
+ - How to run: no executable run command observed.
58
+ - Whether tests were run: not applicable; no test runner/package metadata exists in public clone.
59
+ - If not run: why not: repository is Markdown-only in public HEAD.
60
+ - Risk: documentation consistency, references, and schema claims need a docs verifier or human review.
61
+
62
+ ## 7. Dependency / setup situation
63
+ - Package managers: none observed.
64
+ - Lockfiles: none observed.
65
+ - Runtime assumptions: none executable in this repo; architecture references external harnesses and sibling projects.
66
+ - Missing setup docs: no README, no local verifier, no MD-DB example, no adapter fixture.
67
+ - Fragile assumptions: reader must know the intended reading order and which sibling project claims are current.
68
+
69
+ ## 8. Pre-existing local state
70
+ - Public temp clone state: `git status --short` was empty.
71
+ - Local repo caveat: `/home/smlflg/Projekte/megaHarness` has modified `BRIEFING_LUIS.md` and was not used as source of truth.
72
+ - Dirty state interpretation: local dirty briefing text was treated as pre-existing context only.
73
+
74
+ ## 9. NEEDS_HUMAN
75
+
76
+ | Question | Why human judgment is needed | Suggested reader |
77
+ |----------|------------------------------|------------------|
78
+ | Should the modified local `BRIEFING_LUIS.md` supersede public HEAD for Luis? | Local and public handoff text may differ. | Samuel |
79
+ | What is the intended first-read file for public reviewers? | Public clone lacks `README.md`. | Samuel |
80
+ | Which sibling repo claims should Luis verify directly? | Sidecar/eval/UI references are external to this repo. | Luis |
81
+ | Is MD-DB meant as "database" despite any "no own DB" wording elsewhere? | This is a product-language clarification, not code. | Samuel/Luis |
audits/megaharness/ARCHITECTURE_MAP.md ADDED
@@ -0,0 +1,82 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Architecture Map — MegaHarness
2
+
3
+ ## 1. High-level map
4
+
5
+ The public MegaHarness repo contains a documented architecture, not an implementation. The described layers are:
6
+ - L0 Provider layer: external model providers, explicitly not MegaHarness-owned.
7
+ - L1 Harness adapter layer: Claude Code, OpenClaude, Codex, OpenHands, Hermes, etc.
8
+ - L2 Markdown database: project briefs, instructions, skills, sidecar rules, tracks, eval logs.
9
+ - L3 Kernel: router, orchestrator, sidecar engine, eval engine, MD resolver, harness swap.
10
+ - L4 UI layer: dashboard, track viewer, MD-DB browser, eval viewer, spawn composer.
11
+
12
+ ## 2. File / directory map
13
+
14
+ | Path | Role | Notes |
15
+ |------|------|-------|
16
+ | `ARCHITECTURE.md` | Main architecture plan | L0-L4 model, component descriptions, MVP plan, risks, glossary. |
17
+ | `Artefakt_USP.md` | Build-vs-integrate doctrine | Separates Samuel-specific assets from commodity infrastructure. |
18
+ | `Höhlengleichnis.md` | Project distillation method | Defines A-F categories and seed/match/verdict/action flow. |
19
+ | `BRIEFING_LUIS.md` | Luis handoff | Frames the consolidation deliverable and boundaries. |
20
+ | `idea` | Raw/compact vision | Lists harness-agnostic, MD-DB, eval, UI, Samuel-optimized principles. |
21
+
22
+ ## 3. Entry points
23
+
24
+ | Entry point | Type | Evidence | Notes |
25
+ |-------------|------|----------|-------|
26
+ | `ARCHITECTURE.md` | Document entry | Top-level file; detailed architecture sections. | Best architecture overview. |
27
+ | `BRIEFING_LUIS.md` | Human handoff | Defines Luis deliverable and project context. | Decision request, not audit output. |
28
+ | `Höhlengleichnis.md` | Method document | Category table and process sections. | Useful for candidate issue categories only. |
29
+ | Runtime CLI/API | Not observed | No package/source tree in public clone. | NEEDS_HUMAN if a runtime exists elsewhere. |
30
+
31
+ ## 4. Data/control flow
32
+
33
+ - User/input flow: doctrine describes user intent entering UI/CLI/Cron/Eval trigger, then becoming track metadata.
34
+ - Agent/control flow: Task-Router chooses harness/model; Parallel-Orchestrator spawns through L1 adapters; Sidecar observes; Harness-Swap can move work between harnesses.
35
+ - Persistence/state flow: MD-DB is described as source of truth with `projects/`, `instructions/`, `skills/`, `sidecar/`, `tracks/`, `evals/`.
36
+ - External API/tool flow: external harnesses/providers are adapter targets; Sidecar-ng and sidebyside are referenced as sibling integrations.
37
+ - Unclear: none of this flow is executable from public repo files alone.
38
+
39
+ ## 5. Interfaces and integration surfaces
40
+
41
+ | Interface | Direction | Evidence | Consolidation relevance |
42
+ |-----------|-----------|----------|-------------------------|
43
+ | Harness adapter protocol | outbound/inbound | `ARCHITECTURE.md` method table: `spawn`, `status`, `interrupt`, `collect`, `capabilities`. | Candidate contract, not implementation. |
44
+ | Track-MD | internal/outbound | `ARCHITECTURE.md` describes `tracks/*.md` and `done_when`. | Central planned task contract. |
45
+ | MD-Resolver | internal | `ARCHITECTURE.md` L2/L3 sections. | Distinct concept compared with Zentrale context packs. |
46
+ | Eval JSONL | inbound/outbound | `ARCHITECTURE.md` describes `evals/*.jsonl`. | Potential shared feedback format. |
47
+ | Sidecar rules | inbound | `ARCHITECTURE.md` and `Artefakt_USP.md` reference Sidecar-ng/rules. | Samuel-specific layer. |
48
+ | Luis briefing | human-facing | `BRIEFING_LUIS.md`. | Defines what Luis, not this audit, should decide. |
49
+
50
+ ## 6. State and persistence
51
+
52
+ - Files: planned Markdown DB files and JSONL evals are documented but absent.
53
+ - Databases: no runtime database observed; Markdown DB is a planned file-based source of truth.
54
+ - Logs: planned transcripts/metrics/evals described; no log implementation observed.
55
+ - Caches: none observed.
56
+ - Runtime state: planned tracks/active/queued/done/failed and heartbeat files in architecture text only.
57
+ - Unknowns: final MD-DB location and concrete schema are not present in public clone.
58
+
59
+ ## 7. Configuration model
60
+
61
+ - Where config lives: planned frontmatter in Markdown files and router policy docs.
62
+ - How profiles/env vars are handled: described conceptually through harness/model/project/session-phase selectors.
63
+ - Secrets risk: no secrets observed in public clone; future adapter layer will need secret/env handling.
64
+ - Missing config docs: no schema examples, no adapter config example, no `.env`/secrets policy, no validator.
65
+
66
+ ## 8. Architecture risks
67
+
68
+ | Risk | Evidence | Effect |
69
+ |------|----------|--------|
70
+ | Doctrine not executable | no source/package/test files. | Cannot validate behavior from this repo. |
71
+ | MD-DB is underspecified as files | no `md-db/` examples despite central role. | Implementers may invent incompatible schemas. |
72
+ | External references are not bundled | references to Sidecar-ng, sidebyside, PromptGarage, UI patterns. | Luis needs cross-repo evidence. |
73
+ | Five-day MVP plan may be historical | `ARCHITECTURE.md` dates 2026-04-23 to 2026-04-28. | Plan status needs human update. |
74
+ | Human decision pressure embedded in docs | `BRIEFING_LUIS.md` asks for anchor/fusion/topology. | Audit must not accidentally answer Luis' assignment. |
75
+
76
+ ## 9. Open architecture questions
77
+
78
+ - Which parts of the documented L0-L4 model are still current?
79
+ - Should Zentrale context packs count as an implementation of part of the MD-DB idea?
80
+ - What is the minimal MD-DB schema example Luis should evaluate?
81
+ - Which external/sibling assets are factual dependencies versus inspiration?
82
+ - Is MegaHarness a standalone repo target or a doctrine layer over another implementation?
audits/megaharness/NEXT_ISSUES.md ADDED
@@ -0,0 +1,92 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Next Issue Candidates — MegaHarness
2
+
3
+ Diese Datei enthält nur Issue-Kandidaten.
4
+ Keine Issues erstellen.
5
+ Keine Labels erstellen.
6
+ Keine PRs öffnen.
7
+
8
+ ## Issue candidates
9
+
10
+ ### ISSUE-1: Add A Public README Reading Order
11
+
12
+ - Type: docs/handoff
13
+ - Why this matters: Public clone has no obvious first-read file.
14
+ - Evidence: no `README.md`; top-level docs are `ARCHITECTURE.md`, `Artefakt_USP.md`, `Höhlengleichnis.md`, `BRIEFING_LUIS.md`, `idea`.
15
+ - Suggested scope: Add a short README listing purpose, status, reading order, and non-executable nature.
16
+ - Non-goals: No architecture verdict, no consolidation sequence.
17
+ - Acceptance criteria: A new reader knows where to start and what not to expect.
18
+ - Risk reduced: stale docs; no verification path.
19
+ - Candidate Höhlengleichnis category: E — Komplementär.
20
+ - Human gate needed: yes.
21
+
22
+ ### ISSUE-2: Create Minimal MD-DB Example
23
+
24
+ - Type: docs/schema
25
+ - Why this matters: MD-DB is central but absent as files.
26
+ - Evidence: `ARCHITECTURE.md` L2 describes planned folders; no `md-db/` exists.
27
+ - Suggested scope: Add one tiny example project/track/instruction/eval fixture as documentation.
28
+ - Non-goals: No parser, no runtime implementation.
29
+ - Acceptance criteria: The doctrine includes concrete file names and frontmatter examples.
30
+ - Risk reduced: architecture ambiguity.
31
+ - Candidate Höhlengleichnis category: F — Vor-Entscheidung nötig.
32
+ - Human gate needed: yes.
33
+
34
+ ### ISSUE-3: Mark Public Repo Status As Doctrine-Only
35
+
36
+ - Type: docs/status
37
+ - Why this matters: The docs describe runtime layers that do not exist in this repo.
38
+ - Evidence: no source tree or tests; `ARCHITECTURE.md` describes adapters/router/UI/evals.
39
+ - Suggested scope: Add status note to top of architecture or README.
40
+ - Non-goals: No implementation work.
41
+ - Acceptance criteria: Reader cannot confuse planned components with built components.
42
+ - Risk reduced: unclear ownership; stale docs.
43
+ - Candidate Höhlengleichnis category: E — Komplementär.
44
+ - Human gate needed: no.
45
+
46
+ ### ISSUE-4: Add Sibling Evidence Matrix
47
+
48
+ - Type: handoff/evidence
49
+ - Why this matters: Many claims depend on other local repos.
50
+ - Evidence: references to `Sidecar-ng`, `HarnessEcosystem/sidebyside`, `frontier-llm-harness`, `PromptGarage`.
51
+ - Suggested scope: Table of claim, sibling path, evidence file, status.
52
+ - Non-goals: No integration or copy/paste of sibling code.
53
+ - Acceptance criteria: Luis can verify claims without repo spelunking.
54
+ - Risk reduced: hidden state; architecture ambiguity.
55
+ - Candidate Höhlengleichnis category: F — Vor-Entscheidung nötig.
56
+ - Human gate needed: yes.
57
+
58
+ ### ISSUE-5: Reconcile Local And Public Luis Briefing
59
+
60
+ - Type: handoff
61
+ - Why this matters: Local `BRIEFING_LUIS.md` is modified compared with public clone.
62
+ - Evidence: startcheck local dirty state.
63
+ - Suggested scope: Samuel chooses which version Luis should read.
64
+ - Non-goals: No commit/push/merge.
65
+ - Acceptance criteria: Handoff source is explicitly named in tomorrow's package.
66
+ - Risk reduced: stale docs; unclear ownership.
67
+ - Candidate Höhlengleichnis category: F — Vor-Entscheidung nötig.
68
+ - Human gate needed: yes.
69
+
70
+ ### ISSUE-6: Clarify MD-DB Versus Database Wording
71
+
72
+ - Type: docs/product-contract
73
+ - Why this matters: "Database" can mean runtime DB or versioned Markdown source of truth.
74
+ - Evidence: `ARCHITECTURE.md` says Markdown DB; `Artefakt_USP.md` treats MD-DB schema/content as core USP.
75
+ - Suggested scope: Add wording that MD-DB means Git-versioned Markdown files, not SQL service, unless later changed.
76
+ - Non-goals: No storage decision beyond documenting current doctrine.
77
+ - Acceptance criteria: Reader understands the current storage concept.
78
+ - Risk reduced: architecture ambiguity.
79
+ - Candidate Höhlengleichnis category: E — Komplementär.
80
+ - Human gate needed: yes.
81
+
82
+ ### ISSUE-7: Add Docs Verification Checklist
83
+
84
+ - Type: verifier
85
+ - Why this matters: Markdown-only repo still needs drift checks.
86
+ - Evidence: no CI, link checker, or required-file checklist.
87
+ - Suggested scope: Add a checklist for required docs, links, referenced sibling paths, and status dates.
88
+ - Non-goals: No automated CI unless later approved.
89
+ - Acceptance criteria: Samuel/Luis can manually verify doc completeness in minutes.
90
+ - Risk reduced: no verification path.
91
+ - Candidate Höhlengleichnis category: E — Komplementär.
92
+ - Human gate needed: no.
audits/megaharness/RISK_REGISTER.md ADDED
@@ -0,0 +1,29 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Risk Register — MegaHarness
2
+
3
+ ## Risk summary
4
+
5
+ MegaHarness is a coherent doctrine/handoff repo in the public clone, but it is not executable. The main risks are verification gaps, missing concrete schemas, local/public handoff divergence, and the temptation to treat doctrine as implemented behavior.
6
+
7
+ ## Risk table
8
+
9
+ | ID | Risk | Evidence | Severity | Likelihood | Impact | Possible mitigation | NEEDS_HUMAN |
10
+ |----|------|----------|----------|------------|--------|---------------------|-------------|
11
+ | MH-R1 | Doctrine mistaken for implementation | Public clone has only five docs and no source/tests. | high | high | Luis/Samuel may overestimate runtime maturity. | Label repo as doctrine-only in handoff. | no |
12
+ | MH-R2 | Missing MD-DB concrete schema | `ARCHITECTURE.md` centers MD-DB; no `md-db/` examples exist. | high | high | Future implementers may invent incompatible contracts. | Add minimal example after decision. | yes |
13
+ | MH-R3 | Public/local briefing divergence | local `BRIEFING_LUIS.md` is modified; public clone is clean. | medium | high | Luis may read outdated or incomplete handoff. | Samuel selects public or local briefing source. | yes |
14
+ | MH-R4 | External evidence not reproducible here | Sidecar-ng, sidebyside, PromptGarage, UI patterns are referenced but absent. | medium | high | Claims need cross-repo validation. | Add evidence matrix or links after review. | yes |
15
+ | MH-R5 | No verification path | no README, tests, CI, link checker, or docs validator. | medium | high | Documentation drift can accumulate silently. | Add docs-only checklist/verifier later. | no |
16
+ | MH-R6 | Historic MVP timeline | `ARCHITECTURE.md` references 2026-04-23 to 2026-04-28. | low | medium | Readers may confuse past plan with current status. | Add status note. | yes |
17
+ | MH-R7 | Scope expansion pressure | `idea` and `ARCHITECTURE.md` mention many layers: UI, adapters, router, evals, sidecar, swap. | high | medium | Consolidation could expand instead of condense. | Keep Luis decision bounded to requested repos. | yes |
18
+
19
+ ## Top 3 risks for Samuel tomorrow
20
+
21
+ - Public repo does not include executable proof of the doctrine.
22
+ - Local `BRIEFING_LUIS.md` may contain newer context not in public HEAD.
23
+ - Missing README/reading order can slow Luis down.
24
+
25
+ ## Top 3 risks for Luis' consolidation work
26
+
27
+ - MegaHarness has strong concepts but no directly comparable runtime maturity.
28
+ - Core MD-DB concept lacks concrete files/schema in the public clone.
29
+ - Sibling-project claims need evidence from outside this repo.
audits/zentrale/AGENT_FINDINGS.md ADDED
@@ -0,0 +1,81 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Agent Findings — Zentrale
2
+
3
+ ## 1. Scope
4
+ - Repo/source: fresh public clone `https://github.com/smlfg/Zentrale.git` at `3153996` in `/tmp/tower-audit-Zentrale`.
5
+ - Inspection mode: read-only file/config inspection; no target repo edits; no branches, commits, pushes, PRs, or issues.
6
+ - Output folder: `/home/smlflg/Projekte/ProjectIntakeTower/audits/zentrale/`.
7
+ - Timestamp: 2026-05-04T18:04:02Z.
8
+ - Auditor: Codex read-only audit operator.
9
+ - Important constraints: no architecture anchor verdict; no consolidation recommendation; tests not executed because package/test commands may write caches or runtime files.
10
+
11
+ ## 2. Repo identity
12
+ - What this repo appears to be: local adaptive agent orchestration/control-tower skeleton.
13
+ - Primary purpose: create project scaffolds, route tasks to harness/phase pairs, generate context packs, track runs, expose CLI/TUI/Web views, and delegate primarily through OpenCode.
14
+ - Main language/framework: Python `>=3.11`, FastAPI, Textual, static browser UI, JSON registries, pytest.
15
+ - Apparent maturity: broad public handoff prototype with many implemented surfaces and explicit tests, but still contains stubs and contract ambiguities.
16
+ - Main entry points: `zentrale = "zentrale.cli:main"`, `python -m zentrale`, `zentrale serve`, Textual dashboard commands, FastAPI app in `src/zentrale/web/app.py`.
17
+ - Important docs/configs: `README.md`, `pyproject.toml`, `docs/architecture.md`, `docs/decisions.md`, `registry/*.json`, `templates/context-pack/*`, `integrations/*.md`.
18
+ - Evidence: `README.md` documents the end-to-end run loop and dashboard; `src/zentrale/cli.py` implements the command surface; `registry/harnesses.json` and `registry/profiles.json` define harnesses/profiles.
19
+
20
+ ## 3. Top observations
21
+
22
+ | ID | Observation | Evidence | Why it matters |
23
+ |----|-------------|----------|----------------|
24
+ | Z-O1 | The CLI surface is broad and operationally oriented. | `src/zentrale/cli.py` defines `init-project`, `context-pack`, `route`, `run`, `doctor`, `dashboard`, `serve`, and more. | Zentrale is more than a routing policy document; it contains workflow machinery. |
25
+ | Z-O2 | The repo models projects, phases, harnesses, context packs, runs, and learning feedback. | `src/zentrale/project_scaffold.py`, `context_pack.py`, `run_tracking.py`, `registry_learning.py`, `registry/*.json`. | These are distinct assets for consolidation review. |
26
+ | Z-O3 | Harness routing can be local/static or delegated to KommandoZentral. | `src/zentrale/routing.py`; `src/zentrale/cli.py` supports `route --live` and `run --use-kz`. | Shows direct overlap and integration with KommandoZentrale. |
27
+ | Z-O4 | Context packs are generated as phase/harness-specific Markdown bundles. | `src/zentrale/context_pack.py`; `templates/context-pack/*.md`; README `context-pack` docs. | This is an important concrete implementation of the MD-context idea. |
28
+ | Z-O5 | The `run` command writes real local state. | `src/zentrale/cli.py` creates context packs, run records, logs, learning proposals, and appends `DONE_CRITERIA.md`. | Execution semantics are not read-only and need clear ownership. |
29
+ | Z-O6 | Web API contains implemented reads and route suggestion, but write routes are still stubs. | `src/zentrale/web/routes/projects.py`, `runs.py`, `routing.py`, `dashboard.py`. | UI/backend maturity is mixed. |
30
+ | Z-O7 | Phase definitions drift across surfaces. | `registry/phases.json` includes `review`; `/api/phases` and `_PHASE_ORDER` omit `review`. | Consolidation readers should not assume one canonical phase source yet. |
31
+ | Z-O8 | Cost estimation depends on log fields that may not exist in generated logs. | `src/zentrale/web/routes/dashboard.py` reads `stdout`/`stderr`; `run_tracking.py` writes logs through `build_run_log()`. | Dashboard cost numbers can be incomplete. |
32
+ | Z-O9 | Public clone has extensive tests. | `tests/test_cli.py`, `test_e2e.py`, `test_web_api.py`, `test_context_pack.py`, `test_run_tracking.py`, `test_opencode_delegate.py`. | Verification intent is strong, even though tests were not executed in this audit. |
33
+
34
+ ## 4. Strengths
35
+
36
+ | Strength | Evidence | Relevance for consolidation |
37
+ |----------|----------|-----------------------------|
38
+ | Concrete context-pack implementation | `context_pack.py`, `templates/context-pack/`. | Implements a key idea that MegaHarness describes doctrinally. |
39
+ | Multiple operator surfaces | CLI, Textual dashboard, FastAPI, static UI in README and source. | Shows several candidate control-tower interaction models. |
40
+ | JSON registries for harness/phase/profile contracts | `registry/harnesses.json`, `registry/phases.json`, `registry/profiles.json`. | Machine-readable basis for comparison. |
41
+ | Direct KZ integration path | `routing.py` maps KommandoZentral output into Zentrale phases/harness IDs. | Relevant overlap without requiring a consolidation verdict. |
42
+ | Run tracking and learning feedback exist | `run_tracking.py`, `registry_learning.py`, README run loop. | Provides evidence of an execution/history layer. |
43
+
44
+ ## 5. Weaknesses / gaps
45
+
46
+ | Gap | Evidence | Risk |
47
+ |-----|----------|------|
48
+ | Local state writes are central to normal commands | `context_pack.py`, `run_tracking.py`, `cli.py run`. | Running commands in the wrong workspace can mutate project artifacts. |
49
+ | Phase contract is inconsistent | `registry/phases.json` vs `/api/phases` and project phase ordering. | UI/API may hide or mishandle valid registry phases. |
50
+ | Web write endpoints are stubs | `projects.py` and `runs.py` return 501 for create/update/retry/start. | UI may imply workflows not backed by API. |
51
+ | Harness execution cwd is context-pack path | `src/zentrale/cli.py` passes `cwd=pack_path` to `run_harness_prompt`. | Harness may operate from context bundle rather than target project. |
52
+ | Dirty local repo exists outside public clone | startcheck showed many modified local files and untracked `artifacts/`. | Samuel/Luis must not conflate local development state with public handoff. |
53
+
54
+ ## 6. Test / CI / verification situation
55
+ - Existing tests: pytest files cover CLI, routing, context packs, run tracking, dashboard helpers, web API, doctor, registry contracts, E2E mocks, and OpenCode delegation.
56
+ - CI config: no CI workflow file observed in the inspected public tree.
57
+ - How to run: README documents `python scripts/validate_skeleton.py`, `python -m zentrale validate`, `python -m zentrale doctor`, `python -m zentrale route`, `python -m zentrale serve --help`, and `uv run pytest -q`.
58
+ - Whether tests were run: not run in this execution.
59
+ - If not run: why not: verification commands may write caches/runtime files; the requested output is an audit artifact, not a test run.
60
+ - Risk: test status remains unproven for the exact public clone until a controlled verifier pass is run.
61
+
62
+ ## 7. Dependency / setup situation
63
+ - Package managers: Python package via setuptools; README uses both `python -m zentrale` and `uv run`.
64
+ - Lockfiles: `uv.lock` exists.
65
+ - Runtime assumptions: Python `>=3.11`; Textual, FastAPI, uvicorn, httpx; optional pytest.
66
+ - Missing setup docs: CI and isolated writable runtime/cache setup are not clearly specified.
67
+ - Fragile assumptions: local integration roots for KomandoZentral/OpenCode/MultiHarnessStudio; runtime writes under `projects/` and `runs/`; external harness binaries may be absent.
68
+
69
+ ## 8. Pre-existing local state
70
+ - Public temp clone state: `git status --short` was empty.
71
+ - Local repo caveat: `/home/smlflg/Projekte/Zentrale` is dirty with modified docs, dashboard, run tracking, validation, web routes, tests, and untracked `artifacts/`.
72
+ - Dirty state interpretation: local dirty state was documented as pre-existing and not treated as public audit output.
73
+
74
+ ## 9. NEEDS_HUMAN
75
+
76
+ | Question | Why human judgment is needed | Suggested reader |
77
+ |----------|------------------------------|------------------|
78
+ | Should harness execution run from project root or context-pack directory? | Current implementation chooses context-pack cwd, but product intent is ambiguous. | Samuel/Luis |
79
+ | Which phase list is canonical: registry or UI/API constants? | `review` exists in registry but not all surfaces. | Luis |
80
+ | Are web create/retry/start actions in scope for the handoff, or intentionally stubbed? | API returns 501 for key write actions. | Samuel |
81
+ | Should dirty local Zentrale changes be considered tomorrow? | Public clone and local working copy differ materially. | Samuel |
audits/zentrale/ARCHITECTURE_MAP.md ADDED
@@ -0,0 +1,98 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Architecture Map — Zentrale
2
+
3
+ ## 1. High-level map
4
+
5
+ Zentrale is a local orchestration skeleton with several layers:
6
+ - Operator entrypoints: CLI, Textual TUI screens, FastAPI server, static browser UI.
7
+ - Planning/config layer: JSON registries for harnesses, phases, and profiles; Markdown templates for context packs.
8
+ - Workflow layer: project scaffolding, routing, context-pack creation, run records, logs, learning proposals, and cost/effectiveness views.
9
+ - Integration layer: static routing, optional KommandoZentral routing, OpenCode delegation, integration-root checks.
10
+
11
+ ## 2. File / directory map
12
+
13
+ | Path | Role | Notes |
14
+ |------|------|-------|
15
+ | `README.md` | Main operator documentation | Describes goal, CLI, dashboard, web start, run loop, validation. |
16
+ | `pyproject.toml` | Package config | Defines `zentrale` script and dependencies. |
17
+ | `src/zentrale/cli.py` | Main command dispatcher | Implements most user-visible workflows. |
18
+ | `src/zentrale/routing.py` | Static and KZ-backed routing | Maps task text to harness/phase. |
19
+ | `src/zentrale/context_pack.py` | Context-pack generator | Writes Markdown bundles by project/phase/harness. |
20
+ | `src/zentrale/project_scaffold.py` | Project scaffolding | Creates project folders and metadata. |
21
+ | `src/zentrale/run_tracking.py` | Run persistence | Writes `RUN.json`, `log.json`, status, done criteria. |
22
+ | `src/zentrale/opencode_delegate.py` | OpenCode command/prompt adapter | Deepest concrete harness delegation path. |
23
+ | `src/zentrale/harness_runner.py` | Harness dispatch wrapper | Routes prompt execution to selected harness. |
24
+ | `src/zentrale/dashboard/` | Textual TUI screens | Runs, tasks, logs, quickrun, phases, costs. |
25
+ | `src/zentrale/web/` | FastAPI/WebSocket backend | Serves SPA and API routes. |
26
+ | `web/` and `src/zentrale/web/static/` | Static UI assets | Browser UI files appear in both source/static locations. |
27
+ | `registry/` | Machine-readable contracts | Harnesses, phases, profiles, md-register README. |
28
+ | `templates/` | Markdown templates | Project files and context-pack files. |
29
+ | `tests/` | Verification suite | Broad mocked tests for CLI, E2E, web, dashboard, contracts. |
30
+
31
+ ## 3. Entry points
32
+
33
+ | Entry point | Type | Evidence | Notes |
34
+ |-------------|------|----------|-------|
35
+ | `zentrale` | CLI script | `pyproject.toml` maps to `zentrale.cli:main`. | Main command surface. |
36
+ | `python -m zentrale` | Python module | `README.md`; module shims. | Alternate execution path. |
37
+ | `zentrale validate` | CLI verifier | `src/zentrale/cli.py`; `src/zentrale/validate.py`. | Skeleton validation. |
38
+ | `zentrale doctor` | CLI diagnostics | `src/zentrale/cli.py`; `src/zentrale/doctor.py`. | Checks dirs, templates, integration roots. |
39
+ | `zentrale route` | CLI routing | `src/zentrale/cli.py`; `routing.py`. | Static or KZ-backed route suggestion. |
40
+ | `zentrale context-pack` | CLI writer | `cli.py`; `context_pack.py`. | Writes phase/harness Markdown bundle. |
41
+ | `zentrale run` | CLI execution loop | `cli.py`; README. | Route, context-pack, run record, harness execution, logs, learning. |
42
+ | `zentrale dashboard` | TUI | `src/zentrale/dashboard/unified.py`. | Textual unified dashboard. |
43
+ | `zentrale serve` | Web server | `src/zentrale/web/app.py`. | FastAPI/WebSocket/SPA. |
44
+ | `/api/projects`, `/api/runs`, `/api/routes`, `/api/costs`, `/api/phases` | Web API | `src/zentrale/web/routes/*.py`. | Mixed read/stub surface. |
45
+
46
+ ## 4. Data/control flow
47
+
48
+ - User/input flow: user provides a project prompt, task, harness, phase, or verification criteria through CLI/TUI/Web.
49
+ - Agent/control flow: static routing or KomandoZentral output selects harness/phase; `run` builds a delegation prompt and dispatches through `run_harness_prompt`.
50
+ - Persistence/state flow: project scaffolds under `projects/`; context packs under project folders; run records/logs under `runs/`; learning proposals and effectiveness data through registry-learning helpers.
51
+ - External API/tool flow: OpenCode command execution is modeled; KomandoZentral can be invoked through a local subprocess; web server exposes local HTTP/WebSocket APIs.
52
+
53
+ ## 5. Interfaces and integration surfaces
54
+
55
+ | Interface | Direction | Evidence | Consolidation relevance |
56
+ |-----------|-----------|----------|-------------------------|
57
+ | CLI `zentrale` | inbound | `pyproject.toml`, `cli.py` | Primary operator/control interface. |
58
+ | JSON registries | internal/outbound | `registry/harnesses.json`, `phases.json`, `profiles.json` | Candidate shared contract. |
59
+ | Markdown context packs | outbound to harnesses | `context_pack.py`, `templates/context-pack/` | Concrete implementation of phase/harness-specific context. |
60
+ | Run records/logs | local persistence | `run_tracking.py` | Execution history and dashboard input. |
61
+ | KomandoZentral bridge | inbound/outbound subprocess | `routing.py`, `--use-kz`, `--live` | Direct overlap/integration with KZ. |
62
+ | OpenCode adapter | outbound subprocess | `opencode_delegate.py`, `harness_runner.py` | Most developed harness execution path. |
63
+ | FastAPI/WebSocket | inbound/outbound | `web/app.py`, `web/routes/`, `ws_manager.py` | Local UI/backend surface. |
64
+ | Static UI/TUI | operator UI | `web/`, `dashboard/` | Multiple UI patterns exist. |
65
+
66
+ ## 6. State and persistence
67
+
68
+ - Files: project scaffold Markdown/JSON, context-pack Markdown, `RUN.json`, `log.json`, `DONE_CRITERIA.md`, learning proposal files.
69
+ - Databases: no database observed in public clone.
70
+ - Logs: run logs under `runs/<run_id>/log.json`.
71
+ - Caches: package/test tooling may create caches; runtime state lives in repo-local project/run dirs.
72
+ - Runtime state: active run polling reads `runs/`; web init state reads projects and active runs.
73
+ - Unknowns: whether harness cwd should be project root, context-pack dir, or configurable.
74
+
75
+ ## 7. Configuration model
76
+
77
+ - Where config lives: JSON registries, Markdown templates, Python constants in `config.py`, CLI flags.
78
+ - How profiles/env vars are handled: profiles are registry-driven; external roots are checked by doctor/integration scripts.
79
+ - Secrets risk: no explicit secret store observed; external harness commands may inherit user environment.
80
+ - Missing config docs: exact writable-state locations and external binary/root requirements could be clearer.
81
+
82
+ ## 8. Architecture risks
83
+
84
+ | Risk | Evidence | Effect |
85
+ |------|----------|--------|
86
+ | Registry/constants drift | `registry/phases.json` includes `review`; `/api/phases` omits it. | Different surfaces disagree on valid phase lifecycle. |
87
+ | Write routes stubbed | Web project/run create/update/retry endpoints return 501. | Browser UI may not be feature-complete. |
88
+ | Harness cwd ambiguity | `cli.py` passes `cwd=pack_path` for harness execution. | Agent may not see intended project files. |
89
+ | Broad surface area | CLI, TUI, SPA, WebSocket, OpenCode, KZ, registries, learning. | More verification required before treating as stable. |
90
+ | Local/public drift | local Zentrale is dirty; public clone is clean. | Tomorrow's reader may see different behavior locally. |
91
+
92
+ ## 9. Open architecture questions
93
+
94
+ - Which surfaces are authoritative: CLI, TUI, Web API, or static SPA?
95
+ - Should registries be the only source for phases/harnesses/profiles?
96
+ - Should Zentrale call KommandoZentrale as a subprocess, library, API, or not at all?
97
+ - What is the intended working directory for delegated harness execution?
98
+ - Which local state directories are part of product behavior versus development artifacts?
audits/zentrale/NEXT_ISSUES.md ADDED
@@ -0,0 +1,104 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Next Issue Candidates — Zentrale
2
+
3
+ Diese Datei enthält nur Issue-Kandidaten.
4
+ Keine Issues erstellen.
5
+ Keine Labels erstellen.
6
+ Keine PRs öffnen.
7
+
8
+ ## Issue candidates
9
+
10
+ ### ISSUE-1: Decide Harness Execution Working Directory
11
+
12
+ - Type: product-contract/test
13
+ - Why this matters: Current `run` execution uses the context-pack directory as cwd.
14
+ - Evidence: `src/zentrale/cli.py` passes `cwd=pack_path` to `run_harness_prompt`.
15
+ - Suggested scope: Decide and document whether harnesses run in project root, context-pack dir, or configurable cwd.
16
+ - Non-goals: No harness adapter rewrite.
17
+ - Acceptance criteria: One test locks the selected cwd contract.
18
+ - Risk reduced: broken setup; harness-specific assumptions.
19
+ - Candidate Höhlengleichnis category: F — Vor-Entscheidung nötig.
20
+ - Human gate needed: yes.
21
+
22
+ ### ISSUE-2: Make Phase Definitions Registry-Backed Everywhere
23
+
24
+ - Type: data-contract/test
25
+ - Why this matters: `review` exists in the registry but is absent in API/constants.
26
+ - Evidence: `registry/phases.json`; `src/zentrale/web/routes/dashboard.py`; `src/zentrale/web/routes/projects.py`.
27
+ - Suggested scope: Read phase lists from registry or explicitly document derived subsets.
28
+ - Non-goals: No lifecycle redesign.
29
+ - Acceptance criteria: `/api/phases`, project phase ordering, and tests agree with the chosen source.
30
+ - Risk reduced: UI/backend mismatch; stale docs.
31
+ - Candidate Höhlengleichnis category: E — Komplementär.
32
+ - Human gate needed: yes.
33
+
34
+ ### ISSUE-3: Mark Web Write Routes As Stubbed Or Complete Them Later
35
+
36
+ - Type: docs/product-contract
37
+ - Why this matters: POST/PUT routes exist but raise 501.
38
+ - Evidence: `src/zentrale/web/routes/projects.py`, `src/zentrale/web/routes/runs.py`.
39
+ - Suggested scope: Add handoff note listing implemented vs stubbed web API actions.
40
+ - Non-goals: No implementation in audit phase.
41
+ - Acceptance criteria: README/API notes prevent readers from assuming create/retry/start works through web.
42
+ - Risk reduced: UI/backend mismatch.
43
+ - Candidate Höhlengleichnis category: F — Vor-Entscheidung nötig.
44
+ - Human gate needed: yes.
45
+
46
+ ### ISSUE-4: Add Context-Pack Contract Fixture
47
+
48
+ - Type: test/schema
49
+ - Why this matters: Context packs are a key asset and should have a stable shape.
50
+ - Evidence: `src/zentrale/context_pack.py`; `templates/context-pack/*.md`; `tests/test_context_pack.py`.
51
+ - Suggested scope: One fixture documents expected files and placeholder replacement for a representative harness/phase.
52
+ - Non-goals: No new MD-DB design.
53
+ - Acceptance criteria: Test and docs show exact generated context-pack layout.
54
+ - Risk reduced: architecture ambiguity; duplicated concept.
55
+ - Candidate Höhlengleichnis category: E — Komplementär.
56
+ - Human gate needed: no.
57
+
58
+ ### ISSUE-5: Clarify Static Routing Versus KommandoZentral Routing
59
+
60
+ - Type: docs/integration
61
+ - Why this matters: Zentrale can route locally or through KommandoZentral.
62
+ - Evidence: `src/zentrale/routing.py`; CLI flags `--live` and `--use-kz`.
63
+ - Suggested scope: Document when each route source is used and how output is mapped.
64
+ - Non-goals: No policy ownership decision.
65
+ - Acceptance criteria: A reader can predict route source for `route`, `route --live`, `run`, and `run --use-kz`.
66
+ - Risk reduced: duplicated concept; unclear ownership.
67
+ - Candidate Höhlengleichnis category: F — Vor-Entscheidung nötig.
68
+ - Human gate needed: yes.
69
+
70
+ ### ISSUE-6: Define Run Log Schema For Cost Views
71
+
72
+ - Type: data-contract/test
73
+ - Why this matters: Cost routes estimate from prompt/stdout/stderr/model fields.
74
+ - Evidence: `src/zentrale/web/routes/dashboard.py`; `src/zentrale/run_tracking.py`; `src/zentrale/opencode_delegate.py`.
75
+ - Suggested scope: Add a minimal log schema fixture used by cost CLI/API tests.
76
+ - Non-goals: No pricing model redesign.
77
+ - Acceptance criteria: Generated logs contain or explicitly omit fields consumed by cost views.
78
+ - Risk reduced: hidden state; no verification path.
79
+ - Candidate Höhlengleichnis category: E — Komplementär.
80
+ - Human gate needed: no.
81
+
82
+ ### ISSUE-7: Separate Read-Only Diagnostics From Writing Commands
83
+
84
+ - Type: docs/ops
85
+ - Why this matters: Some commands inspect, while others create project/run artifacts.
86
+ - Evidence: `validate` and `doctor` are mostly read paths; `context-pack`, `run`, `retry` write files.
87
+ - Suggested scope: Add a command safety table to README.
88
+ - Non-goals: No CLI redesign.
89
+ - Acceptance criteria: Operators know which commands mutate `projects/`, `runs/`, or project files.
90
+ - Risk reduced: code drift; hidden state.
91
+ - Candidate Höhlengleichnis category: E — Komplementär.
92
+ - Human gate needed: no.
93
+
94
+ ### ISSUE-8: Reconcile Public Clone And Local Dirty Snapshot
95
+
96
+ - Type: handoff
97
+ - Why this matters: Samuel's local repo contains modified files not in public clone.
98
+ - Evidence: startcheck `git status --short` for `/home/smlflg/Projekte/Zentrale`.
99
+ - Suggested scope: Decide whether Luis reviews public HEAD or local dirty snapshot.
100
+ - Non-goals: No commit, no push, no branch.
101
+ - Acceptance criteria: Tomorrow's review input is explicitly named.
102
+ - Risk reduced: unclear ownership; stale docs.
103
+ - Candidate Höhlengleichnis category: F — Vor-Entscheidung nötig.
104
+ - Human gate needed: yes.
audits/zentrale/RISK_REGISTER.md ADDED
@@ -0,0 +1,30 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Risk Register — Zentrale
2
+
3
+ ## Risk summary
4
+
5
+ Zentrale is the broadest implemented control-tower prototype in the audited set, with real local state and harness delegation paths. Its main risks are surface-area complexity, contract drift, runtime write behavior, and unclear boundaries with KommandoZentrale and MegaHarness doctrine.
6
+
7
+ ## Risk table
8
+
9
+ | ID | Risk | Evidence | Severity | Likelihood | Impact | Possible mitigation | NEEDS_HUMAN |
10
+ |----|------|----------|----------|------------|--------|---------------------|-------------|
11
+ | Z-R1 | Phase contract drift | `registry/phases.json` includes `review`; `/api/phases` and `_PHASE_ORDER` omit it. | high | high | UI/API/tests may disagree with registry-backed workflows. | Make one phase source canonical after review. | yes |
12
+ | Z-R2 | Harness execution root ambiguity | `src/zentrale/cli.py` uses `cwd=pack_path` for `run_harness_prompt`. | high | medium | Agents may operate on context docs instead of project source. | Decide intended cwd and document/test it. | yes |
13
+ | Z-R3 | Write-heavy commands | `context_pack.py`, `run_tracking.py`, `registry_learning.py`, `append_done_criteria()`. | medium | high | Accidental artifact churn during audits or dry runs. | Separate read-only diagnostics from execution commands. | no |
14
+ | Z-R4 | Web write routes are stubs | `projects.py` and `runs.py` POST/PUT routes raise 501. | medium | high | Browser UI may imply unimplemented workflows. | Label stubs or hide write controls until implemented. | yes |
15
+ | Z-R5 | Routing duplication | `routing.py` static rules and KZ bridge coexist with KZ's own policy. | high | high | Divergent recommendations and unclear ownership. | Treat as consolidation input, not verdict. | yes |
16
+ | Z-R6 | Cost/log data mismatch | Cost routes read `stdout`/`stderr`; generated log shape needs explicit contract. | medium | medium | Cost dashboard can undercount or mislead. | Add log schema test and dashboard fixture. | no |
17
+ | Z-R7 | External tool fragility | OpenCode, KomandoZentral, MultiHarness roots are assumed by docs/doctor. | medium | medium | Setup works only on Samuel's machine unless documented. | Produce environment checklist. | no |
18
+ | Z-R8 | Local dirty state divergence | startcheck showed modified local files and untracked `artifacts/`. | high | high | Luis may inspect local behavior that differs from public handoff. | Explicitly choose public clone or local dirty snapshot for review. | yes |
19
+
20
+ ## Top 3 risks for Samuel tomorrow
21
+
22
+ - Local Zentrale is dirty and may not match the public handoff.
23
+ - Harness execution cwd could send agents into the context-pack folder rather than the project.
24
+ - Web/API/TUI surfaces are broad; not every displayed workflow is necessarily implemented.
25
+
26
+ ## Top 3 risks for Luis' consolidation work
27
+
28
+ - Zentrale overlaps with KommandoZentrale on routing and with MegaHarness on context/MD orchestration concepts.
29
+ - Registry and UI/API phase definitions are not fully aligned.
30
+ - The repo contains live execution machinery, so code-level maturity is not comparable to doctrine-only MegaHarness.
briefings/01_audit_kommandozentrale.md ADDED
@@ -0,0 +1,219 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # READY — READ_ONLY_AUDIT — KommandoZentrale
2
+
3
+ ## Mission
4
+
5
+ Audit the public/local repo `smlfg/KommandoZentrale`.
6
+
7
+ Your job is not to improve code.
8
+ Your job is to produce compact audit artifacts for Samuel and Luis so they can understand this repo’s current shape, risks, reusable parts, and consolidation relevance.
9
+
10
+ ## Absolute Rules
11
+
12
+ - READ ONLY for the source repo.
13
+ - Do not create branches.
14
+ - Do not commit.
15
+ - Do not push.
16
+ - Do not open PRs.
17
+ - Do not refactor.
18
+ - Do not modify repo files.
19
+ - The only allowed writes are under:
20
+
21
+ `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/`
22
+
23
+ If you detect that the task requires a consolidation verdict, architecture anchor decision, or repo-archive decision: STOP that line of reasoning and mark it as `NEEDS_HUMAN`.
24
+
25
+ Luis owns the final consolidation decision. Do not preempt Luis.
26
+
27
+ ## Context Files To Read If Available
28
+
29
+ Read these first if they exist:
30
+
31
+ - `/home/smlflg/Projekte/megaHarness/BRIEFING_LUIS.md`
32
+ - `/home/smlflg/Projekte/megaHarness/Höhlengleichnis.md`
33
+
34
+ If unavailable, continue. Do not block.
35
+
36
+ ## Allowed Investigation
37
+
38
+ You may use:
39
+
40
+ - `find`
41
+ - `rg`
42
+ - `tree`
43
+ - `git status`
44
+ - `git log --oneline --decorate -n 30`
45
+ - reading source files
46
+ - reading docs
47
+ - reading configs
48
+ - reading tests
49
+ - reading package/build files
50
+
51
+ Before and after the audit, run `git status --short` for the audited repo and record the result.
52
+
53
+ ## Required Output Files
54
+
55
+ Write exactly these files:
56
+
57
+ 1. `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/AGENT_FINDINGS.md`
58
+ 2. `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/ARCHITECTURE_MAP.md`
59
+ 3. `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/RISK_REGISTER.md`
60
+ 4. `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/NEXT_ISSUES.md`
61
+
62
+ ## AGENT_FINDINGS.md Structure
63
+
64
+ Use this structure:
65
+
66
+ ```md
67
+ # KommandoZentrale — Agent Findings
68
+
69
+ ## Audit Scope
70
+ - Repo:
71
+ - Local path or remote:
72
+ - Time:
73
+ - Mode: READ_ONLY_AUDIT
74
+ - Source git status before:
75
+ - Source git status after:
76
+
77
+ ## Executive Summary
78
+ 5-10 bullets. Facts only.
79
+
80
+ ## What This Repo Appears To Be
81
+ Short factual description. No verdict.
82
+
83
+ ## Strongest Assets
84
+ Table:
85
+ | Asset | Evidence Path | Why It Matters | Confidence |
86
+
87
+ ## Main Weaknesses / Gaps
88
+ Table:
89
+ | Gap | Evidence Path | Impact | Confidence |
90
+
91
+ ## Reusable Components For Future Tower Work
92
+ Table:
93
+ | Component | Path | Reuse Type | Notes |
94
+
95
+ ## Consolidation-Relevant Observations
96
+ Facts only. No recommendation.
97
+
98
+ ## NEEDS_HUMAN
99
+ List anything uncertain, ambiguous, or decision-shaped.
100
+ ```
101
+
102
+ ## ARCHITECTURE_MAP.md Structure
103
+
104
+ Use this structure:
105
+
106
+ ```md
107
+ # KommandoZentrale — Architecture Map
108
+
109
+ ## Repo Shape
110
+ Compact directory map. Avoid raw full tree dumps.
111
+
112
+ ## Entrypoints
113
+ Table:
114
+ | Entrypoint | Path | Purpose | Evidence |
115
+
116
+ ## Main Layers / Modules
117
+ Table:
118
+ | Layer / Module | Path | Responsibility | Notes |
119
+
120
+ ## Data / Config Flow
121
+ Facts about configuration, persistence, external services, env vars, and runtime assumptions.
122
+
123
+ ## Dependencies
124
+ Table:
125
+ | Dependency | Evidence Path | Usage | Risk / Note |
126
+
127
+ ## Tests / CI / Quality Gates
128
+ Table:
129
+ | Check | Path / Command | Exists? | Notes |
130
+
131
+ ## Interfaces Relevant To Consolidation
132
+ Facts only. No architecture verdict.
133
+
134
+ ## Unknowns
135
+ List unclear parts.
136
+ ```
137
+
138
+ ## RISK_REGISTER.md Structure
139
+
140
+ Use this structure:
141
+
142
+ ```md
143
+ # KommandoZentrale — Risk Register
144
+
145
+ ## Risk Table
146
+ | Risk | Evidence Path | Impact | Likelihood | Suggested Verifier | Owner / Needs Human |
147
+
148
+ ## Test Coverage Gaps
149
+ Table:
150
+ | Gap | Evidence Path | Why It Matters | Suggested Test / Check |
151
+
152
+ ## Operational / Maintenance Risks
153
+ Facts only.
154
+
155
+ ## Security / Secret Handling Observations
156
+ Mention only evidence-backed observations. Do not print secrets.
157
+
158
+ ## NEEDS_HUMAN
159
+ Decision-shaped or ambiguous risks.
160
+ ```
161
+
162
+ ## NEXT_ISSUES.md Structure
163
+
164
+ Use this structure:
165
+
166
+ ```md
167
+ # KommandoZentrale — Candidate Next Issues
168
+
169
+ These are candidate issue drafts only. Do not create GitHub issues.
170
+
171
+ ## Candidate Issues
172
+
173
+ ### 1. <Title>
174
+ - Type:
175
+ - Evidence:
176
+ - Why it matters:
177
+ - Suggested acceptance check:
178
+ - Decision owner / NEEDS_HUMAN:
179
+
180
+ ### 2. <Title>
181
+ - Type:
182
+ - Evidence:
183
+ - Why it matters:
184
+ - Suggested acceptance check:
185
+ - Decision owner / NEEDS_HUMAN:
186
+
187
+ ## Non-Issues / Do Not File Yet
188
+ Items that look tempting but require Luis/Samuel decision first.
189
+
190
+ ## Questions For Samuel / Luis
191
+ Short list.
192
+ ```
193
+
194
+ ## Stop Conditions
195
+
196
+ Stop and mark `NEEDS_HUMAN` if:
197
+
198
+ - the repo identity is ambiguous;
199
+ - the repo is not publicly reachable and no local path is available;
200
+ - the local repo has unexpected uncommitted changes that affect interpretation;
201
+ - the audit would require source repo writes;
202
+ - the audit would require credentials;
203
+ - the finding becomes a consolidation verdict, archive decision, or architecture-anchor decision.
204
+
205
+ ## Final Response Format
206
+
207
+ When finished, respond only with:
208
+
209
+ ```text
210
+ READ_ONLY_AUDIT complete: KommandoZentrale
211
+ Artifacts:
212
+ - <path>
213
+ - <path>
214
+ - <path>
215
+ - <path>
216
+ Source git status before: <short summary>
217
+ Source git status after: <short summary>
218
+ NEEDS_HUMAN: <count + one-line summary>
219
+ ```
briefings/02_audit_zentrale.md ADDED
@@ -0,0 +1,136 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # READY Briefing 02 - Audit Zentrale
2
+
3
+ ## Job Contract
4
+
5
+ Mode: `READ_ONLY_AUDIT`
6
+ Repo: `smlfg/Zentrale`
7
+ Source clone: `/tmp/project-intake-tower-src-2026-05-04/zentrale`
8
+ Output directory: `/home/smlflg/Projekte/ProjectIntakeTower/audits/zentrale`
9
+ Branch: `master`
10
+ Commit: `315399689d17af2119c71ef83fd0bd3192dbb11f`
11
+
12
+ Your task is to convert uncertainty into local Markdown artifacts. Spend tokens on reading, mapping, checking, comparing, and documenting. Do not modify code.
13
+
14
+ ## Non-Negotiable Constraints
15
+
16
+ - Read only from the source clone and reference docs.
17
+ - Write only inside the output directory listed above.
18
+ - Do not edit the source clone, existing local worktrees, or any GitHub state.
19
+ - Do not create a branch, commit, push, issue, label, or pull request.
20
+ - Do not install dependencies unless a no-network, already-present environment makes a documented verifier possible.
21
+ - Do not make an anchor-repo recommendation.
22
+ - Do not decide what should be archived, kept, merged, or used as target architecture.
23
+ - If a question requires Samuel or Luis, mark `NEEDS_HUMAN` and explain the missing decision.
24
+
25
+ ## Reference Docs
26
+
27
+ Read these only to understand boundaries and vocabulary:
28
+
29
+ - `/home/smlflg/Projekte/megaHarness/Höhlengleichnis.md`
30
+ - `/home/smlflg/Projekte/megaHarness/BRIEFING_LUIS.md`
31
+ - `/home/smlflg/Projekte/HarnessEcosystem/docs/gpt5-4-shift-report.md`
32
+
33
+ Luis owns the consolidation verdict. You provide factual audit material.
34
+
35
+ ## Required Output Files
36
+
37
+ Create exactly these files:
38
+
39
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/zentrale/AGENT_FINDINGS.md`
40
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/zentrale/ARCHITECTURE_MAP.md`
41
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/zentrale/RISK_REGISTER.md`
42
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/zentrale/NEXT_ISSUES.md`
43
+
44
+ ## Audit Procedure
45
+
46
+ 1. Record source snapshot: repo URL, branch, commit SHA, top-level files, and any obvious entrypoints.
47
+ 2. Read `README.md`, `DEVELOP.md`, `AGENTS.md`, `pyproject.toml`, `docs/`, `registry/`, `src/zentrale/`, `zentrale/`, `web/`, scripts, and tests.
48
+ 3. Identify CLI, TUI, FastAPI/web, dashboard, registry, context-pack, run-tracking, harness-runner, and integration surfaces.
49
+ 4. Map how projects, profiles, phases, harnesses, context packs, and run artifacts move through the system.
50
+ 5. Compare docs against code only as factual drift, not as a verdict.
51
+ 6. Inspect tests for coverage shape and missing high-risk behavior.
52
+ 7. Prioritize top findings by operational relevance to Agent Control Tower consolidation.
53
+
54
+ ## File Schemas
55
+
56
+ ### AGENT_FINDINGS.md
57
+
58
+ Use:
59
+
60
+ ```markdown
61
+ # Zentrale - Agent Findings
62
+
63
+ ## Source Snapshot
64
+ | Field | Value |
65
+ |---|---|
66
+ | Repo | smlfg/Zentrale |
67
+ | Source clone | /tmp/project-intake-tower-src-2026-05-04/zentrale |
68
+ | Branch | master |
69
+ | Commit | 315399689d17af2119c71ef83fd0bd3192dbb11f |
70
+
71
+ ## Executive Summary
72
+ 5-8 bullets max.
73
+
74
+ ## Top Findings
75
+ | Priority | Finding | Evidence | Why It Matters |
76
+ |---:|---|---|---|
77
+
78
+ ## Confirmed Facts
79
+ - ...
80
+
81
+ ## NEEDS_HUMAN
82
+ - ...
83
+ ```
84
+
85
+ ### ARCHITECTURE_MAP.md
86
+
87
+ Use tables for:
88
+
89
+ - Entrypoints.
90
+ - Core modules.
91
+ - Registry/data contracts.
92
+ - Web/API/TUI surfaces.
93
+ - Data flow.
94
+ - External tool interfaces.
95
+ - Tests and verifiers.
96
+ - Documentation/code drift.
97
+
98
+ ### RISK_REGISTER.md
99
+
100
+ Use:
101
+
102
+ ```markdown
103
+ # Risk Register
104
+
105
+ | Priority | Risk | Impact | Likelihood | Evidence | Mitigation Candidate | Needs Human? |
106
+ |---:|---|---|---|---|---|---|
107
+ ```
108
+
109
+ ### NEXT_ISSUES.md
110
+
111
+ Write 5-10 issue candidates:
112
+
113
+ ```markdown
114
+ ## Issue Candidate N - Title
115
+
116
+ - Type: audit/doc/test/verifier/small-fix
117
+ - Suggested A-F category: A/B/C/D/E/F/provisional
118
+ - Evidence:
119
+ - Why now:
120
+ - Acceptance criteria:
121
+ - Human decision needed:
122
+ ```
123
+
124
+ The A-F category is only a provisional suggestion from the Höhlengleichnis vocabulary. Do not present it as final.
125
+
126
+ ## Stop Conditions
127
+
128
+ Stop only the unsafe part, not the whole audit, if:
129
+
130
+ - Scope expands into consolidation decision.
131
+ - You need to mutate source code.
132
+ - You need network or secrets.
133
+ - You cannot separate facts from recommendations.
134
+ - You are about to decide Luis' architecture question.
135
+
136
+ Document any such case under `NEEDS_HUMAN`.
briefings/03_audit_megaharness.md ADDED
@@ -0,0 +1,141 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # READY Briefing 03 - Audit MegaHarness
2
+
3
+ ## Job Contract
4
+
5
+ Mode: `READ_ONLY_AUDIT`
6
+ Repo: `smlfg/MegaHarness`
7
+ Source clone: `/tmp/project-intake-tower-src-2026-05-04/megaharness`
8
+ Output directory: `/home/smlflg/Projekte/ProjectIntakeTower/audits/megaharness`
9
+ Branch: `master`
10
+ Commit: `452f9d5ebfb4e6b5f569b1804fdcfe880e08629e`
11
+
12
+ Your task is to convert uncertainty into local Markdown artifacts. Spend tokens on reading, mapping, checking, comparing, and documenting. Do not modify code.
13
+
14
+ ## Non-Negotiable Constraints
15
+
16
+ - Read only from the source clone and reference docs.
17
+ - Write only inside the output directory listed above.
18
+ - Do not edit the source clone, existing local worktrees, or any GitHub state.
19
+ - Do not create a branch, commit, push, issue, label, or pull request.
20
+ - Do not install dependencies.
21
+ - Do not make an anchor-repo recommendation.
22
+ - Do not decide what should be archived, kept, merged, or used as target architecture.
23
+ - If a question requires Samuel or Luis, mark `NEEDS_HUMAN` and explain the missing decision.
24
+
25
+ ## Reference Docs
26
+
27
+ For this audit, the source clone itself contains the key doctrine docs:
28
+
29
+ - `/tmp/project-intake-tower-src-2026-05-04/megaharness/ARCHITECTURE.md`
30
+ - `/tmp/project-intake-tower-src-2026-05-04/megaharness/Artefakt_USP.md`
31
+ - `/tmp/project-intake-tower-src-2026-05-04/megaharness/Höhlengleichnis.md`
32
+ - `/tmp/project-intake-tower-src-2026-05-04/megaharness/BRIEFING_LUIS.md`
33
+ - `/tmp/project-intake-tower-src-2026-05-04/megaharness/idea`
34
+
35
+ Also read:
36
+
37
+ - `/home/smlflg/Projekte/HarnessEcosystem/docs/gpt5-4-shift-report.md`
38
+
39
+ Luis owns the consolidation verdict. You provide factual audit material about the doctrine repository and its implementation gap.
40
+
41
+ ## Required Output Files
42
+
43
+ Create exactly these files:
44
+
45
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/megaharness/AGENT_FINDINGS.md`
46
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/megaharness/ARCHITECTURE_MAP.md`
47
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/megaharness/RISK_REGISTER.md`
48
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/megaharness/NEXT_ISSUES.md`
49
+
50
+ ## Audit Procedure
51
+
52
+ 1. Record source snapshot: repo URL, branch, commit SHA, top-level files, and artifact-only nature of the repo.
53
+ 2. Read every source document in the clone.
54
+ 3. Extract the intended layers, routing doctrine, build-vs-integrate heuristics, Höhlengleichnis A-F categories, and Luis handoff boundaries.
55
+ 4. Map what is doctrine, what is plan, what is accepted constraint, and what is missing implementation.
56
+ 5. Compare docs against each other only as factual tension, not as a verdict.
57
+ 6. Identify testability and verifier gaps for a doctrine-first repo.
58
+ 7. Prioritize top findings by usefulness to Samuel and Luis tomorrow morning.
59
+
60
+ ## File Schemas
61
+
62
+ ### AGENT_FINDINGS.md
63
+
64
+ Use:
65
+
66
+ ```markdown
67
+ # MegaHarness - Agent Findings
68
+
69
+ ## Source Snapshot
70
+ | Field | Value |
71
+ |---|---|
72
+ | Repo | smlfg/MegaHarness |
73
+ | Source clone | /tmp/project-intake-tower-src-2026-05-04/megaharness |
74
+ | Branch | master |
75
+ | Commit | 452f9d5ebfb4e6b5f569b1804fdcfe880e08629e |
76
+
77
+ ## Executive Summary
78
+ 5-8 bullets max.
79
+
80
+ ## Top Findings
81
+ | Priority | Finding | Evidence | Why It Matters |
82
+ |---:|---|---|---|
83
+
84
+ ## Confirmed Facts
85
+ - ...
86
+
87
+ ## NEEDS_HUMAN
88
+ - ...
89
+ ```
90
+
91
+ ### ARCHITECTURE_MAP.md
92
+
93
+ Use tables for:
94
+
95
+ - Doctrine documents.
96
+ - Intended layers.
97
+ - Proposed data stores or MD-DB concepts.
98
+ - Harness surfaces.
99
+ - Decision vocabulary.
100
+ - Gaps between doctrine and executable code.
101
+ - References useful to Luis.
102
+
103
+ ### RISK_REGISTER.md
104
+
105
+ Use:
106
+
107
+ ```markdown
108
+ # Risk Register
109
+
110
+ | Priority | Risk | Impact | Likelihood | Evidence | Mitigation Candidate | Needs Human? |
111
+ |---:|---|---|---|---|---|---|
112
+ ```
113
+
114
+ ### NEXT_ISSUES.md
115
+
116
+ Write 5-10 issue candidates:
117
+
118
+ ```markdown
119
+ ## Issue Candidate N - Title
120
+
121
+ - Type: audit/doc/test/verifier/small-fix
122
+ - Suggested A-F category: A/B/C/D/E/F/provisional
123
+ - Evidence:
124
+ - Why now:
125
+ - Acceptance criteria:
126
+ - Human decision needed:
127
+ ```
128
+
129
+ The A-F category is only a provisional suggestion from the Höhlengleichnis vocabulary. Do not present it as final.
130
+
131
+ ## Stop Conditions
132
+
133
+ Stop only the unsafe part, not the whole audit, if:
134
+
135
+ - Scope expands into consolidation decision.
136
+ - You need to mutate source code.
137
+ - You need network or secrets.
138
+ - You cannot separate facts from recommendations.
139
+ - You are about to decide Luis' architecture question.
140
+
141
+ Document any such case under `NEEDS_HUMAN`.
briefings/04_aggregator.md ADDED
@@ -0,0 +1,104 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # READY Briefing 04 - Cross-Repo Aggregator
2
+
3
+ ## Job Contract
4
+
5
+ Mode: `READ_ONLY_SYNTHESIS`
6
+ Input directory: `/home/smlflg/Projekte/ProjectIntakeTower/audits`
7
+ Output file: `/home/smlflg/Projekte/ProjectIntakeTower/audits/TOWER_HEALTH_OVERVIEW.md`
8
+
9
+ Your task is to synthesize the three completed read-only audits into one five-minute cross-repo overview for Samuel and Luis. Do not read source repos unless an audit artifact is missing a critical source snapshot field. Prefer the audit artifacts as the source of truth for this synthesis.
10
+
11
+ ## Non-Negotiable Constraints
12
+
13
+ - Write only the output file listed above.
14
+ - Do not edit the three repo audit folders except for reading their Markdown files.
15
+ - Do not edit source clones or existing local worktrees.
16
+ - Do not create a branch, commit, push, issue, label, or pull request.
17
+ - Do not make an anchor-repo recommendation.
18
+ - Do not decide what should be archived, kept, merged, or used as target architecture.
19
+ - Do not write a consolidation sequence as a verdict.
20
+ - If the input artifacts are incomplete, mark the gap and continue with partial synthesis.
21
+
22
+ ## Required Inputs
23
+
24
+ Read these files if present:
25
+
26
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/AGENT_FINDINGS.md`
27
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/ARCHITECTURE_MAP.md`
28
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/RISK_REGISTER.md`
29
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/kommandozentrale/NEXT_ISSUES.md`
30
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/zentrale/AGENT_FINDINGS.md`
31
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/zentrale/ARCHITECTURE_MAP.md`
32
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/zentrale/RISK_REGISTER.md`
33
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/zentrale/NEXT_ISSUES.md`
34
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/megaharness/AGENT_FINDINGS.md`
35
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/megaharness/ARCHITECTURE_MAP.md`
36
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/megaharness/RISK_REGISTER.md`
37
+ - `/home/smlflg/Projekte/ProjectIntakeTower/audits/megaharness/NEXT_ISSUES.md`
38
+
39
+ ## Output Schema
40
+
41
+ Create:
42
+
43
+ `/home/smlflg/Projekte/ProjectIntakeTower/audits/TOWER_HEALTH_OVERVIEW.md`
44
+
45
+ Use exactly this structure:
46
+
47
+ ```markdown
48
+ # Tower Health Overview
49
+
50
+ ## No Architecture Verdict
51
+ Short statement that this file is facts and synthesis only. Luis owns the consolidation decision.
52
+
53
+ ## Source Snapshot
54
+ | Repo | Source | Branch | Commit | Audit Complete? | Missing Inputs |
55
+ |---|---|---|---|---|---|
56
+
57
+ ## Five-Minute Executive Summary
58
+ 5-8 bullets max.
59
+
60
+ ## Capability Comparison
61
+ | Capability | KommandoZentrale | Zentrale | MegaHarness | Notes |
62
+ |---|---|---|---|---|
63
+
64
+ ## Overlap And Duplication Map
65
+ | Theme | Repos Involved | Evidence | Why It Matters |
66
+ |---|---|---|---|
67
+
68
+ ## Shared Risk Themes
69
+ | Priority | Risk Theme | Repos | Evidence | Human Decision Needed? |
70
+ |---:|---|---|---|---|
71
+
72
+ ## Test And Verifier Gaps
73
+ | Repo | Existing Signal | Gap | Suggested Next Check |
74
+ |---|---|---|---|
75
+
76
+ ## NEEDS_HUMAN Index
77
+ | Repo | Item | Why Human |
78
+ |---|---|---|
79
+
80
+ ## Tomorrow Morning Review Checklist
81
+ - [ ] ...
82
+
83
+ ## Next Issue Queue Without Verdict
84
+ | Priority | Repo | Issue Candidate | Type | Why Now |
85
+ |---:|---|---|---|---|
86
+ ```
87
+
88
+ ## Synthesis Rules
89
+
90
+ - Merge duplicate risks into themes, but keep repo-specific evidence.
91
+ - Prefer tables over prose.
92
+ - Keep each section short enough to scan.
93
+ - Name missing inputs explicitly.
94
+ - If a statement is an inference, label it as inference.
95
+ - Avoid words like "anchor", "archive", "consolidate into", "should be foundation", or equivalent verdict language except in the explicit "No Architecture Verdict" disclaimer.
96
+
97
+ ## Stop Conditions
98
+
99
+ Mark `NEEDS_HUMAN` if:
100
+
101
+ - The audits conflict on facts.
102
+ - A repo audit is missing.
103
+ - The only useful summary would require choosing an architecture direction.
104
+ - The synthesis would create a verdict that belongs to Luis.
index.html ADDED
@@ -0,0 +1,334 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <!doctype html>
2
+ <html lang="de">
3
+ <head>
4
+ <meta charset="utf-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
6
+ <title>Owner Packet Viewer</title>
7
+ <style>
8
+ :root {
9
+ color-scheme: dark;
10
+ font-family:
11
+ Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
12
+ background: #111417;
13
+ color: #eef2ef;
14
+ }
15
+
16
+ * {
17
+ box-sizing: border-box;
18
+ }
19
+
20
+ body {
21
+ min-height: 100vh;
22
+ margin: 0;
23
+ background: #111417;
24
+ }
25
+
26
+ button,
27
+ textarea {
28
+ font: inherit;
29
+ }
30
+
31
+ .shell {
32
+ min-height: 100vh;
33
+ display: grid;
34
+ grid-template-rows: auto minmax(0, 1fr);
35
+ gap: 16px;
36
+ padding: 18px;
37
+ }
38
+
39
+ header,
40
+ main {
41
+ width: min(980px, 100%);
42
+ margin: 0 auto;
43
+ }
44
+
45
+ header {
46
+ display: grid;
47
+ grid-template-columns: minmax(0, 1fr) auto;
48
+ gap: 16px;
49
+ align-items: end;
50
+ border-bottom: 1px solid #2c3533;
51
+ padding-bottom: 14px;
52
+ }
53
+
54
+ .eyebrow,
55
+ .label {
56
+ color: #93a09b;
57
+ font-size: 0.73rem;
58
+ font-weight: 800;
59
+ letter-spacing: 0;
60
+ text-transform: uppercase;
61
+ }
62
+
63
+ h1 {
64
+ margin: 4px 0 0;
65
+ font-size: clamp(1.5rem, 3vw, 2.35rem);
66
+ line-height: 1.08;
67
+ }
68
+
69
+ .status {
70
+ min-width: 150px;
71
+ border: 1px solid #40514d;
72
+ border-radius: 8px;
73
+ padding: 10px 12px;
74
+ color: #a7f0dd;
75
+ text-align: center;
76
+ font-weight: 800;
77
+ }
78
+
79
+ main {
80
+ display: grid;
81
+ grid-template-columns: minmax(0, 1fr) minmax(260px, 320px);
82
+ gap: 16px;
83
+ align-items: start;
84
+ }
85
+
86
+ .packet,
87
+ .side {
88
+ border: 1px solid #293331;
89
+ border-radius: 8px;
90
+ background: #171d20;
91
+ box-shadow: 0 20px 50px rgba(0, 0, 0, 0.24);
92
+ }
93
+
94
+ .packet {
95
+ padding: 22px;
96
+ }
97
+
98
+ .question {
99
+ margin: 8px 0 14px;
100
+ font-size: 1.42rem;
101
+ line-height: 1.22;
102
+ }
103
+
104
+ .context {
105
+ margin: 0;
106
+ color: #c7d0cb;
107
+ line-height: 1.55;
108
+ }
109
+
110
+ .field {
111
+ display: grid;
112
+ gap: 7px;
113
+ margin-top: 18px;
114
+ }
115
+
116
+ .value {
117
+ border-left: 3px solid #6de0c9;
118
+ padding: 11px 13px;
119
+ background: #20322f;
120
+ color: #f6fbf9;
121
+ line-height: 1.45;
122
+ }
123
+
124
+ .risk {
125
+ border-left-color: #ffc56f;
126
+ background: #33291b;
127
+ }
128
+
129
+ .actions {
130
+ display: grid;
131
+ grid-template-columns: repeat(3, minmax(0, 1fr));
132
+ gap: 10px;
133
+ margin-top: 22px;
134
+ }
135
+
136
+ .action {
137
+ min-height: 44px;
138
+ border: 0;
139
+ border-radius: 8px;
140
+ color: #06110e;
141
+ font-weight: 850;
142
+ cursor: pointer;
143
+ }
144
+
145
+ .action:disabled {
146
+ cursor: default;
147
+ opacity: 0.45;
148
+ }
149
+
150
+ .action.selected {
151
+ box-shadow: 0 0 0 3px rgba(238, 242, 239, 0.32);
152
+ }
153
+
154
+ [data-action="Approve"] {
155
+ background: #6de0c9;
156
+ }
157
+
158
+ [data-action="Reject"] {
159
+ background: #ff8d8d;
160
+ }
161
+
162
+ [data-action="Ask"] {
163
+ background: #ffc56f;
164
+ }
165
+
166
+ .side {
167
+ display: grid;
168
+ gap: 16px;
169
+ padding: 18px;
170
+ }
171
+
172
+ textarea {
173
+ min-height: 180px;
174
+ resize: vertical;
175
+ border: 1px solid #40514d;
176
+ border-radius: 8px;
177
+ padding: 12px;
178
+ outline: none;
179
+ background: #0d1113;
180
+ color: #eef2ef;
181
+ }
182
+
183
+ textarea:focus {
184
+ border-color: #6de0c9;
185
+ box-shadow: 0 0 0 3px rgba(109, 224, 201, 0.13);
186
+ }
187
+
188
+ .decision {
189
+ min-height: 48px;
190
+ border: 1px solid #40514d;
191
+ border-radius: 8px;
192
+ padding: 12px;
193
+ color: #c7d0cb;
194
+ }
195
+
196
+ .error {
197
+ color: #ffabab;
198
+ }
199
+
200
+ @media (max-width: 760px) {
201
+ header,
202
+ main {
203
+ grid-template-columns: 1fr;
204
+ }
205
+
206
+ .status {
207
+ text-align: left;
208
+ }
209
+
210
+ .actions {
211
+ grid-template-columns: 1fr;
212
+ }
213
+ }
214
+ </style>
215
+ </head>
216
+ <body>
217
+ <div class="shell">
218
+ <header>
219
+ <div>
220
+ <div class="eyebrow">Owner Packet</div>
221
+ <h1 id="project">Loading packet</h1>
222
+ </div>
223
+ <div class="status" id="status">loading</div>
224
+ </header>
225
+
226
+ <main>
227
+ <section class="packet" aria-label="Owner decision packet">
228
+ <div class="label">Question</div>
229
+ <h2 class="question" id="question">Loading owner_packet.json...</h2>
230
+ <p class="context" id="context"></p>
231
+
232
+ <div class="field">
233
+ <div class="label">Recommended action</div>
234
+ <div class="value" id="recommendedAction"></div>
235
+ </div>
236
+
237
+ <div class="field">
238
+ <div class="label">Risk</div>
239
+ <div class="value risk" id="risk"></div>
240
+ </div>
241
+
242
+ <div class="actions" id="actions" aria-label="Decision actions"></div>
243
+ </section>
244
+
245
+ <aside class="side" aria-label="Local owner note">
246
+ <div>
247
+ <div class="label">Local decision</div>
248
+ <div class="decision" id="decision">No decision selected.</div>
249
+ </div>
250
+
251
+ <label class="label" for="note">Local note</label>
252
+ <textarea id="note" placeholder="Private local note. Not written back to owner_packet.json."></textarea>
253
+ </aside>
254
+ </main>
255
+ </div>
256
+
257
+ <script>
258
+ const noteKey = "project-intake-tower.owner-note";
259
+ const selectedKey = "project-intake-tower.owner-decision";
260
+
261
+ const elements = {
262
+ project: document.getElementById("project"),
263
+ status: document.getElementById("status"),
264
+ question: document.getElementById("question"),
265
+ context: document.getElementById("context"),
266
+ recommendedAction: document.getElementById("recommendedAction"),
267
+ risk: document.getElementById("risk"),
268
+ actions: document.getElementById("actions"),
269
+ decision: document.getElementById("decision"),
270
+ note: document.getElementById("note")
271
+ };
272
+
273
+ elements.note.value = localStorage.getItem(noteKey) || "";
274
+ elements.note.addEventListener("input", () => {
275
+ localStorage.setItem(noteKey, elements.note.value);
276
+ });
277
+
278
+ fetch("owner_packet.json", { cache: "no-store" })
279
+ .then((response) => {
280
+ if (!response.ok) {
281
+ throw new Error("owner_packet.json could not be loaded");
282
+ }
283
+ return response.json();
284
+ })
285
+ .then(renderPacket)
286
+ .catch((error) => {
287
+ elements.status.textContent = "error";
288
+ elements.question.textContent = "Packet could not be loaded.";
289
+ elements.context.textContent = error.message;
290
+ elements.context.classList.add("error");
291
+ });
292
+
293
+ function renderPacket(packet) {
294
+ elements.project.textContent = packet.project || "Unnamed project";
295
+ elements.status.textContent = packet.status || "unknown";
296
+ elements.question.textContent = packet.question || "No question provided.";
297
+ elements.context.textContent = packet.context || "No context provided.";
298
+ elements.recommendedAction.textContent = packet.recommended_action || "No recommendation provided.";
299
+ elements.risk.textContent = packet.risk || "No risk provided.";
300
+ renderActions(Array.isArray(packet.options) ? packet.options : ["Approve", "Reject", "Ask"]);
301
+ }
302
+
303
+ function renderActions(options) {
304
+ elements.actions.innerHTML = "";
305
+ const savedDecision = localStorage.getItem(selectedKey);
306
+
307
+ for (const option of options) {
308
+ const button = document.createElement("button");
309
+ button.type = "button";
310
+ button.className = "action";
311
+ button.dataset.action = option;
312
+ button.textContent = option;
313
+ button.addEventListener("click", () => selectDecision(option));
314
+ elements.actions.appendChild(button);
315
+ }
316
+
317
+ if (savedDecision) {
318
+ selectDecision(savedDecision);
319
+ }
320
+ }
321
+
322
+ function selectDecision(decision) {
323
+ localStorage.setItem(selectedKey, decision);
324
+ elements.decision.textContent = decision;
325
+
326
+ for (const button of elements.actions.querySelectorAll("button")) {
327
+ const selected = button.dataset.action === decision;
328
+ button.classList.toggle("selected", selected);
329
+ button.disabled = true;
330
+ }
331
+ }
332
+ </script>
333
+ </body>
334
+ </html>
night_logs/LANDING_NOTE_2026-05-04_19-55.md ADDED
@@ -0,0 +1,26 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Landing Note
2
+
3
+ Ich habe heute einen massiven agentischen Stress-Test gefahren.
4
+
5
+ ## Gefühl
6
+ - Es war extrem spannend.
7
+ - Es hat Spaß gemacht.
8
+ - Es war kognitiv überwältigend.
9
+ - Ich bin jetzt nicht mehr in Review-Form.
10
+
11
+ ## Wichtig
12
+ - Heute Nacht keine neuen Agenten mehr starten.
13
+ - Keine Architekturentscheidung treffen.
14
+ - Keine PRs / Pushes / Branches.
15
+ - Morgen nur Artefakte sichten.
16
+
17
+ ## Morgen prüfen
18
+ - Was wurde wirklich geschrieben?
19
+ - Welche Dateien sind nützlich?
20
+ - Welche Outputs sind Müll?
21
+ - Welche Erkenntnisse über Agent-Orchestrierung sind real?
22
+ - Wo hat Hermes sinnvoll interveniert?
23
+ - Welche Grenzen braucht mein zukünftiges Agent-Engineering-System?
24
+
25
+ ## Urteil
26
+ Noch kein Urteil. Erst schlafen, dann verifizieren.
owner_packet.json ADDED
@@ -0,0 +1,13 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "project": "ProjectIntakeTower",
3
+ "status": "needs_human_decision",
4
+ "question": "Soll Luis zuerst nur die Public-Clone-Audits lesen, oder auch lokale Dirty States einbeziehen?",
5
+ "context": "Die vorhandenen Audit-Artefakte nutzen Public Clones als Quelle. Lokale Dirty States bei Zentrale und MegaHarness sind dokumentiert, wurden aber nicht als Wahrheit verwendet.",
6
+ "recommended_action": "Zuerst Public-Clone-Audits lesen und lokale Dirty States nur als separate offene Frage behandeln.",
7
+ "options": [
8
+ "Approve",
9
+ "Reject",
10
+ "Ask"
11
+ ],
12
+ "risk": "Public-Clone-Fakten und lokale Dirty States koennen vermischt werden, wenn diese Quelle nicht zuerst entschieden wird."
13
+ }