docs: add 4 essential ADRs (0006, 0007, 0014, 0016)#1824
Merged
OneStepAt4time merged 1 commit intodevelopfrom Apr 14, 2026
Merged
docs: add 4 essential ADRs (0006, 0007, 0014, 0016)#1824OneStepAt4time merged 1 commit intodevelopfrom
OneStepAt4time merged 1 commit intodevelopfrom
Conversation
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.
Summary
Creates 4 essential Architecture Decision Records as prioritized by Athena's ADR assessment.
ADRs Created
ADR-0006: Aegis as Middleware, Not Agent Framework
Documents the core product thesis: Aegis = Enterprise Orchestration Middleware. Intelligence stays outside. Three deployment tiers. Kill your darlings (Consensus Review, Model Router).
ADR-0007: Server Decomposition into Fastify Plugins
Documents the server.ts decomposition plan: ~8 plugins, each <200 lines, PRs <500 lines, zero API changes, target server.ts <200 lines.
ADR-0014: Multi-line Message Sending via tmux Line-by-Line
Documents the fix for #1770: send multi-line content line-by-line via tmux instead of truncating at first newline. Fixes P1 truncation bug.
ADR-0016: Release-please with GitHub App Token
Documents why GitHub App tokens are used over PATs for release automation. Covers configuration and security considerations.
Changes
Closes Athena's ADR assessment priority items
Aegis version: 0.5.3-alpha
Milestone: Documentation
Assignee: Scribe