Skip to content

매니페스트 aoa.yaml ​

저장소 루트에 둡니다. 보기:

yaml
kind: plugin            # plugin | mcp-server | harness | agent | skill | domain
code: hotel-finder
version: 1.2.0
menu: [travel]          # 카테고리 코드(앱이 주는 목록 안에서)
author: { name: "…", url: "https://github.com/…" }
license: MIT
repository: https://github.com/example/hotel-finder
release: { tag: v1.2.0 }   # 검수 때 커밋 SHA · 해시를 고정
description: { en: "Find hotels in a city and compare prices.", ko: "…" }   # 사람용
ai:                     # 모델용 — 영문 필수
  summary: "Search hotels by city, dates and guests; returns a ranked list with prices."
  when_to_use: "User asks to find, compare or book a hotel."
  when_not_to_use: "Flights or rental cars."
  tools:
    - name: search_hotels
      description: "Search hotels. Read-only."
      input_schema: { city: string, check_in: date, check_out: date, guests: integer }
      writes: false     # true 면 사용자 승인(객관식)을 거칩니다
  examples: ["Find a hotel in Berlin for 2 nights from Oct 20"]
permissions: [network:api.example.com]
entry: { tab: dist/index.html }   # plugin 은 탭 화면 · mcp-server 는 command/url · domain 은 url

규칙: 칸 길이 상한이 있습니다 · ai 글은 데이터로만 읽힙니다(지시문을 넣어도 모델이 따르지 않게 감쌉니다) · writes: false 라고 적고 실제로 쓰는 도구는 검수에서 막힙니다.

2026-10-10 기준 초안입니다. 이름(aoa.yaml / aoa.json)과 칸은 바뀔 수 있습니다.