ONEDEV

mda

sno-ai파일 240개

★ 618주당 +1조회 4

무엇인가

MDA는 에이전트가 읽는 문서를 위한 Markdown 상위 집합 규격이자, 그 규격을 컴파일하는 스킬 팩이다. 규율하는 영역은 세 가지다. 에이전트 지시문의 단일 소스화, 문서 간 의존 관계의 기계 판독 가능한 표기, 로드 시점의 무결성·서명 검증이다. 본문 Markdown은 그대로 렌더되고 표준 frontmatter 필드도 그대로 로드되며, MDA가 추가하는 요소는 모두 선택 사항이다.

어떻게 동작하나

동작 방식은 컴파일이다. `.mda` 소스의 YAML frontmatter에 `doc-id`, `version`, `requires`, `depends-on`, `relationships`, `tags`를 적고, 각주 페이로드에 `parent`, `child`, `related`, `cites`, `supports`, `contradicts`, `extends` 관계를 JSON 객체로 넣는다. `mda compile`을 실행하면 `SKILL.md`(+ scripts/, references/, assets/), `AGENTS.md`, `MCP-SERVER.md`(+ mcp-server.json 사이드카), `CLAUDE.md`가 출력되고, 각주 관계는 본문 순서대로 `metadata.mda.relationships`에 반영된다. 별도 훅이나 슬래시 명령이 아니라 각 런타임이 이미 자동 로드하는 파일명으로 배치되는 방식이다.

무엇과 다른가

프롬프트 직접 작성이나 단일 규칙 파일과 구조적으로 다르다. 첫째, 산출물이 런타임별 frontmatter 모양으로 갈라지지 않고 한 소스에서 나오므로 한쪽만 갱신되어 지시문이 어긋나는 일이 생기지 않는다. 둘째, `requires`·`depends-on`으로 버전 범위와 내용 다이제스트를 포함한 타입 지정 의존 그래프를 표현하고 JSON Schema로 검증한다. 셋째, JCS 정규화 `integrity.digest`와 DSSE 봉투·Sigstore 앵커링 `signatures[]`를 frontmatter 자체에 실어, 로드하는 에이전트와 검토하는 사람 모두 저장소 평판이 아니라 손에 든 산출물을 기준으로 신뢰를 판단한다.

어떻게 쓰나

사용 절차는 `.mda` 파일을 작성하고 컴파일한 뒤 산출물을 대상 런타임의 규칙 파일 위치에 두는 것이다. `compat/`에 SKILL.md 런타임 5종의 재현 가능한 설치 키트가 있고, 컴파일된 `AGENTS.md`는 AAIF 생태계(Codex, Copilot, Cursor, Windsurf, Amp, Devin, Gemini CLI, VS Code, Jules, Factory)에 그대로 들어간다. 표준 frontmatter만 쓴 `.mda`는 변경 없이 `.md`로 컴파일되므로, 프로젝트에 필요한 만큼만 MDA 확장을 켜면 된다.

전제와 한계

전제와 한계. `mda compile`을 실행할 컴파일러가 있어야 하고, 다이제스트·서명 검증에는 Sigstore와 DSSE를 다루는 도구 체인이 필요하다. README 기준으로 SKILL.md 런타임 5종이 end-to-end로 검증되었고, skills.sh 등 2026 SKILL.md 소비자에 대해서는 문서 수준 호환이며, AAIF 쪽은 컴파일된 `AGENTS.md` 산출물 단위로 들어간다. MDA 확장 필드를 해석하지 않는 런타임에서는 해당 메타데이터가 무시되고 본문만 로드된다.

유사 스킬