Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 30 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,52 @@
# Evolith: Progressive Architecture Reference Base
<div align="center">

# Evolith

### Progressive Architecture Reference Base

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Restore README bilingual parity

This added ### heading changes the English README to 10 ##/### headers while README.es.md remains at 9, violating the repo's bilingual parity rule from AGENTS.md/global-rules.md. I checked node .harness/scripts/validate-docs.mjs, and it now fails with README.es.md:1 bilingual structural mismatch: 10 headers in EN vs 9 in ES, so this commit will block the documented pre-commit/doc validation path unless the Spanish counterpart is updated or the heading structure is kept in sync.

Useful? React with 👍 / 👎.


[![Status](https://img.shields.io/badge/Status-Active-brightgreen?style=for-the-badge)]()
[![Method](https://img.shields.io/badge/Method-Spec--driven_AI--DD-blueviolet?style=for-the-badge)]()
[![License](https://img.shields.io/badge/License-MIT-informational?style=for-the-badge)]()
[![CI](https://img.shields.io/github/actions/workflow/status/beyondnetcode/evolith_arch32/docs.yml?style=for-the-badge&label=CI)](https://github.com/beyondnetcode/evolith_arch32/actions)
[![Coverage](https://img.shields.io/badge/Coverage-66%25-yellow?style=for-the-badge)](./COVERAGE_REPORT.md)

**Evolith is the corporate architecture upstream for product repositories.** It defines reusable architecture standards, governance rules, ADRs, patterns, and operating guidance that satellite products inherit and specialize.
<br/>

<a href="./reference/governance/sdlc/assets/master-view.png" title="Evolith E2E Product Vision — click to enlarge">
<img src="./reference/governance/sdlc/assets/master-view.png"
alt="Evolith E2E Product Vision"
width="780"
style="border-radius: 8px; box-shadow: 0 4px 20px rgba(0,0,0,0.3);" />
</a>

<sub>↑ Evolith E2E Product Vision · MD3 — <i>click to enlarge</i></sub>

<br/>

**Evolith is the corporate architecture upstream for product repositories.**<br/>
It defines reusable architecture standards, governance rules, ADRs, patterns,<br/>
and operating guidance that satellite products inherit and specialize.

> *Separate conceptually before separating physically.*

Language: [English](./README.md) | [Español](./README.es.md)

</div>

---

## Evolith SDK CLI (Oficial)

Para automatizar la adopción de Evolith en nuevos repositorios satélite o integrar herramientas IDE (vía OpenCode/MCP), recomendamos fuertemente utilizar el CLI oficial.

**[Ver Documentación del CLI](./sdk/cli/README.md)**
**[Ver Documentación del CLI](./sdk/cli/README.md)**

```bash
npx @evolith/cli init
```

Evolith solves a common enterprise problem: teams need one clear place to understand what is reusable policy, what is a product-specific implementation, and how decisions are promoted from real products back into the architecture reference.

> Separate conceptually before separating physically.

Language: [English](./README.md) | [Español](./README.es.md)

---

## Key Entry Points
Expand Down
Binary file added reference/governance/sdlc/assets/master-view.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading