| 1 | <!-- English translation of adr/0077-tech-principles-hub.md. Canonical Russian: ../../adr/0077-tech-principles-hub.md --> |
| 2 | |
| 3 | # ADR 0077: TECH - the center of principles (connected text from the canon) |
| 4 | |
| 5 | **Status:** Proposed |
| 6 | **Date:** 2026-04-20 |
| 7 | |
| 8 | **Purpose:** one **input** ADR for the reader: **how we think about technology** - module boundaries, contracts with the outside world, agent, debugging and repository infrastructure - without going through dozens of records. Details and exception tables are in the original ADR and in [architecture-policy.md](../../architecture-policy.md). |
| 9 | |
| 10 | **Text canon** below - files in [`snippets/tech/`](snippets/tech/README.md); wording changes are made there, this ADR sets the structure and **Proposed/Accepted** status for the TECH “center”. |
| 11 | |
| 12 | ## Related ADRs |
| 13 | |
| 14 | | ADR | Role | |
| 15 | |-----|------| |
| 16 | | [0006](0006-presentation-layers-and-feature-slices.md) | layers and slices | |
| 17 | | [0008](0008-mcp-contracts-and-testable-infrastructure.md) | Stable MCP contracts and testable infrastructure | |
| 18 | |
| 19 | ### Outside ADR |
| 20 | |
| 21 | | Document | Role | |
| 22 | |----------|------| |
| 23 | | [TECH/README.md](TECH/README.md) | pointer `TECH/` | |
| 24 | | [TECH/principles.md](TECH/principles.md) | TECH/principles | |
| 25 | **Build:** in GitHub raw `{{ INCLUDE }}` are not expanded - for reading “like a book”: `dotnet script build-adr.csx` (expanded `0077` will go into the general workbook) or collect HTML from the root `docs/adr` point by point after including 0077 in your `adr-book.md`. |
| 26 | |
| 27 | --- |
| 28 | |
| 29 | ## Introduction |
| 30 | |
| 31 | The goal is **not “all in one monolith”** and not “everyone on their own”: **consistent boundaries** between UI, scripts and the outside world, plus a **fair** outline for human and agent (debugging, transport, contracts). Below are two blocks: **contracts and infrastructure**, then **agent, debugging and observability**. |
| 32 | |
| 33 | {{ INCLUDE: snippets/tech/0077-boundaries-contracts-and-infra.md }} |
| 34 | |
| 35 | {{ INCLUDE: snippets/tech/0077-agent-debug-and-observability.md }} |
| 36 | |
| 37 | --- |
| 38 | |
| 39 | ## Consequences |
| 40 | |
| 41 | - Onboarding and reviews can link **"start with [0077](0077-tech-principles-hub.md)"**, then follow the links to full ADRs. |
| 42 | - Expansion of the “center” - new sections in `snippets/tech/` + new `INCLUDE` here; There is no need to duplicate long text in several ADRs unnecessarily. |
| 43 | |
| 44 | --- |
| 45 | |
| 46 | ## Rejected alternatives |
| 47 | |
| 48 | - **Table of references only** - not enough for a reader who wants **one coherent text** (see [TECH/principles.md](TECH/principles.md) as a map, not as a replacement for this ADR). |
| 49 | - **Duplicate the entire standard** from 0008/0002 in this file - out of sync; canon remains in the original ADR+ snippets. |