Skip to content

docs(agents): slim the agent files to the umbrella pattern - #43

Merged
github-actions[bot] merged 3 commits into
mainfrom
hygiene/c1-agent-files
Oct 21, 2026
Merged

github-actions[bot] merged 3 commits into
mainfrom
hygiene/c1-agent-files

Conversation

@znerol2

@znerol2 znerol2 commented Oct 21, 2026

Copy link
Copy Markdown
Contributor

This brings the agent files in line with the umbrella pattern and fixes the umbrella link in CONTRIBUTING.md.

  • AGENTS.md now carries the repo guidance in 60 lines or fewer: what the repo is, how to build and test it, the rules that are easy to miss, and a pointer to the umbrella. The must and never rules from the old files are kept or condensed. Rules that were stale or that the umbrella already carries are dropped, as are a few long troubleshooting tips.
  • CLAUDE.md and QWEN.md keep the generated working-model block, unchanged, and point to AGENTS.md.
  • The boot steps now send agents to the umbrella status digest (bin/generate-status.sh, then STATUS.digest.local.md). Shared notes go to the pinned operator notes issue, Operator notes dmfdeploy#618.
  • CONTRIBUTING.md named an umbrella repo that does not exist. It now links dmfdeploy/dmfdeploy.
  • Links to umbrella plan files that are about to move to the archive now use a permalink at a fixed commit, so they keep resolving after the move.

bin/check-working-model-sync.sh --strict passes against the pinned working-model-v1 template.

Refs dmfdeploy/dmfdeploy#591
Refs dmfdeploy/dmfdeploy#616

AGENTS.md now carries the repo guidance in 60 lines or fewer. CLAUDE.md and QWEN.md keep the generated working-model block and point to AGENTS.md. The boot steps send agents to the umbrella status digest and the pinned operator notes issue.

Signed-off-by: znerol2 <6800371+znerol2@users.noreply.github.com>
The quick start and licence sections named an umbrella repo that does not exist. They now link the real one.

Signed-off-by: znerol2 <6800371+znerol2@users.noreply.github.com>
These references point at umbrella plan files that are about to move to the archive. A permalink at a fixed commit keeps them resolving.

Signed-off-by: znerol2 <6800371+znerol2@users.noreply.github.com>
@znerol2
znerol2 requested a review from a team as a code owner October 21, 2026 06:53
@github-actions
github-actions Bot enabled auto-merge (rebase) October 21, 2026 06:54
@znerol2
znerol2 requested a review from lkirc October 21, 2026 07:11

@lkirc lkirc left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Static review complete: no blocking findings. Verified the current head, full PR history, pinned plan references, and all required checks are successful.

@github-actions
github-actions Bot merged commit 76c8eb9 into main Oct 21, 2026
11 checks passed
@znerol2
znerol2 deleted the hygiene/c1-agent-files branch November 5, 2026 08:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants