Skip to content

Dagger-native pipeline for automated docs cleanup on current branch#3818

Draft
elviskahoro wants to merge 1 commit intodevelfrom
elvis/claude-code-docs-review-via-dagger
Draft

Dagger-native pipeline for automated docs cleanup on current branch#3818
elviskahoro wants to merge 1 commit intodevelfrom
elvis/claude-code-docs-review-via-dagger

Conversation

@elviskahoro
Copy link
Copy Markdown
Contributor

@elviskahoro elviskahoro commented Apr 1, 2026

Draft PR — MVP/prototype from elvis exploring Dagger for this workflow (uses it in personal projects and loves it!). I have a bunch of code snippets from previous projects so it was easy to get Claude Code to build this!

This draft PR adds a containerized pipeline that identifies changed markdown files on the current branch and runs Claude headlessly to clean and improve docs using the write-and-clean-docs skill. It enables engineers to systematically improve documentation quality with a structured, repeatable workflow that works both locally and in remote environments like GitHub Actions.

Purpose

Part of the larger effort to establish a semi-automated docs improvement loop: user questions → identified gaps → systematic fixes → better docs → fewer repeated questions.

This MVP enables the first production cycle: engineers use the pipeline to clean up documentation changes before merging.

How it works

  1. Git branch analysis detects changed markdown files on the current branch
  2. Claude CLI runs in a Dagger container with the write-and-clean-docs skill, scoped to those files only
  3. Structured JSON results are returned for CI validation and human review

What's being added

.claude/skills/write-and-clean-docs/SKILL.md

Placeholder skill with strict execution boundaries (only edits explicitly listed files) and a smoke-test contract for CI validation — the team will refine this skill based on actual usage patterns.

tools/claude_headless_dagger_mvp.py

  • Implements Dagger container orchestration to isolate Claude execution from local state
  • Supports --dry-run flag to preview the payload without execution
  • Returns validated JSON schema with status, summary, files checked/modified, actions, and warnings
  • Accepts CLI args and environment variables for model, effort, permission mode, and budget control

@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Apr 1, 2026

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
docs 74ebad2 Commit Preview URL

Branch Preview URL
Apr 01 2026, 03:13 AM

…aude docs cleanup

- Implement pipeline to detect changed markdown files on current branch
- Run headless `claude -p` command inside Dagger container with scoped files
- Enforce strict prompt scope and JSON output schema for docs cleanup skill
- Support dry-run mode, CLI args, and environment variable configuration
-
@elviskahoro elviskahoro force-pushed the elvis/claude-code-docs-review-via-dagger branch from 7c1e1cb to 74ebad2 Compare April 1, 2026 03:04
@elviskahoro elviskahoro changed the title feat(headless-docs): add Dagger-native pipeline for current-branch Claude docs cleanup feat(headless-docs): add Dagger-native pipeline for automated docs cleanup on current branch Apr 1, 2026
@elviskahoro elviskahoro changed the title feat(headless-docs): add Dagger-native pipeline for automated docs cleanup on current branch Dagger-native pipeline for automated docs cleanup on current branch Apr 1, 2026
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.

1 participant