docs(architecture): mapa hexagonal del monorepo (18 componentes)#51
Merged
Conversation
Versioned architecture map of the monorepo under .straymark/architecture/: the lnxdrive-engine workspace crates, the GNOME integration and the experimental UIs, classified into the project's hexagonal layers (presentation / application / domain / outbound-adapters / infrastructure) per lnxdrive-guide/03-Arquitectura/01-arquitectura-hexagonal.md. - model.yml — 18 components × 5 layers, with inter-component links - plan.drawio — layered box diagram (opens in any DrawIO editor) The format is StrayMark Loom Spec 002 (`straymark architecture validate` passes: 18 components, exit 0), but the value kept here is the standalone map. We are NOT adopting the Loom dashboard: its knowledge graph treats SpecKit task refs (related: [T0xx]) as broken links, and the "you are here" status overlay does not wire up — not worth the cost for a single-operator project. See analysis in conversation. packaging/guide/testing are intentionally out of scope (no source code). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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
1 participant
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.
Resumen
Añade un mapa de arquitectura versionado del monorepo bajo
.straymark/architecture/, clasificando los crates del workspacelnxdrive-engine, la integración GNOME y las UIs experimentales en las capas hexagonales del proyecto (presentation / application / domain / outbound-adapters / infrastructure), segúnlnxdrive-guide/03-Arquitectura/01-arquitectura-hexagonal.md.model.yml— 18 componentes × 5 capas, con enlaces entre componentes.plan.drawio— diagrama de cajas por capa (se abre en cualquier editor DrawIO).Contexto: por qué el mapa sí, el dashboard no
El formato es StrayMark Loom Spec 002 (
straymark architecture validate→ 18 componentes, exit 0), pero lo que se conserva es el mapa autónomo, no el dashboard de Loom.Tras evaluar Loom decidimos no adoptarlo como herramienta de trabajo:
related: [T0xx], trazabilidad intencional), 18 son refs cross-artefacto (US2,FR-019, rutas alnxdrive-guide/), y los 8 "doc-ref rotos" resuelven a archivos existentes (desajuste id-corto vs nombre-con-slug). Loom interpretarelated:como enlaces doc→doc; lnxdrive lo usa para trazabilidad multi-artefacto.uncharted).packaging/guide/testingquedan fuera de alcance a propósito (sin código fuente; Loom solo cuenta archivos de código).Notas
.drawioes estándar y elmodel.ymles un inventario estructurado de componentes.🤖 Generated with Claude Code