Repository navigation
Closed
Labels
enhancementNew feature or requestNew feature or request
Description
We implemented a new claude command under .claude/commands/weekly.md which performs a weekly code cleanup and checks the docs for any outdated material. For that purpose, the claude command utilizes a subagent for bug-checking and a subagent for docs refinement. This command should be refined a bit more.
Tasks
- It should be configurable how the subagents handle findings. Currently, they are instructed to directly open pull requests. However, this also means that the subagents cannot be directly used just to find issues without creating pull requests. This should be pulled out into the weekly command -> instructing the agents there to create pull requests with their findings.
- When pull requests are opened for bugs or documentation enhancements, it should be investigated which human contributors to the existing code/docs should be notified by assigning them to the created pull requests. Ideally, not everyone should be notified, only the most important contributors to the contents. This is to collect sign-offs from the right persons on the changes.
- Findings should be checked against open pull requests. If there is already an open pull request adressing the discovered issue(s), the finding should not be re-addressed.
- Instead of only creating 1 pull request per run, let the agents decide themselves which changes are important to cover. The agents need to reason over the importance. Keep in mind that all PRs need to be reviewed and merged by humans, so PR fatigue should be considered.
- Before any pull request is opened, agents need to verify
makeruns. Pull request titles must start with uppercase letters and conventional commits are not required (at the moment). The pull request content must be directly commitable as a concise commit message, so artificial linebreaks or markdown must be avoided. - Agents should be instructed to read the AGENTS.md file before doing work.
Metadata
Metadata
Assignees
Labels
enhancementNew feature or requestNew feature or request
Activity
PhilippMatthes commentedon Apr 26, 2026
@claude can you adjust the commands and agents files under the .claude folder and open a pull request with your changes?
sapcc-bot commentedon Apr 26, 2026
👋 Completed refining the weekly claude command and related agent files.
Progress
.claude/commands/weekly.mdand agent filesAGENTS.mdto understand project conventionsmakeverification, PR title/content formatting rules (Task 5)Changes Made
.claude/agents/bug-detective.md— Converted from a find-and-fix agent to a report-only agent. Removed Phase 2 (PR creation) and replaced it with importance reasoning. Output now returns structured findings with severity, suggested fixes, and key contributors instead of PR numbers. Added AGENTS.md setup step..claude/agents/docs-expert.md— Same pattern: converted from find-and-fix to report-only. Removed Phase 2 (PR creation) and replaced with importance reasoning. Output now returns structured findings with priorities and key contributors. Added AGENTS.md setup step..claude/commands/weekly.md— Major restructure from 3 phases to 7 phases:makeverification, contributor assignment, and PR formatting rulesPR
#760