Dagger-native pipeline for automated docs cleanup on current branch#3818
Draft
elviskahoro wants to merge 1 commit intodevelfrom
Draft
Dagger-native pipeline for automated docs cleanup on current branch#3818elviskahoro wants to merge 1 commit intodevelfrom
elviskahoro wants to merge 1 commit intodevelfrom
Conversation
Deploying with
|
| 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 -
7c1e1cb to
74ebad2
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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-docsskill. 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
write-and-clean-docsskill, scoped to those files onlyWhat's being added
.claude/skills/write-and-clean-docs/SKILL.mdPlaceholder 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--dry-runflag to preview the payload without execution