Skip to content

docs(#6160): add ADR-0045 maintenance step to harness-composition checklist - #6161

Closed
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/6160-adr-maintenance-step
Closed

docs(#6160): add ADR-0045 maintenance step to harness-composition checklist#6161
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/6160-adr-maintenance-step

Conversation

@fullsend-ai-coder

Copy link
Copy Markdown
Contributor

Summary

Adds step 6 to the harness-composition.md checklist, instructing developers to update ADR-0045's field classification tables when adding forge-overridable fields or moving fields between classification tiers. This addresses a documentation gap that caused a HIGH review finding on PR #6139 — the code agent followed all existing checklist steps but left ADR-0045 contradicting its changes.

Related Issue

Closes #6160

Changes

  • Added step 6 ("Update ADR-0045") to the "Checklist for harness field changes" section in docs/contributing/harness-composition.md
  • The new step covers three ADR-0045 sections that must be updated: field classification tables, ForgeConfig struct definition, and merge-rules table

Testing

  • make lint — pre-commit hooks could not run in sandbox (network policy); post-script runs authoritatively
  • Verified go build ./internal/harness/... passes (no code changes, just documentation)
  • Gitlint validates commit message

Checklist

  • PR title follows Conventional Commits (correct type, ! for breaking changes)
  • Commits are signed off (DCO) — autonomous agent, DCO-exempt
  • I wrote this contribution myself and can explain all changes in it

Closes #6160

Post-script verification

  • Branch is not main/master (agent/6160-adr-maintenance-step)
  • Secret scan passed (gitleaks — baecf40956b2cb1250d1946513515a20af4807fc..HEAD)
  • PR body secret scan passed (gitleaks — no-git)

…cklist

The harness-composition.md checklist covered merge function updates
(steps 1-5) but did not include updating ADR-0045 when a field's
forge-level classification changes. This caused a HIGH review finding
on PR #6139, where the code agent followed all checklist steps but
left ADR-0045's field classification tables contradicting the change.

Add step 6 instructing developers to update the field classification
tables, ForgeConfig struct definition, and merge-rules table in
ADR-0045 when adding forge-overridable fields or moving fields
between classification tiers.

Note: pre-commit could not run (sandbox network policy blocks git
fetch for hook environment setup). The post-script runs pre-commit
authoritatively on the runner.

Closes #6160
@fullsend-ai-coder
fullsend-ai-coder Bot requested a review from a team as a code owner August 12, 2026 22:30
@fullsend-ai-coder fullsend-ai-coder Bot added the ready-for-review Triggers review agent dispatch label Aug 12, 2026
@fullsend-ai-review

fullsend-ai-review Bot commented Aug 12, 2026

Copy link
Copy Markdown

🤖 Finished Review · ✅ Success · Started 10:32 PM UTC · Completed 10:39 PM UTC

Commit: c4e7dc2 · View workflow run →

@github-actions

Copy link
Copy Markdown

Site preview

Preview: https://6fcb1c34-site.fullsend-ai.workers.dev

Commit: c4e7dc2b8883f3149d6aa0d9c30a843d3807445f

@codecov

codecov Bot commented Aug 12, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@fullsend-ai-review

Copy link
Copy Markdown

Looks good to me


Labels: PR updates the harness-composition contributing guide with an ADR maintenance checklist step.

@fullsend-ai-review fullsend-ai-review Bot added ready-for-merge All reviewers approved — ready to merge component/harness Agent harness, config, and skills loading documentation labels Aug 12, 2026
@ralphbean

Copy link
Copy Markdown
Member

Instead of exhorting agents to update ADRs, we should move all of that detail out of the ADR and into somewhere else in docs/ and exhort the agent to update that and link to it from the ADR. The core ADR decision should be small-ish "do forge portable harnesses" but, the details about precedence rules and all that should be a living thing.

@ralphbean ralphbean closed this Aug 19, 2026
@fullsend-ai-retro

fullsend-ai-retro Bot commented Aug 19, 2026

Copy link
Copy Markdown

🤖 Finished Retro · ❌ Failure · Started 8:22 PM UTC · Completed 8:22 PM UTC

Commit: c4e7dc2 · View workflow run →

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

component/harness Agent harness, config, and skills loading documentation ready-for-merge All reviewers approved — ready to merge ready-for-review Triggers review agent dispatch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add ADR-0045 maintenance step to harness-composition.md checklist

1 participant