# PR#148: The Shared Agentic Workflow

> **WARNING:** This document describes only the change applied in this PR.
> It may already be outdated once the next PR is merged.
> Historic PR-documentation is not maintained along with new PRs — treat it as a snapshot, not as current documentation.

## Related Links

- [werkrevisor PR#76](https://git.javagil.de/mi/werkrevisor/pulls/76): introduces `docs/agentic-workflow.md`.

## Problem

Each werk repository describes its workflow with AI agents in its own `AGENTS.md`, and each one differently.
werkator lacks the writing rules, and rules that grew in werkrevisor do not reach it,
e.g. "check that the PR is still open before a push".

## Non-Goals

- No Werkbaum plan for werkator yet; see "Follow-up PRs".
- No change for users of Werkator.

## Solution

- `docs/agentic-workflow.md` is the shared workflow of all werk repositories, copied from werkrevisor.
  Its table "Equipment of a Repository" now says that `CLAUDE.md` imports the workflow too,
  since Claude Code does not load a file that is only linked; werkrevisor gets the same fix with its next PR.
- It refers to `docs/prs/README.md` for the sections of a PR document instead of listing them a second time.
- `AGENTS.md` refers to it; its section "Pull Requests and AI Review" gives way to what applies to werkator alone.
- `CLAUDE.md` imports `docs/agentic-workflow.md`.
- The PR-doc sections "The Problem", "The Scenarios" and "The Solution" become "Problem", "Specification" and "Solution"
  in `docs/prs/README.md`, `docs/prs/TEAMPLATE.md` and the pr-doc skill; werkrevisor keys only on "Open Questions".
- Version 1.39.1, with an internal release-notes entry, as `ReleaseVersionConsistencyUnitTest` requires one per version.

## Follow-up PRs

- A Werkbaum plan `docs/werkator.werkbaum`, as the shared workflow asks for.