docs: Add ADR/AID templates and ADR-0001: agent planning rules#730
Open
adamreynolds-io wants to merge 3 commits intomainfrom
Open
docs: Add ADR/AID templates and ADR-0001: agent planning rules#730adamreynolds-io wants to merge 3 commits intomainfrom
adamreynolds-io wants to merge 3 commits intomainfrom
Conversation
Introduce MADR-compatible ADR template and AID template for agent-assisted planning. ADR-0001 establishes rules for how agents plan and execute work. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Engineers can skip the ADR/AID cycle at their judgement, with a one-line justification in the PR description. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
timjroberts
reviewed
Mar 26, 2026
Contributor
timjroberts
left a comment
timjroberts
left a comment
There was a problem hiding this comment.
Looks sensible. Only thoughts in my mind:
- Indicate that the ADR may be assisted by AI? Right now in the proposed lifecycle it shows Engineer + AI which implies that this is always the case. At least it did to me on first glance.
- Is the ADR and AID produced in separate PRs, or through a draft PR? Or is this process local to the Engineer's machine?
There may be use for wider team review at each gate before the AI agent executes the AID?
sp-io
changed the title
Contributor
|
Is the Gitnexus a mandatory tool right now ? I think we should be tool agnostic in such a document. Gitnexus should be specified in CLAUDE.md / AGENTS.md. |
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
3 participants
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.
Summary
docs/adr/TEMPLATE.mddocs/aid/TEMPLATE.mdWhat are AIDs?
AIDs are derived from accepted ADRs. They translate a human decision into scoped, executable guidance for agents — with planning rules, affected components, validation criteria, and anti-patterns.
ADR/AID lifecycle
Test plan
🤖 Generated with Claude Code