Skip to content

feat(work-package): DCO policy compatibility#109

Open
m2ux wants to merge 5 commits intoworkflowsfrom
feat/dco-policy-compatibility
Open

feat(work-package): DCO policy compatibility#109
m2ux wants to merge 5 commits intoworkflowsfrom
feat/dco-policy-compatibility

Conversation

@m2ux
Copy link
Copy Markdown
Owner

@m2ux m2ux commented Apr 23, 2026

Summary

Aligns the work-package workflow with the DCO-Safe Agentic Coding Policy by removing the per-commit GPG resign infrastructure and replacing it with a squash-merge-based signing model, provenance tracking, and a human DCO sign-off gate.

📐 Engineering


Motivation

The existing workflow re-signed all branch commits with GPG before submission, which required force-pushes and could only be done by the agent on behalf of the human — conflicting with the policy requirement that humans make attestations themselves. The new model pushes signing to merge time (squash commit) where it is a deliberate human action, and removes the need for force-push surgery on branch history.


Changes

  • workflow.toon — Remove unsigned_commits_in_pr/summary/resign_requested variables; add squash_merge_available and context_scope
  • 01-start-work-package — Add detect-merge-strategy step (GitHub API allow_squash_merge detection)
  • 04-research — Add declare-context-scope checkpoint (repo-only | web-retrieval | mixed)
  • 08-implement — Add provenance-log.md artifact and log-provenance step per task
  • 09-post-impl-review — Strengthen manual diff review: affirmative rationale confirmation per block
  • 10-validate — Remove GPG preflight scan step and related context
  • 11-strategic-review — Remove unsigned-commits-prompt checkpoint and resign-unsigned-pr-commits step
  • 12-submit-for-review — Add blocking dco-sign-off checkpoint (6-item DCO checklist) and merge-strategy-reminder checkpoint
  • 13-complete — Remove resign-artifact-commits step
  • 15-manage-git — Remove gpg-resign-range protocol; remove --no-gpg-sign mandate from artifact-commits; add code-commits protocol with Assisted-by trailer
  • 12-pr-description — Add ## AI Assistance section to Final template

📌 Submission Checklist

  • Changes are backward-compatible (workflow variable removals are non-breaking for new sessions)
  • Pull request description explains why the change is needed
  • Self-reviewed the diff

🗹 TODO before merging

  • Ready for review

🤖 Generated with Claude Code

m2ux and others added 5 commits April 23, 2026 10:38
- Remove GPG resign infrastructure for branch commits (validate scan,
  strategic-review resign checkpoint/step, complete resign-artifact-commits,
  manage-git gpg-resign-range protocol)
- Add squash merge detection in start-work-package (GitHub API) with
  squash_merge_available variable driving downstream DCO path
- Add context_scope variable (repo-only|web-retrieval|mixed) set at end
  of research phase via new context-scope-declaration checkpoint
- Add provenance-log.md artifact to implement; log-provenance step appends
  one row per task (model, prompt class, context scope, description)
- Add Assisted-by commit trailer to manage-git code-commits protocol
- Strengthen post-impl-review manual diff review: affirmative rationale
  confirmation replaces passive issue-flagging only
- Add DCO sign-off blocking checkpoint in submit-for-review presenting
  the six-item DCO checklist before push
- Add merge-strategy-reminder checkpoint instructing squash merge with
  signed commit (local git merge --squash flow for GPG verification)
- Add AI Assistance section to PR description Final template

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Move implementation methodology out of activity step description prose
into referenced skills, following the workflow convention that descriptions
state WHAT and skills contain HOW.

- Add skill 24-dco-provenance: provenance log schema, attestation
  recording protocol, and context scope classification
- Add detect-merge-strategy and squash-merge-instruction protocols
  to manage-git skill
- detect-merge-strategy step now references manage-git (was github-cli-protocol)
- declare-context-scope, log-provenance, dco-sign-off, instruct-merge-strategy
  steps: trimmed descriptions to declarative-only, added skill references
- Update skills README: count 24→25, skill 15 description, add skill 24 row

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…laude

Assisted-by trailer, provenance log schema, and PR description template
now use {tool}/{model_id} placeholders rather than hardcoding claude,
to support any AI assistant (claude, gpt, gemini, etc.).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ware protocol

Co-authored-by is the GitHub-compatible standard trailer that produces
the 'X and Y committed' byline. The code-commits protocol now documents
per-assistant harness behaviour to prevent double-injection: Claude Code
auto-adds the trailer so the agent must not add it again; other assistants
that do not auto-inject must add it explicitly. Cleans up two stale
Assisted-by references in variable descriptions.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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