architecture is agent-read markdown (skill) from lstr-1/skills: Use when the user asks to improve architecture, find refactoring opportunities, surface deepening opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable. Surfaces shallow modules and hypothetical seams using a precise vocabulary (Module / Interface / Implementation / Depth / Seam / Adapter / Leverage / Locality from LANGUAGE.md)..
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
# Improve Codebase Architecture
Surface architectural friction and propose **deepening opportunities** — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.
## Glossary
Use these terms exactly in every suggestion. Consistent language is the point — don't drift into "component," "service," "API," or "boundary." Full definitions in [LANGUAGE.md](LANGUAGE.md).
- **Module** — anything with an interface and an implementation (function, class, package, slice).
- **Interface** — everything a caller must know to use the module: types, invariants, error modes, ordering, config. Not just the type signature.
- **Implementation** — the code inside.
- **Depth** — leverage at the interface: a lot of behaviour behind a small interface. **Deep** = high leverage. **Shallow** = interface nearly as complex as the implementation.
- **Seam** — where an interface lives; a place behaviour can be altered without editing in place. (Use this, not "boundary.")
- **Adapter** — a concrete thing satisfying an interface at a seam.
- **Leverage** — what callers get from depth.
…
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.
GET https://markdownregistry.com/api/v1/artifacts/art_3wzxgdzsrul4eyiz
GET https://markdownregistry.com/api/v1/resolve?ref=lstr-1/skills/architecture
GET https://markdownregistry.com/api/v1/blob/4354b4a83edb349658ca17cfa76f306ade2d2c1bd4341e1d690f2ab3cf168b8e
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.
lstr-1/skills · create-skill/SKILL.md · Use when the user wants to create, design, or generate a new AI agent skill (SKILL.md) from a problem description. This…
lstr-1/skills · monitor-startup-dach/SKILL.md · Fetch the top-25 posts from r/StartupDACH/hot.json, classify each into six deterministic German intent clusters…
lstr-1/skills · nlm-meta-study/SKILL.md · Create scientific meta-studies on any topic using Gemini Notebook (NotebookLM). Invoke for systematic reviews…
lstr-1/skills · orchestrator/skills/architecture/SKILL.md · Use when the user asks to improve architecture, find refactoring opportunities, surface deepening opportunities…
lstr-1/skills · orchestrator/skills/autopilot/SKILL.md · Use this skill when running an autonomous session-orchestration loop. Chains session-start → session-plan →…
lstr-1/skills · orchestrator/skills/bootstrap/SKILL.md · Use this skill when scaffolding the minimum repository structure required by orchestrator. Invoked automatically by the…
lstr-1/skills · orchestrator/skills/brainstorm/SKILL.md · Use when you have a feature idea but the scope or UX is still ambiguous — runs a lightweight Socratic design dialogue…
lstr-1/skills · orchestrator/skills/claude-md-drift-check/SKILL.md · Use when detecting drift between CLAUDE.md (or AGENTS.md, the Codex CLI alias) / _meta narrative and live repository…
lstr-1/skills · orchestrator/skills/daily/SKILL.md · Use this skill when creating today's daily note in the Meta-Vault (03-daily/YYYY-MM-DD.md) with valid…
lstr-1/skills · orchestrator/skills/debug/SKILL.md · Use when encountering any bug, test failure, build break, or unexpected behavior — runs a 4-phase systematic debugging…
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…
