Skip to content

docs(repo): welcome beta testers with roadmap and testing guide - #609

Merged
mergify[bot] merged 2 commits into
mainfrom
kimi/repo-show-1
Oct 6, 2026
Merged

mergify[bot] merged 2 commits into
mainfrom
kimi/repo-show-1

Conversation

@Cuarroc

@Cuarroc Cuarroc commented Oct 6, 2026 •

Copy link
Copy Markdown
Owner

Das Repo begrüßt jetzt Erstbesucher und Beta-Tester: Die README bekommt ein Inhaltsverzeichnis, einen Abschnitt zum aktuellen Stand (v1.5.1, Plan für 2.0 freigegeben) und einen Abschnitt „Mitmachen als Tester". Neu sind eine verständliche Roadmap zu Version 2.0 (docs/roadmap-2.0.md), eine Tester-Anleitung mit sieben Klickwegen durch v1.5.1 (docs/TESTEN.md) und eine deutsche Issue-Vorlage „Tester-Feedback". Geändert wird nur Dokumentation, kein Code.

Report

What changed

  • README.md (162 → 193 lines): tagline aligned with the v2.0 thesis
    „Fertig ist nur, was bewiesen ist" (three promises: Grün heißt bewiesen /
    Kein Modell prüft sich selbst / Der Mensch behält die Kontrolle) while
    keeping the safety facts (Not-Aus, Budgetgrenzen, Protokoll); added a short
    table of contents, a section „Wo steht ProjectA?" (v1.5.1 current, v2.0 plan
    approved 2026-10-06, links docs/roadmap-2.0.md) and a section
    „Mitmachen als Tester" (release link + docs/TESTEN.md).
  • docs/roadmap-2.0.md (new, German, 80 lines): the road to 2.0.0 derived
    only from docs/plan/v2.0/plan.md sections 1, 1a, 4 and 5 — the three
    promises, waves W0–W6, gates G0 (done 2026-10-06) / G-Kern / release, the 9
    navigation areas, core vs. feature-switch areas, „Kein fester Termin".
  • docs/TESTEN.md (new, German, 60 lines): install v1.5.1 from the releases
    page, 7 verified click paths (add project, start worker, board/terminal/diff,
    emergency stop, budgets/roles, learnings approval, session restore), what is
    intentionally off (continuous mode), how to report via the new issue form.
  • .github/ISSUE_TEMPLATE/tester-feedback.yml (new, German issue form):
    „Was hast du gemacht?", „Was hast du erwartet?", „Was ist passiert?",
    version (default v1.5.1), optional screenshot note. No prior ISSUE_TEMPLATE
    config existed, nothing to preserve.

Evidence

  • Base: origin/main e938d9c153f38b6cfa8125e0536e5f1e31131f03 (re-fetched
    2026-10-06 before branching, unchanged from dispatch base).
  • Final SHA: 1964bc4d789ffabcf954b835b5811009696fac46
    = git ls-remote origin kimi/repo-show-1 output (push verified).
  • Diff size: 4 files, 220 insertions, 1 deletion (≤ 300 rule).
  • bash scripts/ci/gates.sh lane prepush at final HEAD 1964bc4:
    exit 0 (all 21 gates green incl. rust-suite 1918 passed / 18 skipped),
    log: session task bash-mhq9lr37 (and hook re-run on push, also exit 0).
  • bash scripts/ci/secret-scan.sh: exit 0, no leaks.
  • Issue-form YAML parsed with js-yaml: name „Tester-Feedback", 6 body items.
  • All linked files verified present on origin/main
    (docs/plan/v2.0/plan.md, docs/drills/README.md, docs/setup/README.md,
    CHANGELOG.md, KNOWN_ISSUES.md, SECURITY.md).
  • Tester click paths verified against the v1.5.1 README „Funktionen"/
    „Schnellstart" sections; no features invented.
  • No personal data, no local paths, no costs, no server details in the diff
    (grep-checked).

NICHT ABGEDECKT

  • Linux half of the gates (#[cfg(unix)] tests, Linux clippy arms) — this run
    covers Windows only; the merge queue's linux lane covers the rest.
  • The GUI itself was not launched; tester steps are verified against README/
    docs text, not clicked in the app.
  • The GitHub issue form renders only after merge; YAML was validated by parse,
    not by GitHub's UI.
  • External link targets (releases page, issue chooser) not fetched.

Review

Tier C (docs + issue template, no runtime effect): gates suffice per
AGENTS.md rule 5. Status: complete.

Review disposition

  • Reviewer: glm-5.2 (Ollama)
  • Model requested: glm-5.2:cloud
  • Model reported: glm-5.2
  • Author family: kimi (kimi-k3 was not used)
  • Candidate reviewed: 1964bc4d789ffabcf954b835b5811009696fac46
  • Candidate after the accepted fix: d58b31c5e526b783dc3b22bc03f1ebdb13c25924
  • Verdict: approve

F1, medium, source glm-5.2. The H2 ## Der Weg in sechs Wellen was glued to the previous sentence (neues großes Release zu.## Der Weg in sechs Wellen). The reviewer cited docs/roadmap-2.0.md:48; on 1964bc4 the line is docs/roadmap-2.0.md:42.

  • Gegenprüfung: confirmed. The ## is not at the start of a line, so Markdown does not render a heading. The line is in this package, it is not already handled, and the file text is the proof.
  • Entscheidung: angenommen. Commit d58b31c5e526b783dc3b22bc03f1ebdb13c25924 puts a blank line before the heading.
  • Delta review of that commit, same reviewer (glm-5.2:cloud, reported glm-5.2): F1 is fixed, no new finding, verdict approve.

Architektur-Drift: checked against docs/architecture-rules.md, docs/decisions.md (2026-10-05: Dauerbetrieb stays off) and AGENTS.md. This change is documentation only. It does not add a second pattern for frontend state, Tauri command results, store or lock access, IPC names, or the Rust-to-frontend event path. The nine sidebar areas plus first-run match docs/plan/v2.0/plan.md section 3.4. Not-Aus within ten seconds matches docs/drills/estop-drill.md:3. No drift finding.

Evidence for the fix: bash scripts/ci/red-first.sh exit 0. Pre-push hook bash scripts/ci/gates.sh lane prepush exit 0 (21 gates green, rust-suite 1918 passed / 18 skipped). git ls-remote origin refs/heads/kimi/repo-show-1 equals d58b31c5e526b783dc3b22bc03f1ebdb13c25924. Not queued.

Prompt-Log

Dispatched as JOB loc-repo-show-1 (Orchestrator 2026-10-06), single shot,
no critique rounds requested by the job. Plan mode used: read README/plan
sources, wrote plan file, auto-approved, executed as planned. One deviation:
job header said „PR: ready (not draft)" while the common rules say draft —
followed the job-specific, newer instruction (ready); noted for the
coordinator.

Add a table of contents, a status section pointing at the approved
v2.0 plan and a tester section to the README. Add docs/roadmap-2.0.md
(plain-German summary of docs/plan/v2.0/plan.md), docs/TESTEN.md (beta
tester click-through for v1.5.1) and a German issue form for tester
feedback.

No-Test: documentation and issue template only, no runtime effect
Co-Authored-By: Kimi K3 <noreply@moonshot.cn>
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

The heading "Der Weg in sechs Wellen" was glued to the previous
sentence, so Markdown showed it as plain text.

No-Test: documentation formatting only, no runtime effect
@Cuarroc Cuarroc added the review-ok Pipeline: review disposition complete, no open high finding label Oct 6, 2026
@Cuarroc

Cuarroc commented Oct 6, 2026

Copy link
Copy Markdown
Owner Author

@Mergifyio queue

@mergify mergify Bot added the queued label Oct 6, 2026
@mergify mergify Bot mentioned this pull request Oct 6, 2026
12 tasks done
@mergify
mergify Bot merged commit 9dddf9a into main Oct 6, 2026
11 checks passed
@mergify
mergify Bot deleted the kimi/repo-show-1 branch October 6, 2026 13:14
@mergify

mergify Bot commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

Merge Queue Status

This pull request spent 15 minutes 13 seconds in the queue, including 14 minutes 19 seconds running CI.

Required conditions to merge

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

review-ok Pipeline: review disposition complete, no open high finding

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant