Add ai-decision-authority skill - #2837
Closed
kubersharmax wants to merge 1 commit into
Closed
Conversation
Introduced the AI Decision Authority skill to categorize AI-assisted decisions into governance zones based on stakes and reversibility. This skill aims to improve AI adoption by providing clear rules for decision-making processes.
Contributor
🔒 PR Risk Scan ResultsScanned 1 changed file(s).
✅ No matching risk patterns were detected in changed files.
|
Contributor
🔍 Vally Lint Results✅ All checks passed
Summary
Full linter output |
Contributor
|
If it hasn't been tested with Copilot then I have minimal faith that it's bringing any value. |
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.
Adds
skills/ai-decision-authority/SKILL.md, a skill for deciding which AI outputs require human approval and which an agent can own outright.What gap this fills
Teams adopting Copilot and agents hit one of two failure modes. Gate every output and adoption collapses, because using the tool becomes slower than doing the work by hand. Gate nothing and errors accumulate until one does not stay quiet, at which point a blanket review rule gets imposed and you land in the first failure anyway.
Both come from applying a single governance rule to every decision. This skill sorts decisions into three zones by reversibility, exposure, and frequency, and gives each zone a rule plus the cost of misclassifying in either direction.
This is not something a frontier model handles well by default. Asked whether an agent should be allowed to merge a PR or send a customer email, models tend to give a generic "it depends, add human review" answer. The uplift here is a repeatable ordering (reversibility first, because it dominates) and an explicit instruction to gate the boundary inside a workflow rather than the whole workflow at its highest zone, which is where most of the available adoption is lost.
Relationship to existing skills
I checked
agent-governancebefore writing this, and they are complementary rather than overlapping.agent-governancecovers technical controls inside an agent: tool allow-lists, intent classification, trust scoring, audit trails. This skill covers the organisational question of who approves what. The SKILL.md cross-references it explicitly and states the division: this one decides what needs a gate,agent-governanceimplements the gate.I also checked
structured-autonomy-plan,structured-autonomy-implement, andcreate-architectural-decision-record. Those cover planning and recording decisions, not allocating approval authority over AI output.On two checklist items
I have left "tested with GitHub Copilot" and "ran
npm startand verified README.md is up to date" unticked, because I have not done either and did not want to assert otherwise.On the first: the skill is instructions only, with no scripts or assets. I validated the zone boundaries by walking a mixed set of decisions through the three questions, including the split case where drafting and publishing in one workflow separate across two zones. I have not run it inside a Copilot session end to end. Say the word if that is a hard requirement and I will do it and report back.
On the second: recent merged skill PRs in this repo touch only
skills/<name>/, so I assumed the tables are generated by the build rather than committed by contributors. Happy to run it and push the result.Notes
Single file, no bundled assets, no external dependencies, no paid services. I did not regenerate the docs tables, since recent merged skill PRs touch only
skills/<name>/and the tables appear to be generated by the build. Happy to runnpm run buildand push the result if you would like it in the PR.The zone model is adapted from published practitioner work across 16 product launches in one enterprise function. Specific percentages from that deployment are deliberately omitted, because the boundaries generalise and the distribution does not. Provenance is stated at the bottom of the SKILL.md.
Pull Request Checklist
npm startand verified thatREADME.mdis up to date.mainbranch for this pull request.Description
Type of Contribution
Additional Notes
By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.