b3os-ai-code-safety SKILL.md skillA
b3os-ai-code-safety from b3rys/b3rys-team-os is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add b3rys/b3rys-team-os/b3os-ai-code-safety@git:20261030.37413e2Pins git:20261030.37413e2 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- b3rys/b3rys-team-os
- Path
skills/b3os-ai-code-safety/SKILL.md- Versions recorded
- 18
- Latest version
- git:20261030.37413e2, committed Oct 30, 2026
- First version recorded
- Jul 23, 2026
- Size
- 19,488 bytes
- Repository stars
- 18
- License
- Apache-2.0
AI 가 만들거나 고친 코드의 구조·리팩토링 가이드. 프로그램 구조 설계, 새 코드 작성, 코드 리뷰, 코드 냄새(한 곳을 고치면 여러 곳이 바뀌거나 엉뚱한 곳이 깨짐) 리팩토링 때 쓴다. SOLID 경계, 부수효과를 줄이는 구조, 동시성·트랜잭션·멱등성 게이트, 외부 입력 처리, 테스트 규칙을 다룬다.
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
# AI Code Safety — 구조와 리팩토링 코드가 커지면 비용은 정상 경로가 아니라 결합(coupling)에서 나온다. 한 곳을 고치면 건드리지 않은 곳이 깨진다. 처음부터 변경이 한 곳에 머무는 구조로 짓고, 부수효과가 있는 곳에 운영 안전 게이트를 적용하고, 냄새가 나면 의도적으로 리팩토링한다. 팀 작업 규칙(백업·원문 유지)은 TEAM-OS 에 있다. ## 1. 설계 (쓰기 전에 구조) - 데이터 흐름과 단일 출처를 먼저 정한다. read → transform → write 를 그리고 상태마다 source of truth 하나를 적는다. 필드를 빠뜨리는 동기화 사본이 아니라 실제 원본을 읽는지 확인한다(사본을 읽으면 컴파일·단위 테스트는 통과하고 출력만 틀린다). - SOLID 는 결합을 줄이는 관점으로 쓴다. 의존은 안쪽으로: 도메인 로직이 프레임워크·ORM·HTTP·인프라에 의존하지 않는다(DIP, 구체 타입 대신 추상에 의존). 모듈마다 바뀌는 이유는 하나(SRP). 쓰는 만큼만 의존(ISP). 실제 확장 축이 있을 때만 추상화를 더한다(OCP 는 미리 하지 않는다). - 모듈 경계는 바뀔 결정(저장소·포맷·알고리즘)을 숨긴다. 공개 계약은 스키마/인터페이스/이벤트/API 이고, 개념마다 소유자 하나이며 같은 가변 상태를 쓰는 모듈이 둘이면 안 된다. - 서버는 상태(코드)와 데이터를 주고 클라이언트가 문장·아이콘·UI 로 보여 준다. 사람이 읽는 문장·튜닝 숫자·AI 지시문은 코드가 아니라 문구·설정 파일에 둔다(문구 수정과 다국어 추가에 코드 수정이 없도록). 디버깅 로그처럼 개발자만 보는 문장은 코드에 둘 수 있다. - 단순하게 시작하고, 변경이 부수효과를 내기 시작할 때 구조를 바꾼다. 기준은 크기가 아니라 클래스/함수 하나가 일을 너무 많이 맡아 하나를 고치면 다른 게 깨지는지다. 싼 신호부터: - 여러 영역이 같은 공유 필드에 직접 쓰는 수(주 신호). 가드 테스트로 늘면 실패시키고, 필드마다 진입점 하나를 목표로 한다. - 한 영역의 변이(mutant)가 다른 영역의 테스트를 실패시키면 그 지점이 결합점이다. 거기서 나눈다. - 상태를 필드 셋 이상의 `if` 조합으로 판정하면 상태 값 하나 + `reduce(state, event) → (state, effects)` 표로 바꾼다(`references/worked-examples.md`). …
Read the whole file at its exact version.
How to install
mdr add b3rys/b3rys-team-os/b3os-ai-code-safety@sha256:971bffee348f39d6The line at the top of this page pins the label git:20261030.37413e2, 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_46aimcsb5gf6deaa)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 18 versions of this file, between Jul 23, 2026 and Oct 30, 2026, about one every 6 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261030.37413e2 latest | 2026-10-30 | 37413e2 | 19,488 B | A | view · diff |
| git:20261030.1a0a097 | 2026-10-30 | 1a0a097 | 19,085 B | A | view · diff |
| git:20261030.636761b | 2026-10-30 | 636761b | 37,217 B | A | view · diff |
| git:20261025.e6b8f4d | 2026-10-25 | e6b8f4d | 37,223 B | A | view · diff |
| git:20261022.5783ea6 | 2026-10-22 | 5783ea6 | 36,677 B | A | view · diff |
| git:20261016.a4c2f28 | 2026-10-16 | a4c2f28 | 35,797 B | A | view · diff |
| git:20261015.242bbbd | 2026-10-15 | 242bbbd | 32,237 B | A | view · diff |
| git:20261015.8eb781c | 2026-10-15 | 8eb781c | 33,529 B | A | view · diff |
| git:20261013.eafeaa6 | 2026-10-13 | eafeaa6 | 31,089 B | A | view · diff |
| git:20261011.71caf76 | 2026-10-11 | 71caf76 | 27,362 B | A | view · diff |
| git:20261010.ecd4362 | 2026-10-10 | ecd4362 | 26,565 B | A | view · diff |
| git:20261010.350d34c | 2026-10-10 | 350d34c | 25,806 B | A | view · diff |
| git:20260927.f9ab9ed | 2026-09-27 | f9ab9ed | 24,688 B | A | view · diff |
| git:20260924.2302b08 | 2026-09-24 | 2302b08 | 23,241 B | A | view · diff |
| git:20260924.a3dfbaf | 2026-09-24 | a3dfbaf | 24,173 B | A | view · diff |
| git:20260801.9cc5479 | 2026-08-01 | 9cc5479 | 20,079 B | A | view · diff |
| git:20260731.191f251 | 2026-07-31 | 191f251 | 20,048 B | A | view · diff |
| git:20260723.55ddc12 | 2026-07-23 | 55ddc12 | 18,752 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 (19488 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
b3rys/b3rys-team-os · 18 stars · license Apache-2.0 · pushed 2026-11-06 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_46aimcsb5gf6deaa GET https://markdownregistry.com/api/v1/resolve?ref=b3rys/b3rys-team-os/b3os-ai-code-safety GET https://markdownregistry.com/api/v1/blob/971bffee348f39d640b9ecdd0ebcccb17377464830fdb3615897ac961961bd36
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.