architecture is agent-read markdown (skill) from afonsoft/skills: Single owner of everything under docs/architecture/ — ADRs, architecture and design documents, and architecture diagrams. Routes each deliverable to the right engine: /mermaid-architecture for Markdown-native diagrams, /drawio-architecture for editable .drawio diagrams, and the optional archify skill for interactive standalone HTML diagrams (used only when already installed in the environment; never installed at runtime). Use whenever architecture documentation, ADRs, or architecture diagrams mu.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# Architecture
The single entry point for **all repository architecture deliverables**. Instead of calling diagram skills directly, agents invoke `/architecture` and this skill routes each deliverable to the right engine. It owns the `docs/architecture/` folder end to end: ADRs, design documents, and every diagram format.
All questions and confirmations directed at the user must be in **Portuguese (pt-BR)**. Internal reasoning and documentation are in English.
## Ownership — `docs/architecture/`
Everything that describes or decides the system's architecture lives here:
```text
docs/architecture/
├── AD-NNNN-<slug>.md # Architecture Decision Records
├── architecture-design.md # Architecture design doc
├── system-design.md # System design doc
├── api-design.md # API design doc
├── database-design.md # Database design doc
├── feature-<name>-design.md # Feature-scoped design doc
├── system-architecture.md # Markdown doc with embedded Mermaid
├── <name>_<type>_<title>.mmd # Mermaid sources
…
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
A 17 of 17 checks passed. Deterministic, no model, same answer every run.
pass: Frontmatter block present
pass: Frontmatter declares a name
pass: Frontmatter declares a description
pass: Size between 200 bytes and 200 KB (12403 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag
Source
GitHub
afonsoft/skills · 8 stars · license MIT · pushed 2026-09-23 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_6oo245ryq4s2afq3
GET https://markdownregistry.com/api/v1/resolve?ref=afonsoft/skills/architecture
GET https://markdownregistry.com/api/v1/blob/9db273a7fca54a032ffb23b9398ad9311f9aa89adf90cb8c29dc3e4ac3a58b04
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
afonsoft/skills · skills/composio-mcp/SKILL.md · Use when the user asks to connect an AI agent to external apps via Composio, or when Composio CLI or MCP setup fails.
afonsoft/skills · skills/design/SKILL.md · Use when designing, redesigning, or improving a frontend interface in Angular, React, or Blazor. Use for landing pages…
afonsoft/skills · skills/diagnose/SKILL.md · Use when the user reports a hard bug, unexpected failure, or performance regression that needs root-cause analysis.
afonsoft/skills · skills/drawio-architecture/SKILL.md · Use when generating or editing draw.io/diagrams.net architecture diagrams via MCP or native XML.
afonsoft/skills · skills/gap-analysis/SKILL.md · Use when auditing a repository for evidence-backed gaps between code, SPECs, architecture, and documentation — before a…
afonsoft/skills · skills/improve-codebase-architecture/SKILL.md · Use when the user wants to improve architecture, consolidate tightly-coupled modules, or make a codebase more testable.
geekfujiwara/codeappsdevelopmentstandard · .github/skills/architecture/SKILL.md · Power Platform ソリューションの全体アーキテクチャを設計する。Copilot Studio / Power Automate / Code Apps / Power Pages / AI Builder…
kanevry/session-orchestrator · .agents/skills/architecture/SKILL.md · Use when the user asks to improve architecture, find refactoring opportunities, surface deepening opportunities…
