agentic-domain-document 0.6.0

package/.tbls.yml

@@ -0,0 +1,201 @@
+name: agentic-domain-document
+desc: Agentic Platform document domain database.
+
+dsn: ${AGENTIC_DOMAIN_DOCUMENT_SCHEMA_DSN}
+docPath: ${AGENTIC_DOMAIN_DOCUMENT_SCHEMA_DOC_PATH}
+
+format:
+  adjust: true
+  sort: false
+  number: false
+  hideColumnsWithoutValues: true
+
+er:
+  skip: false
+  format: svg
+  comment: true
+  hideDef: true
+  showColumnTypes:
+    related: true
+    primary: true
+  distance: 1
+
+include:
+  - document_*
+
+comments:
+  - table: document_code_groups
+    tableComment: 코드 그룹을 정의한다.
+    columnComments:
+      code_group_code: 코드 그룹 식별자
+      code_group_name: 코드 그룹 한글명
+      description: 코드 그룹 설명
+      sort_order: 표시 정렬 순서
+      is_active: 활성 여부
+      created_at: 생성 시각
+      updated_at: 수정 시각
+
+  - table: document_codes
+    tableComment: 코드 그룹별 코드 값을 정의한다.
+    columnComments:
+      code_group_code: 코드 그룹 식별자
+      code: 코드 값
+      code_name: 코드 한글명
+      description: 코드 설명
+      sort_order: 표시 정렬 순서
+      is_active: 활성 여부
+      metadata_json: 확장 메타데이터
+      created_at: 생성 시각
+      updated_at: 수정 시각
+
+  - table: document_node_taxonomies
+    tableComment: 문서 유형별 node level 해석 정책을 정의한다.
+    columnComments:
+      taxonomy_id: taxonomy 식별자
+      taxonomy_code: taxonomy 코드
+      taxonomy_name: taxonomy 이름
+      document_type_code: 문서 유형 코드
+      default_toc_level_limit: 기본 TOC 포함 level
+      description: 설명
+      is_active: 활성 여부
+      created_at: 생성 시각
+      updated_at: 수정 시각
+
+  - table: document_node_taxonomy_levels
+    tableComment: taxonomy별 node level 라벨, 번호 정책, counter scope를 정의한다.
+    columnComments:
+      taxonomy_level_id: taxonomy level 식별자
+      taxonomy_id: taxonomy 식별자
+      node_level: node level
+      node_label_code: node label 코드
+      numbering_policy_code: 번호 정책 코드
+      counter_scope_code: 번호 카운터 범위 코드
+      sort_order: 표시 정렬 순서
+      created_at: 생성 시각
+      updated_at: 수정 시각
+
+  - table: document_documents
+    tableComment: 문서 단위 메타데이터, 작성자, taxonomy, 상태를 관리한다.
+    columnComments:
+      document_id: 문서 식별자
+      document_type_code: 문서 유형 코드
+      taxonomy_id: 적용 taxonomy 식별자
+      title: 문서 제목
+      source_document_id: 파생 원본 문서 식별자
+      version_label: 표시 버전
+      author_type_code: 작성자 유형
+      author_id: 작성자 식별자
+      author_name: 작성자 표시명
+      status_code: 문서 상태
+      toc_level_limit: TOC로 취급할 level limit
+      published_at: published 상태 전환 시각
+      created_at: 생성 시각
+      updated_at: 수정 시각
+      metadata_json: 확장 메타데이터
+
+  - table: document_nodes
+    tableComment: 문서의 계층 node tree를 관리한다.
+    columnComments:
+      node_id: 노드 식별자
+      document_id: 소속 문서 식별자
+      parent_node_id: 상위 노드 식별자
+      node_level: node level
+      node_role_code: 노드 역할 코드
+      title: 노드 제목
+      toc_visibility: TOC 표시 정책
+      numbering_policy_code: 번호 정책 코드
+      numbering_override: 수동 번호 override
+      sort_order: 형제 노드 내 정렬 순서
+      created_at: 생성 시각
+      updated_at: 수정 시각
+      metadata_json: 확장 메타데이터
+
+  - table: document_contents
+    tableComment: 특정 document node에 붙는 block collection을 관리한다.
+    columnComments:
+      content_id: content 식별자
+      document_id: 소속 문서 식별자
+      node_id: 소속 노드 식별자
+      created_at: 생성 시각
+      updated_at: 수정 시각
+      metadata_json: 확장 메타데이터
+
+  - table: document_blocks
+    tableComment: 문서 본문 표현 block을 관리한다.
+    columnComments:
+      block_id: block 식별자
+      content_id: 소속 content 식별자
+      block_type_code: block 유형 코드
+      sort_order: content 안에서의 순서
+      content_text: 텍스트 중심 block 본문
+      content_json: 구조형 block payload
+      created_at: 생성 시각
+      updated_at: 수정 시각
+      metadata_json: 확장 메타데이터
+
+  - table: document_annotations
+    tableComment: 문서 본문 밖의 note annotation을 관리한다.
+    columnComments:
+      annotation_id: annotation 식별자
+      document_id: 소속 문서 식별자
+      target_type_code: annotation 대상 유형
+      target_id: annotation 대상 식별자
+      annotation_type_code: annotation 유형
+      status_code: annotation 상태
+      note_text: note 내용
+      author_type_code: 작성자 유형
+      author_id: 작성자 식별자
+      author_name: 작성자 표시명
+      resolved_at: 해결 시각
+      created_at: 생성 시각
+      updated_at: 수정 시각
+      metadata_json: 확장 메타데이터
+
+  - table: document_revisions
+    tableComment: 하나 이상의 변경 이벤트를 묶는 의미 있는 변경 단위를 관리한다.
+    columnComments:
+      revision_id: revision 식별자
+      document_id: 소속 문서 식별자
+      revision_no: 문서별 revision 순번
+      revision_title: revision 제목
+      revision_reason: revision 사유
+      document_status_code: revision 생성 당시 문서 상태
+      created_by_type_code: revision 생성자 유형
+      created_by_id: revision 생성자 식별자
+      created_by_name: revision 생성자 표시명
+      created_at: 생성 시각
+      metadata_json: revision 요약/확장 메타데이터
+
+  - table: document_change_events
+    tableComment: revision에 속하는 로그성 변경 이벤트를 관리한다.
+    columnComments:
+      event_id: event 식별자
+      revision_id: 소속 revision 식별자
+      document_id: 소속 문서 식별자
+      sequence_no: revision 안에서의 event 순서
+      target_type_code: 변경 대상 유형
+      target_id: 변경 대상 식별자
+      change_type_code: 변경 유형
+      change_reason: 개별 변경 사유
+      changed_by_type_code: 변경자 유형
+      changed_by_id: 변경자 식별자
+      changed_by_name: 변경자 표시명
+      changed_at: 변경 시각
+      metadata_json: 이벤트 메타데이터
+
+  - table: document_versions
+    tableComment: 검토/승인/배포 기준본 snapshot을 관리한다.
+    columnComments:
+      version_id: version 식별자
+      document_id: 소속 문서 식별자
+      revision_id: 기준 revision 식별자
+      version_no: 문서별 version 순번
+      version_label: 표시 버전
+      snapshot_type_code: snapshot 유형
+      document_status_code: snapshot 당시 문서 상태
+      snapshot_json: 작은 snapshot 또는 manifest
+      checksum: snapshot checksum
+      created_by_type_code: 생성자 유형
+      created_by_id: 생성자 식별자
+      created_by_name: 생성자 표시명
+      created_at: 생성 시각

package/CHANGELOG.md

@@ -0,0 +1,68 @@
+# Changelog
+
+## 0.6.0
+
+- Adoc/Agentic Document 브랜딩 지시문과 routing keyword 추가
+- `DocumentReader`와 `createDocumentReader` public API 추가
+- `getDocumentAggregate`, `getDocumentTree`, `findBlocks`, `listDocuments`, `getLatestDocument` 조회 API 추가
+- 기본 조회용 `toMarkdown` Adoc Markdown Projection 추가
+- `DocumentMarkdownImporter`와 `createDocumentMarkdownImporter` public API 추가
+- `importMarkdownDocument`, `importMarkdownChapter` 기반 Markdown import 추가
+- Markdown Import에서 `표 N. 제목 - 요약` table caption binding 추가
+- Markdown Import에서 image alt/visible `그림 N. 제목 - 요약` figure caption binding 및 중복 caption paragraph 제거 추가
+- Adoc Markdown Projection에서 table, figure, diagram block의 기본 Markdown 복원 추가
+- table, figure, diagram block payload validation 보강
+- 참조 아키텍처 명세서 Markdown import dev-test 추가
+- Agent 지시문에 wrapper 우선, 직접 SQL 제한, Markdown Projection 직접 수정 금지 기준 추가
+- `agent/resource-selection.json` 추가
+- Document Agent resource selection을 keyword 기반 최소 JSON rule로 제공
+- Always resource, fallback baseline, TOC/Table/Diagram/Style/Validation/Traceability rule 추가
+- Document Agent public export에 `documentResourceSelection`, `documentResourceSelectionRules` 추가
+- Document Agent public export에 `selectDocumentAgentResources`, `assembleDocumentAgentContext` 추가
+- runtime CLI 등록 표준 export인 `agentContribution` alias 추가
+- revision/change event/version/annotation 일시의 UTC 저장 및 KST 표시 기준 문서화
+- `agentic-capability-agent-client@0.4.0` 의존성 반영
+
+## 0.5.0
+
+- Agent contribution 구조를 `instruction-set.json`에서 `resource-index.json`으로 전환
+- Agent 리소스를 Instruction, Guide, Example, Validator Rule, Source Mapping 5종으로 분리
+- `resourceGroups.order`로 리소스 분류 적용 순서를 가시화
+- `agent/instructions/`를 작동형 지시문 중심으로 재작성
+- 기존 상세 작성 기준을 `agent/guides/`로 분리
+- validation rule을 `agent/validation/document-validation-rules.md`로 분리
+- Document Agent public export를 `documentResourceIndex`, `documentInstructionResources`, `documentGuideResources`, `documentExampleResources`, `documentValidationRuleResources`, `documentSourceResources`로 변경
+- `agentic-capability-agent-client@0.3.0` 의존성 반영
+
+## 0.4.0
+
+- Document Agent 지시문을 참조 프로젝트 분석 결과 기반으로 대폭 보강
+- output 순수성, source 우선순위, 근거 없는 확정 금지, 본문 작성과 기준 수정 분리 정책 추가
+- Document/Content/Typed Block/Annotation/Revision/Render/Artifact 경계 설명 강화
+- 한국어 문체, 외래어, 용어, 금지 표현, 문장 개선 예시 추가
+- TOC taxonomy, level limit, visibility, numbering policy, heading 경계 기준 보강
+- Paragraph/Table/Diagram/Figure 작성 기준과 schemaRef/source/rendered artifact 분리 기준 보강
+- Document validation checklist를 document, TOC, content/block, style, table/diagram, revision/annotation, source mapping 기준으로 세분화
+- 실제 참조 프로젝트 기반 좋은 예/나쁜 예/개선 예 추가
+- Document Agent source mapping을 상세 참조 파일 기준으로 갱신
+
+## 0.3.0
+
+- `agentic-capability-agent-client` 기반 Document Agent contribution 추가
+- Document Agent manifest, capability, routing keyword를 표준 `agent/` 리소스로 외부화
+- Document 작성 지시문을 `agent/instructions/*.md` 원천 파일과 domain/policy/style/structure/block/validation/example 계층으로 구조화
+- `agent/sources/reference-mapping.md` 기반 source mapping 초안 추가
+- TypeScript agent 구현을 resource loader/export 중심으로 축소
+- Document package public export에 `documentAgentContribution` 추가
+- dev-test에 Document Agent contribution 검증 추가
+
+## 0.1.0
+
+- `agentic-domain-document` 패키지 skeleton 추가
+- Document domain의 책임 범위, 제외 범위, DB 명명 기준 문서화
+- Continuous Publish/Delivery 기반 문서 추가
+- Iteration 0 기준 build/typecheck/pack dry-run 검증 대상으로 구성
+- Document DB migration baseline 추가
+- `document_*` schema docs 생성 기준 추가
+- `createDocumentService` 기반 Repository/Service/Validator API 추가
+- Document 생성, node/content/block 추가, TOC 조회, validation, review/approve/publish, draft 복제 dev-test 추가

package/README.md

@@ -0,0 +1,313 @@
+# agentic-domain-document
+
+`agentic-domain-document`는 Agentic Platform의 문서 도메인 패키지입니다.
+
+이 패키지는 `Document`, `TOC Node`, `Content`, `Typed Block`을 관리하기 위한 하위 도메인 패키지입니다. `artifact-standard`, `artifact`, `methodology`, `knowledge` 계열 패키지는 이 패키지를 참조해서 문서 구조와 본문 block을 사용할 수 있습니다.
+
+`Adoc`은 이 패키지가 관리하는 Agentic Document의 공식 약칭입니다. Adoc은 Document/Node/Content/Block 기반으로 저장되며, `Adoc Tree`와 `Adoc Markdown Projection`으로 조회할 수 있습니다.
+
+## 현재 범위
+
+Iteration 1에서는 문서 도메인 SQLite schema baseline과 최소 Repository/Service/Validator API를 제공합니다.
+
+| 구분 | 상태 |
+| --- | --- |
+| 패키지 skeleton | 포함 |
+| 기본 문서 | 포함 |
+| build/typecheck | 포함 |
+| pack dry-run | 포함 |
+| Document DB migration | 포함 |
+| Repository/Service/Validator | 포함 |
+| Document Reader | 포함 |
+| Adoc Markdown Projection | 기본 조회용 projection 포함, table/figure/diagram 복원 포함 |
+| Markdown Import | 기본 전체 문서/챕터 import 포함, table/figure caption binding 포함 |
+| Public wrapper API | 포함 |
+| Document Agent contribution | 포함 |
+| CLI | 1차 구현 제외, 전체 lifecycle 검토 대상 |
+| Adapter | 1차 구현 제외, 전체 lifecycle 검토 대상 |
+
+## 도메인 책임
+
+```text
+agentic-domain-document
+  - Document
+  - TOC Node
+  - Content
+  - Typed Block
+  - Document validation
+  - Document fixture
+  - Document repository/service
+  - Document reader/query
+  - Markdown import
+  - Document migration/schema docs
+  - Document Agent manifest/instruction contribution
+```
+
+## 제외 범위
+
+| 제외 항목 | 담당 후보 |
+| --- | --- |
+| Artifact | `agentic-domain-artifact` |
+| Artifact Standard Package | `agentic-domain-artifact-standard` |
+| Knowledge | `agentic-domain-knowledge` |
+| Methodology | `agentic-domain-methodology` |
+| Render | `agentic-support-render` 후보 |
+| Agent Routing | runtime/router 계열 |
+
+## DB 명명 기준
+
+| 구분 | 기준 |
+| --- | --- |
+| logical schema | `document` |
+| SQLite table prefix | `document_` |
+| PostgreSQL mapping | `document.*`, 단 실제 적용은 향후 별도 프로세스 |
+
+초기 테이블:
+
+```text
+document_code_groups
+document_codes
+document_node_taxonomies
+document_node_taxonomy_levels
+document_documents
+document_nodes
+document_contents
+document_blocks
+document_annotations
+document_revisions
+document_change_events
+document_versions
+```
+
+## 개발 검증
+
+```bash
+npm run build --workspace agentic-domain-document
+npm run typecheck --workspace agentic-domain-document
+npm run dev:test:agentic-domain-document
+npm pack --workspace agentic-domain-document --dry-run --cache /private/tmp/agentic-npm-cache
+```
+
+## 기본 API 예시
+
+```ts
+import { createDocumentService } from "agentic-domain-document";
+
+const service = createDocumentService({
+  databasePath: ".agentic/platform.sqlite"
+});
+
+try {
+  const document = service.createDocument({
+    title: "요구사항 정의서",
+    documentTypeCode: "default",
+    taxonomyCode: "default"
+  });
+
+  const chapter = service.createNode({
+    documentId: document.documentId,
+    nodeLevel: 1,
+    title: "개요"
+  });
+
+  const content = service.ensureContent(chapter.nodeId);
+  service.addBlock({
+    contentId: content.contentId,
+    blockTypeCode: "paragraph",
+    contentText: "문서 본문을 작성합니다."
+  });
+
+  const validation = service.validateDocument(document.documentId);
+  console.log(validation.valid);
+} finally {
+  service.close();
+}
+```
+
+## Adoc 조회 API 예시
+
+Adoc 조회는 직접 SQL보다 `DocumentReader` public API를 우선 사용합니다.
+
+```ts
+import { createDocumentReader } from "agentic-domain-document";
+
+const reader = createDocumentReader({
+  databasePath: ".agentic/platform.sqlite"
+});
+
+try {
+  const latest = reader.getLatestDocument({
+    documentTypeCode: "architecture_specification"
+  });
+
+  if (latest !== undefined) {
+    const tree = reader.getDocumentTree(latest.documentId);
+    const blocks = reader.findBlocks(latest.documentId, {
+      contains: "Contract API"
+    });
+    const markdown = reader.toMarkdown(latest.documentId);
+
+    console.log(tree.length);
+    console.log(blocks.length);
+    console.log(markdown);
+  }
+} finally {
+  reader.close();
+}
+```
+
+`toMarkdown()`은 본격 렌더링 엔진이 아니라 Adoc을 사람이 읽기 쉽게 보여주기 위한 기본 Markdown Projection입니다. Projection은 조회용 파생물이며 원천이 아닙니다. Markdown 파일 저장, checksum, stale 검증, PDF/PPTX/HTML 렌더링은 후속 `agentic-capability-render` 책임입니다.
+
+기본 Markdown Projection은 `paragraph`, `quote`, `list`, `code`, `table`, `figure`, `diagram` block을 Markdown으로 복원합니다. `table`은 `columns`와 `rows`를 Markdown table로 출력하고, `figure`는 image reference와 visible caption으로 출력하며, `diagram`은 mermaid/plantuml source block을 fenced code block으로 출력합니다.
+
+## Adoc Markdown Import 예시
+
+Adoc 작성의 1차 import 대상은 Markdown입니다. 전체 문서 생성과 기존 문서에 대한 챕터 append를 지원합니다.
+
+```ts
+import { createDocumentMarkdownImporter } from "agentic-domain-document";
+
+const importer = createDocumentMarkdownImporter({
+  databasePath: ".agentic/platform.sqlite"
+});
+
+try {
+  const document = importer.importMarkdownDocument({
+    title: "아키텍처 명세서",
+    documentTypeCode: "architecture_specification",
+    taxonomyCode: "architecture_specification",
+    markdown,
+    sourcePath: "chapters/chapter-01.md",
+    policy: {
+      validateAfterImport: true
+    }
+  });
+
+  importer.importMarkdownChapter({
+    documentId: document.document.documentId,
+    markdown: chapterMarkdown,
+    sourcePath: "chapters/chapter-02.md",
+    policy: {
+      validateAfterImport: true
+    }
+  });
+} finally {
+  importer.close();
+}
+```
+
+Markdown Import는 draft Adoc 생성과 챕터 append를 위한 작성 진입점입니다. PDF/PPTX/HTML import, BlockFlow YAML import, merge/reconcile은 1차 범위에서 제외합니다.
+
+Markdown Import는 다음 기본 구조화를 수행합니다.
+
+```text
+- Markdown heading -> Document Node
+- paragraph, quote, list, code -> Typed Block
+- Markdown table -> table block
+- `표 N. 제목 - 요약` + table -> caption이 결합된 table block
+- Markdown image -> figure block
+- image alt와 visible `그림 N. 제목 - 요약` caption -> caption이 결합된 figure block
+- mermaid/plantuml fenced code -> diagram block
+```
+
+## Document Agent Contribution
+
+`agentic-domain-document`는 문서 작성 agent가 사용할 manifest와 resource index를 제공합니다. 이 contribution은 `agentic-capability-agent-client`의 공통 계약을 따르며, runtime/router가 설치된 패키지의 agent 기여분을 일관되게 등록하고 선택할 수 있게 합니다.
+
+Agent manifest, routing, capability, resource index, instruction, guide, example, validation rule, source mapping은 TypeScript inline 문자열이 아니라 package root의 `agent/` 리소스를 원천으로 관리합니다.
+
+```text
+agentic-domain-document/
+  agent/
+    agent.manifest.json
+    routing.json
+    resource-index.json
+    resource-selection.json
+    capabilities/
+      document-authoring.json
+      document-block.json
+      document-toc.json
+      document-validation.json
+    instructions/
+      00-runtime-behavior.md
+      10-scope-and-boundary.md
+      20-task-procedures.md
+      30-must-and-must-not.md
+    guides/
+      10-document-authoring-guide.md
+      20-domain-boundary-guide.md
+      30-authoring-policy-guide.md
+      40-toc-authoring-guide.md
+      50-content-block-guide.md
+      51-paragraph-authoring-guide.md
+      52-table-authoring-guide.md
+      53-diagram-figure-authoring-guide.md
+      70-korean-writing-style-guide.md
+    validation/
+      document-validation-rules.md
+    examples/
+      examples.md
+      document-quality-examples.md
+    sources/
+      reference-mapping.md
+```
+
+```ts
+import { documentAgentContribution } from "agentic-domain-document";
+
+console.log(documentAgentContribution.manifest.agentId);
+console.log(documentAgentContribution.resourceIndex?.instructions[0].path);
+```
+
+resource index는 다음 리소스를 구분해 제공합니다.
+
+| 순서 | 구분 | 내용 |
+| --- | --- |
+| 1 | instructions | Agent가 반드시 따르는 작동 규칙 |
+| 2 | guides | 작성 품질을 높이는 상세 기준 |
+| 3 | examples | 좋은/나쁜 결과 예시와 payload 예시 |
+| 4 | validationRules | 기계적으로 검증할 수 있는 기준 |
+| 5 | sources | 규칙의 출처와 반영 근거 |
+
+`resourceGroups.order`는 위 분류 간 적용 순서를 나타내고, 각 리소스의 `priority`는 같은 분류 안에서의 파일 적용 순서를 나타냅니다.
+
+`resource-selection.json`은 사용자 요청에 따라 위 resource 중 어떤 묶음을 agent context에 포함할지 정의합니다. 예를 들어 “표 컬럼 헤더를 설계해줘” 요청은 공통 instruction, authoring guide, Korean writing guide, content block guide, table guide, quality example, validation rule을 함께 선택합니다.
+
+```ts
+import {
+  assembleDocumentAgentContext,
+  documentAgentContribution,
+  documentResourceSelectionRules,
+  selectDocumentAgentResources
+} from "agentic-domain-document";
+import { selectAgentResources } from "agentic-capability-agent-client";
+
+const bundle = selectAgentResources(documentAgentContribution, {
+  requestText: "표 컬럼 헤더를 설계해줘"
+});
+
+console.log(documentResourceSelectionRules.length);
+console.log(bundle.bundleType);
+console.log(bundle.resourceIds);
+
+const documentBundle = selectDocumentAgentResources("표 컬럼 헤더를 설계해줘");
+const context = assembleDocumentAgentContext("표 컬럼 헤더를 설계해줘");
+
+console.log(documentBundle.bundleType);
+console.log(context.contentText);
+```
+
+Korean writing guide는 문체 요청에만 쓰는 부가 guide가 아니라 문서 작성, 수정, 검토의 baseline guide로 취급합니다. Source mapping은 평상시 작성 context에는 항상 포함하지 않고, 출처 확인이나 규칙 보완 요청에서 선택합니다.
+
+## 문서
+
+| 문서 | 내용 |
+| --- | --- |
+| [docs/usage.md](./docs/usage.md) | 사용 기준 |
+| [docs/configuration.md](./docs/configuration.md) | 설정 책임 |
+| [docs/build.md](./docs/build.md) | 구축 담당자 빌드/검증 |
+| [docs/publishing.md](./docs/publishing.md) | publish 절차 |
+| [docs/delivery.md](./docs/delivery.md) | 운영환경 전달 기준 |
+| [docs/operations.md](./docs/operations.md) | 운영환경 설치/검증 |
+| [docs/schema/migrations.md](./docs/schema/migrations.md) | migration 계획 |
+| [docs/validation-rules.md](./docs/validation-rules.md) | validator rule 설명 |

package/agent/agent.manifest.json

@@ -0,0 +1,8 @@
+{
+  "agentId": "document-agent",
+  "packageName": "agentic-domain-document",
+  "packageVersion": "0.6.0",
+  "moduleLayer": "domain",
+  "displayName": "Document Agent",
+  "description": "Document, TOC, Content, Typed Block 작성과 검증을 지원한다."
+}

package/agent/capabilities/document-authoring.json

@@ -0,0 +1,21 @@
+{
+  "capabilityId": "document.authoring",
+  "description": "문서 목적, 독자, 목차, 본문 흐름을 기준으로 문서 초안과 보완안을 작성한다.",
+  "keywords": [
+    "Adoc",
+    "Agentic Document",
+    "Agentic Doc",
+    "agentic-domain-document",
+    "문서",
+    "본문",
+    "작성",
+    "초안",
+    "보완",
+    "개선"
+  ],
+  "examples": [
+    "Adoc 문서 초안을 작성해줘",
+    "문서 본문을 작성해줘",
+    "문서 내용을 보완해줘"
+  ]
+}

package/agent/capabilities/document-block.json

@@ -0,0 +1,22 @@
+{
+  "capabilityId": "document.block",
+  "description": "Paragraph, Table, Diagram, Figure, List, Code, Callout, Quote 블록을 작성하고 검토한다.",
+  "keywords": [
+    "Adoc",
+    "Document Tree",
+    "Adoc Tree",
+    "블록",
+    "paragraph",
+    "table",
+    "diagram",
+    "figure",
+    "표",
+    "도해",
+    "그림"
+  ],
+  "examples": [
+    "Adoc Tree에서 특정 block을 찾아줘",
+    "표 블록을 작성해줘",
+    "다이어그램 설명을 보완해줘"
+  ]
+}

package/agent/capabilities/document-toc.json

@@ -0,0 +1,21 @@
+{
+  "capabilityId": "document.toc",
+  "description": "Document TOC Node 계층과 목차 표시 기준을 설계하고 검토한다.",
+  "keywords": [
+    "Adoc",
+    "Agentic Document",
+    "Document Tree",
+    "Adoc Tree",
+    "목차",
+    "TOC",
+    "Chapter",
+    "Section",
+    "Subsection",
+    "Heading"
+  ],
+  "examples": [
+    "Adoc Tree를 보여줘",
+    "문서 목차를 설계해줘",
+    "목차 구조를 검토해줘"
+  ]
+}

package/agent/capabilities/document-validation.json

@@ -0,0 +1,21 @@
+{
+  "capabilityId": "document.validation",
+  "description": "문서 구조, 용어, 문체, 표, 도해, 캡션, 원천/생성물 경계를 검증한다.",
+  "keywords": [
+    "Adoc",
+    "Agentic Document",
+    "Markdown Projection",
+    "Adoc Markdown Projection",
+    "검증",
+    "검토",
+    "품질",
+    "캡션",
+    "용어",
+    "표기"
+  ],
+  "examples": [
+    "Adoc Markdown Projection이 원천처럼 수정됐는지 검토해줘",
+    "문서 품질을 검토해줘",
+    "표기 규칙을 검증해줘"
+  ]
+}