Repository navigation
docs(#7283): drop ADR skill line-count hard stops - #7285
Conversation
The writing-adrs skill treated "under 80 lines" and "over 100 lines" as a hard length limit, which pressured authors to compress ADRs even when the decision needed more room. Remove those numeric thresholds. Existing conciseness guidance (one decision per ADR, link instead of restating problem docs, short Consequences bullets) is enough. Closes #7283
|
🤖 Review · Commit: |
|
🤖 Finished Review · ✅ Success · Started 2:13 PM UTC · Completed 2:24 PM UTC Commit: Runtime: pi · Model: sonnet → claude-sonnet-5 · Effort: high · Cost: $1.46 |
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
ReviewFindingsMedium
Info
|
waynesun09
left a comment
There was a problem hiding this comment.
Small, low-risk docs-only change; diff matches the PR description and CI is green.
|
🤖 Finished Retro · ✅ Success · Started 5:50 PM UTC · Completed 5:58 PM UTC Commit: Runtime: claude · Model: sonnet → claude-sonnet-5 · Effort: high · Cost: $1.89 |
|
PR #7285 (docs(#7283): drop ADR skill line-count hard stops) is a clean, low-risk run of the full pipeline: triage → code → review → human sign-off → merge, with no fix cycle needed. Triage ($0.28) correctly scoped the change to two bullets in One evidence note for an existing issue: the code agent self-disclosed in the PR body that The mandatory-human-approval outcome for this One new proposal: while tracing this run, discovering the agents-repo and stage dispatches required extra investigation because the Proposals filed
|
Summary
Remove the ADR writing skill's numeric length hard stops so authors are not pressured to compress a decision that needs more room. Conciseness still comes from one decision per ADR, linking to problem docs instead of restating them, and short Consequences bullets.
Related Issue
#7283 — Relax the ADR writing skill’s 100-line hard limit
Changes
Testing
make lintcould not run as a whole:pre-commitfailed to fetch remote hook repos (HTTP 403)Checklist
docs(#7283): ...)Closes #7283
Post-script verification
agent/7283-relax-adr-line-limit)b95c0b486f88df696ef3c0d6d53577cd55af9ea0..HEAD)