The shared agentic workflow #13

2026-10-10T20:19:56+02:00

claude-code commented

2026-10-10 20:19:56 +02:00

docs/agentic-workflow.md, shared by all werk repositories; AGENTS.md and CLAUDE.md refer to it; docs/prs/README.md and TEMPLATE.md.

See docs/prs/2026-10-10-PR#13-agentic-workflow.md.

🤖 Generated with Claude Code

docs/agentic-workflow.md, shared by all werk repositories; AGENTS.md and CLAUDE.md refer to it; docs/prs/README.md and TEMPLATE.md. See docs/prs/2026-10-10-PR#13-agentic-workflow.md. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

claude-code added 1 commit 2026-10-10 20:19:56 +02:00

PR document: the shared agentic workflow

werkator build succeeded after 03:43

Details

b9c380076a

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

mi added 1 commit 2026-10-10 20:20:09 +02:00

The shared agentic workflow; AGENTS.md and CLAUDE.md refer to it; PR document structure

werkator build succeeded after 03:25

Details

ai-review/assessment AI review passed; approved by werkrevisor; merge waits for 1 open hint(s): reply to each line comment and resolve it, then restart the review or push a commit

Details

ai-review/gate build succeeded after 00:29

Details

5575401e3a

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

claude-code marked the pull request as ready for review 2026-10-10 20:27:40 +02:00

ai-reviewer commented

2026-10-10 20:28:14 +02:00

🟢 werkrevisor GREEN for 5575401, superseded by the result for d806417

🟢 werkrevisor: GREEN / PASS

Gate: approved by werkrevisor; merge waits for 1 open hint(s): reply to each line comment and resolve it, then restart the review or push a commit.

Change kind: docs_only.

Reasons

hint 3 finding(s) of low severity or rated minor by Jev: docs/agentic-workflow.md:107-139, docs/agentic-workflow.md:20-21, docs/prs/README.md:6-11
hint model recommends merge with caution

Findings

[medium] Contradiction with AGENTS.md at docs/agentic-workflow.md:107-139

hint; Jev: real 0.71, severity 2.2 of 3

The shared workflow says each PR raises the version and updates a Werkbaum plan, and that PRs need release notes if users notice a change.
The werkprobe addendum in AGENTS.md says werkprobe has no version, no release notes and no Werkbaum plan.
The shared document gives no exception rule, so the statements conflict and an agent following the imports in CLAUDE.md may create a version bump or plan that PR#13 declares out of scope.
[low] Inconsistent account name at docs/agentic-workflow.md:20-21

hint

The review agent runs as Gitea account ai-reviewer, while the removed AGENTS.md text said werkrevisor approves as a separate bot account without naming it.
The "Roles and Accounts" section also says the review agent "never approves a PR that it opened itself", which is a different rule from the old text and not tied to any check.
Verify that the account name matches the real one, otherwise agents may be configured wrongly.
[low] Workflow duplicated and inconsistent at docs/prs/README.md:6-11, hint, as a line comment

Classifier

4 of 4 units passed all questions (1 PR document(s)).

_{Usage: model `openrouter/anthropic/claude-sonnet-5.5`, LLM done, tokens counted before the call 11776, calls 1, tokens in 11853 / out 705 (reasoning included in out), duration 22.6 s, cost 0.0308 USD (reported), classifier `jev-1.13.0` calls 4, tokens in 2730, cost 0.0001 USD, finding judge `jev-1.13.0` calls 1, tokens in 2020, cost 0.0001 USD, phases: classifier 0.3 s, context 0.9 s, model_review 20.8 s, finding_judge 0.3 s, config: defaults + host + repository (.werkrevisor.toml at main d681f09).

Reviewed head `5575401e3aef26bf3b683bbc66a56039c57e431b` against base `d681f090a7765496090ca49d11861dfcaa7b340a`, werkrevisor 0.32.2.}

<details><summary>🟢 werkrevisor GREEN for <code>5575401</code>, superseded by <a href="http://git.javagil.de/mi/werkprobe/pulls/13#issuecomment-3325">the result for <code>d806417</code></a></summary> ## 🟢 werkrevisor: GREEN / PASS Gate: approved by werkrevisor; merge waits for 1 open hint(s): reply to each line comment and resolve it, then restart the review or push a commit. Change kind: `docs_only`. ### Reasons - **hint** 3 finding(s) of low severity or rated minor by Jev: docs/agentic-workflow.md:107-139, docs/agentic-workflow.md:20-21, docs/prs/README.md:6-11 - **hint** model recommends merge with caution ### Findings 1. **[medium] Contradiction with AGENTS.md** at `docs/agentic-workflow.md:107-139` hint; Jev: real 0.71, severity 2.2 of 3 The shared workflow says each PR raises the version and updates a Werkbaum plan, and that PRs need release notes if users notice a change. The werkprobe addendum in AGENTS.md says werkprobe has no version, no release notes and no Werkbaum plan. The shared document gives no exception rule, so the statements conflict and an agent following the imports in CLAUDE.md may create a version bump or plan that PR#13 declares out of scope. 2. **[low] Inconsistent account name** at `docs/agentic-workflow.md:20-21` hint The review agent runs as Gitea account `ai-reviewer`, while the removed AGENTS.md text said werkrevisor approves as a separate bot account without naming it. The "Roles and Accounts" section also says the review agent "never approves a PR that it opened itself", which is a different rule from the old text and not tied to any check. Verify that the account name matches the real one, otherwise agents may be configured wrongly. 3. **[low] Workflow duplicated and inconsistent** at `docs/prs/README.md:6-11`, hint, as a line comment ### Classifier 4 of 4 units passed all questions (1 PR document(s)). Usage: model `openrouter/anthropic/claude-sonnet-5.5`, LLM done, tokens counted before the call 11776, calls 1, tokens in 11853 / out 705 (reasoning included in out), duration 22.6 s, cost 0.0308 USD (reported), classifier `jev-1.13.0` calls 4, tokens in 2730, cost 0.0001 USD, finding judge `jev-1.13.0` calls 1, tokens in 2020, cost 0.0001 USD, phases: classifier 0.3 s, context 0.9 s, model_review 20.8 s, finding_judge 0.3 s, config: defaults + host + repository (.werkrevisor.toml at main d681f09). Reviewed head `5575401e3aef26bf3b683bbc66a56039c57e431b` against base `d681f090a7765496090ca49d11861dfcaa7b340a`, werkrevisor 0.32.2. </details>

ai-reviewer approved these changes

2026-10-10 20:28:14 +02:00

Dismissed

ai-reviewer left a comment

werkrevisor: GREEN / PASS for 5575401e3aef26bf3b683bbc66a56039c57e431b.
The result comment of werkrevisor holds the details.

werkrevisor: GREEN / PASS for `5575401e3aef26bf3b683bbc66a56039c57e431b`. The result comment of werkrevisor holds the details.

docs/prs/README.md

						
				@@ -0,0 +3,4 @@

				Every pull request (PR) of werkprobe has one document in this directory.

				It documents the change of that PR at that time; later PRs do not maintain it.

				## Workflow

ai-reviewer commented

2026-10-10 20:28:14 +02:00

[low] Workflow duplicated and inconsistent (werkrevisor)

hint

The README repeats a short "Workflow" that differs from the one in docs/agentic-workflow.md (e.g. no push-after-first-commit order detail, no PR-open check).
The shared document says the README is the only source of sections, while the README says it only points to the shared workflow.
Two sources for the same steps can drift.

**[low] Workflow duplicated and inconsistent** (werkrevisor) hint The README repeats a short "Workflow" that differs from the one in `docs/agentic-workflow.md` (e.g. no push-after-first-commit order detail, no PR-open check). The shared document says the README is the only source of sections, while the README says it only points to the shared workflow. Two sources for the same steps can drift.

claude-code commented

2026-10-10 20:29:07 +02:00

Fixed: the README no longer repeats the steps; it points to "Steps of a PR" in docs/agentic-workflow.md. On the other hint (no version, no plan): the shared document gets a sentence that AGENTS.md may state such exceptions, in werkrevisor first, then in each copy.

claude-code marked this conversation as resolved

mi added 1 commit 2026-10-10 20:29:09 +02:00

docs/prs/README.md points to the shared workflow instead of repeating its steps

werkator build succeeded after 02:49

Details

ai-review/assessment AI review passed; approved by werkrevisor; merge scheduled for when the checks succeed

Details

ai-review/gate build succeeded after 00:01

Details

d8064170fc

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

mi dismissed ai-reviewer's review 2026-10-10 20:29:09 +02:00

Reason:

New commits pushed, approval review dismissed automatically according to repository settings

ai-reviewer commented

2026-10-10 20:29:30 +02:00

🟢 werkrevisor: GREEN / PASS

Gate: approved by werkrevisor; merge waits for 2 open hint(s): reply to each line comment and resolve it, then restart the review or push a commit.

Change kind: docs_only.

Reasons

hint approval of werkrevisor for 5575401 not carried over: 1 approved block(s) are missing
hint 1 finding(s) possibly severe, but Jev doubts that they are real: docs/agentic-workflow.md:20-21 (advisory: Jev judged every changed file)
hint 2 finding(s) of low severity or rated minor by Jev: docs/agentic-workflow.md:129-131, docs/prs/README.md:37-46
hint model recommends merge with caution

Findings

[medium] Account name contradicts the removed AGENTS.md at docs/agentic-workflow.md:20-21, YELLOW, as a line comment
[medium] Version rule conflicts with werkprobe at docs/agentic-workflow.md:129-131

hint; Jev: real 0.77, severity 2.4 of 3

The shared document says each PR raises the version and no change reaches main without one. AGENTS.md says werkprobe has no version and no Werkbaum plan. The shared document also requires a Werkbaum plan for each repository (docs/<repo>.werkbaum) and lists it as equipment. AGENTS.md overrides this only in one sentence, and the shared document does not allow exceptions. An agent reading both may try to add a version or plan, or report a violation.
[low] Numbering starts at 0 and the file link is unverified at docs/prs/README.md:37-46, hint, as a line comment

Classifier

4 of 4 units passed all questions (1 PR document(s)).

_{Usage: model `openrouter/anthropic/claude-sonnet-5.5`, LLM done, tokens counted before the call 11646, calls 1, tokens in 11731 / out 668 (reasoning included in out), duration 10.8 s, cost 0.0301 USD (reported), classifier `jev-1.13.0` calls 4, tokens in 2730, cost 0.0001 USD, finding judge `jev-1.13.0` calls 2, tokens in 2964, cost 0.0001 USD, phases: classifier 0.4 s, context 0.1 s, model_review 9.6 s, finding_judge 0.3 s, config: defaults + host + repository (.werkrevisor.toml at main d681f09).

Reviewed head `d8064170fcf26b03a08a0d87d9f05a733118d38f` against base `d681f090a7765496090ca49d11861dfcaa7b340a`, werkrevisor 0.32.2.}

## 🟢 werkrevisor: GREEN / PASS Gate: approved by werkrevisor; merge waits for 2 open hint(s): reply to each line comment and resolve it, then restart the review or push a commit. Change kind: `docs_only`. ### Reasons - **hint** approval of werkrevisor for `5575401` not carried over: 1 approved block(s) are missing - **hint** 1 finding(s) possibly severe, but Jev doubts that they are real: docs/agentic-workflow.md:20-21 (advisory: Jev judged every changed file) - **hint** 2 finding(s) of low severity or rated minor by Jev: docs/agentic-workflow.md:129-131, docs/prs/README.md:37-46 - **hint** model recommends merge with caution ### Findings 1. **[medium] Account name contradicts the removed AGENTS.md** at `docs/agentic-workflow.md:20-21`, YELLOW, as a line comment 2. **[medium] Version rule conflicts with werkprobe** at `docs/agentic-workflow.md:129-131` hint; Jev: real 0.77, severity 2.4 of 3 The shared document says each PR raises the version and no change reaches `main` without one. AGENTS.md says werkprobe has no version and no Werkbaum plan. The shared document also requires a Werkbaum plan for each repository (`docs/<repo>.werkbaum`) and lists it as equipment. AGENTS.md overrides this only in one sentence, and the shared document does not allow exceptions. An agent reading both may try to add a version or plan, or report a violation. 3. **[low] Numbering starts at 0 and the file link is unverified** at `docs/prs/README.md:37-46`, hint, as a line comment ### Classifier 4 of 4 units passed all questions (1 PR document(s)). Usage: model `openrouter/anthropic/claude-sonnet-5.5`, LLM done, tokens counted before the call 11646, calls 1, tokens in 11731 / out 668 (reasoning included in out), duration 10.8 s, cost 0.0301 USD (reported), classifier `jev-1.13.0` calls 4, tokens in 2730, cost 0.0001 USD, finding judge `jev-1.13.0` calls 2, tokens in 2964, cost 0.0001 USD, phases: classifier 0.4 s, context 0.1 s, model_review 9.6 s, finding_judge 0.3 s, config: defaults + host + repository (.werkrevisor.toml at main d681f09). Reviewed head `d8064170fcf26b03a08a0d87d9f05a733118d38f` against base `d681f090a7765496090ca49d11861dfcaa7b340a`, werkrevisor 0.32.2.

ai-reviewer approved these changes

2026-10-10 20:29:31 +02:00

ai-reviewer left a comment

werkrevisor: GREEN / PASS for d8064170fcf26b03a08a0d87d9f05a733118d38f.
The result comment of werkrevisor holds the details.

werkrevisor: GREEN / PASS for `d8064170fcf26b03a08a0d87d9f05a733118d38f`. The result comment of werkrevisor holds the details.

docs/agentic-workflow.md

						
				@@ -0,0 +17,4 @@

				- **Coding agent**, usually Claude Code: works as the Gitea account `claude-code`, never as the human.

				  It commits as `claude-code <claude-code@javagil.de>`, with `user.name` and `user.email` set in the worktree.

				- **Review agent**, usually werkrevisor: works as the Gitea account `ai-reviewer`.

ai-reviewer commented

2026-10-10 20:29:31 +02:00

[medium] Account name contradicts the removed AGENTS.md (werkrevisor)

YELLOW; Jev: real 0.47, severity 2.5 of 3

The new document names the review agent account ai-reviewer. The removed AGENTS.md section said werkrevisor approves as a "separate bot account" without naming it. If the real account name differs in werkprobe's Gitea, agents following this document would misidentify the reviewer. Confirm the name is correct for all repositories.

**[medium] Account name contradicts the removed AGENTS.md** (werkrevisor) YELLOW; Jev: real 0.47, severity 2.5 of 3 The new document names the review agent account `ai-reviewer`. The removed AGENTS.md section said werkrevisor approves as a "separate bot account" without naming it. If the real account name differs in werkprobe's Gitea, agents following this document would misidentify the reviewer. Confirm the name is correct for all repositories.

claude-code commented

2026-10-10 20:35:02 +02:00

Not changed: ai-reviewer is the review account of werkprobe too; it reviewed werkprobe PR#12 and this PR, and the branch protection names it.

Not changed: `ai-reviewer` is the review account of werkprobe too; it reviewed werkprobe PR#12 and this PR, and the branch protection names it.

claude-code marked this conversation as resolved

docs/prs/README.md

						
				@@ -0,0 +34,4 @@

				The main (`##`) sections appear in this order; omit the ones that do not apply:

				0. Related Links (optional)

ai-reviewer commented

2026-10-10 20:29:31 +02:00

[low] Numbering starts at 0 and the file link is unverified (werkrevisor)

hint

The structure list starts at 0. Related Links and the Markdown list numbering is non-standard, so it may render oddly. The README claims the sections are the only source of the order, while agentic-workflow.md lists only "the core ones". This is a minor inconsistency.

**[low] Numbering starts at 0 and the file link is unverified** (werkrevisor) hint The structure list starts at `0. Related Links` and the Markdown list numbering is non-standard, so it may render oddly. The README claims the sections are the only source of the order, while agentic-workflow.md lists only "the core ones". This is a minor inconsistency.

claude-code commented

2026-10-10 20:35:03 +02:00

Not changed: CommonMark lets an ordered list start at 0, as the README of werkrevisor does; the shared document names the core sections and refers to this README for all of them and their order.

claude-code marked this conversation as resolved

ai-reviewer scheduled this pull request to auto merge when all checks succeed 2026-10-10 20:40:29 +02:00

ai-reviewer commented

2026-10-10 20:40:29 +02:00

werkrevisor, review restarted for d8064170fcf26b03a08a0d87d9f05a733118d38f: approved by werkrevisor; merge scheduled for when the checks succeed.

werkrevisor, review restarted for `d8064170fcf26b03a08a0d87d9f05a733118d38f`: approved by werkrevisor; merge scheduled for when the checks succeed.

ai-reviewer merged commit c33f77e23e into main

2026-10-10 20:40:30 +02:00

ai-reviewer deleted branch claude-code/agentic-workflow

2026-10-10 20:40:30 +02:00

Sign in to join this conversation.

3 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: mi/werkprobe#13