Add Agent Playbook section for automated updates

[stefanvacareanu7]

Summary

• Adds a new README.md section, "Agent Playbook: Updating This Repository End-to-End", documenting how an AI agent (or human) should perform a Staticcheck version bump / dependency update in this repo, based on investigation of the actual build (sbt/Scala), the doc generator, CI config, and prior bump commits.
• No functional code changes — README.md only.

Test plan

• Verified content reflects actual repo structure (build.sbt, DocGenerator.scala, .circleci/config.yml, prior bump commits 8ec77cd/38116a4/8175a69).
• CI checks pass on this PR.

🤖 Generated with Claude Code

[codacy-production]

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

AI Reviewer: first review requested successfully. AI can make mistakes. Always validate suggestions.

_{TIP This summary will be updated as you push new changes.}

[codacy-production]

Pull Request Overview

The Agent Playbook successfully addresses the requirements for standardized automated update procedures and architectural documentation. Codacy reports that the additions are up to standards. All acceptance criteria—including the tool architecture explanation, the definition of done, and local environment setup—are well-integrated. One correction is required in the failure modes table to ensure local troubleshooting commands are consistent with the project's build structure and syntactically correct.

Test suggestions

• Verify that the instructions for sbt doc-generator/run and formatting commands match the existing project build structure.
• Verify the list of files to check for version bumps (Section 2) is exhaustive based on the cited previous commits (8ec77cd, etc.).
• Confirm the documentation accurately describes the Docker image's behavior (entry.sh exiting 1).

_{TIP Improve review quality by adding custom instructions
TIP How was this review? Give us feedback}

[codacy-production]

_{⚪ LOW RISK}

The command sbt:scalafmt::test contains a typo and is inconsistent with the instructions in sections 1 and 3. It should be updated to match the recommended local validation command.

Suggested change

	| CI `codacy/sbt` job fails on `check_fmt_and_compile` | Code not formatted with the project's `.scalafmt.conf` | Run `sbt scalafmt test:scalafmt sbt:scalafmt::test` locally and recommit. |
	CI codacy/sbt job fails on check_fmt_and_compile | Code not formatted with the project's .scalafmt.conf | Run sbt scalafmt test:scalafmt sbt:scalafmt test:compile locally and recommit. |