Skip to content

docs: add 4 essential ADRs (0006, 0007, 0014, 0016)#1824

Merged
OneStepAt4time merged 1 commit intodevelopfrom
docs/adr-essential-files
Apr 14, 2026
Merged

docs: add 4 essential ADRs (0006, 0007, 0014, 0016)#1824
OneStepAt4time merged 1 commit intodevelopfrom
docs/adr-essential-files

Conversation

@OneStepAt4time
Copy link
Copy Markdown
Owner

Summary

Creates 4 essential Architecture Decision Records as prioritized by Athena's ADR assessment.

ADRs Created

Number Title Priority
ADR-0006 Aegis as Middleware, Not Agent Framework High
ADR-0007 Server Decomposition into Fastify Plugins High
ADR-0014 Multi-line Message Sending via tmux Line-by-Line High
ADR-0016 Release-please with GitHub App Token High

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

  • 4 new ADR files in
  • 1 updated index in

Closes Athena's ADR assessment priority items

Aegis version: 0.5.3-alpha
Milestone: Documentation
Assignee: Scribe

Copy link
Copy Markdown
Contributor

@aegis-gh-agent aegis-gh-agent bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Approved — 4 essential ADRs covering middleware thesis, server decomposition, multi-line tmux fix, and GitHub App token strategy.

@OneStepAt4time OneStepAt4time merged commit 9483262 into develop Apr 14, 2026
11 checks passed
@OneStepAt4time OneStepAt4time deleted the docs/adr-essential-files branch April 14, 2026 19:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant