architecture-refactoring-paths SKILL.md skillA
architecture-refactoring-paths from robsonkades/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add robsonkades/agent-skills/architecture-refactoring-paths@git:20260927.9ecadfdPins git:20260927.9ecadfd in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- robsonkades/agent-skills
- Path
skills/architecture-refactoring-paths/SKILL.md- Versions recorded
- 5
- Latest version
- git:20260927.9ecadfd, committed Sep 27, 2026
- First version recorded
- Sep 3, 2026
- Size
- 9,454 bytes
- Repository stars
- 3
- License
- Apache-2.0
Sequence a chosen enterprise architecture change into compatible, testable checkpoints: domain and persistence refactoring, remote boundaries, session state, locking or events. Use when old and new paths must coexist, a migration has stalled, code and data changes interact, consumers cannot upgrade together, or rollback and safe pause points are unclear. Does not select target patterns, diagnose the need for change (enterprise-architecture-smells), plan a whole modernization programme…
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Architecture Refactoring Paths
## Purpose
Sequence an agreed architectural change into compatible, testable checkpoints. Establish
the current and target contract rather than selecting a pattern from fashion. Incremental
delivery limits exposure when coexistence and recovery are explicit; it is not automatically
safer than a bounded, rehearsed cutover.
The useful target is that an architectural refactor can be paused at documented checkpoints without
leaving correctness dependent on completing the next step. Some migrations have an intentionally
atomic cutover; make its recovery procedure, compatibility window and irreversible point explicit.
## The shape of every path here
```text
1. Characterise pin current behaviour with tests at the level that
will survive the change (usually the use case).
2. Introduce add the new structure BESIDE the old. Nothing is
removed yet; both work.
3. Route one case move a single, low-risk case to the new path. Ship.
4. Widen move cases one at a time, each shipped separately.
5. Contract remove the old structure when nothing uses it.
…Read the whole file at its exact version.
How to install
mdr add robsonkades/agent-skills/architecture-refactoring-paths@sha256:497234dbf13ec0afThe line at the top of this page pins the label git:20260927.9ecadfd, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_mp4le7n2hvox52ed)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Sep 3, 2026 and Sep 27, 2026, about one every 6 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260927.9ecadfd latest | 2026-09-27 | 9ecadfd | 9,454 B | A | view · diff |
| git:20260923.832673e | 2026-09-23 | 832673e | 9,151 B | A | view · diff |
| git:20260911.37b054b | 2026-09-11 | 37b054b | 8,915 B | A | view · diff |
| git:20260906.e6ad4bd | 2026-09-06 | e6ad4bd | 8,814 B | A | view · diff |
| git:20260903.f199530 | 2026-09-03 | f199530 | 7,662 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (9454 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
robsonkades/agent-skills · 3 stars · license Apache-2.0 · pushed 2026-10-28 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_mp4le7n2hvox52ed GET https://markdownregistry.com/api/v1/resolve?ref=robsonkades/agent-skills/architecture-refactoring-paths GET https://markdownregistry.com/api/v1/blob/497234dbf13ec0afc67e640467dbb6b1cc85bad5803f1c25e7bc13692ea71368
Your AI assistant 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.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.