@soddong/agentic-domain-methodology 0.11.1

package/dist/validators.js

@@ -0,0 +1,297 @@
+import { createValidationIssue, createValidationResult, mergeValidationResults } from "@soddong/agentic-capability-validation";
+function resolveValidationScope(db, options = {}) {
+    if (options.scope?.methodologyId !== undefined) {
+        return { methodologyId: options.scope.methodologyId };
+    }
+    if (options.scope?.methodologyCode !== undefined || options.scope?.methodologyVersion !== undefined) {
+        if (options.scope.methodologyCode === undefined || options.scope.methodologyVersion === undefined) {
+            throw new Error("methodologyCode and methodologyVersion must be provided together for scoped methodology validation.");
+        }
+        const row = db
+            .prepare(`SELECT methodology_id
+           FROM methodology_methodologies
+          WHERE methodology_code = ?
+            AND methodology_version = ?`)
+            .get(options.scope.methodologyCode, options.scope.methodologyVersion);
+        if (row === undefined) {
+            throw new Error(`Unknown methodology: ${options.scope.methodologyCode}@${options.scope.methodologyVersion}`);
+        }
+        return { methodologyId: row.methodology_id };
+    }
+    return {};
+}
+function scopeWhere(scope, columnName) {
+    return scope.methodologyId === undefined ? "" : ` WHERE ${columnName} = ?`;
+}
+function scopeParams(scope) {
+    return scope.methodologyId === undefined ? [] : [scope.methodologyId];
+}
+function existsById(db, tableName, idColumn, id) {
+    const row = db.prepare(`SELECT 1 AS found FROM ${tableName} WHERE ${idColumn} = ?`).get(id);
+    return row !== undefined;
+}
+function scopeExists(db, scopeCode, refId) {
+    switch (scopeCode) {
+        case "methodology":
+            return existsById(db, "methodology_methodologies", "methodology_id", refId);
+        case "lifecycle":
+            return existsById(db, "methodology_lifecycles", "lifecycle_id", refId);
+        case "phase":
+            return existsById(db, "methodology_phases", "phase_id", refId);
+        case "process":
+            return existsById(db, "methodology_processes", "process_id", refId);
+        case "stage":
+            return existsById(db, "methodology_stages", "stage_id", refId);
+        case "activity":
+            return existsById(db, "methodology_activities", "activity_id", refId);
+        case "artifact_requirement":
+            return existsById(db, "methodology_activity_artifact_requirements", "activity_artifact_requirement_id", refId)
+                || existsById(db, "methodology_stage_artifact_requirements", "stage_artifact_requirement_id", refId);
+        case "artifact_standard":
+            return true;
+        default:
+            return false;
+    }
+}
+function issue(input) {
+    return createValidationIssue({
+        severity: input.severity ?? "error",
+        ruleId: input.ruleId,
+        targetType: input.targetType,
+        targetId: input.targetId,
+        message: input.message,
+        details: input.details
+    });
+}
+export function validateStageActivityAssignments(db, options = {}) {
+    const scope = resolveValidationScope(db, options);
+    const rows = db
+        .prepare(`SELECT sa.stage_activity_id,
+              sa.stage_id,
+              sa.activity_id,
+              s.process_id AS stage_process_id,
+              a.process_id AS activity_process_id,
+              sp.methodology_id AS methodology_id
+         FROM methodology_stage_activities sa
+         JOIN methodology_stages s ON s.stage_id = sa.stage_id
+         JOIN methodology_processes sp ON sp.process_id = s.process_id
+         JOIN methodology_activities a ON a.activity_id = sa.activity_id
+         ${scopeWhere(scope, "sp.methodology_id")}`)
+        .all(...scopeParams(scope));
+    const issues = [];
+    for (const row of rows) {
+        if (row.stage_process_id !== row.activity_process_id) {
+            issues.push(issue({
+                ruleId: "METHODOLOGY.STAGE_ACTIVITY.SAME_PROCESS",
+                targetType: "stage_activity",
+                targetId: row.stage_activity_id,
+                message: "Stage와 Activity는 같은 Process에 속해야 합니다.",
+                details: {
+                    stageId: row.stage_id,
+                    activityId: row.activity_id,
+                    stageProcessId: row.stage_process_id,
+                    activityProcessId: row.activity_process_id
+                }
+            }));
+        }
+    }
+    return createValidationResult(issues);
+}
+export function validateActivityArtifactRequirements(db, options = {}) {
+    const scope = resolveValidationScope(db, options);
+    const rows = db
+        .prepare(`SELECT activity_artifact_requirement_id,
+              r.activity_id,
+              requirement_role_code,
+              is_primary
+         FROM methodology_activity_artifact_requirements r
+         JOIN methodology_activities a ON a.activity_id = r.activity_id
+         JOIN methodology_processes p ON p.process_id = a.process_id
+         ${scopeWhere(scope, "p.methodology_id")}`)
+        .all(...scopeParams(scope));
+    const issues = [];
+    for (const row of rows) {
+        if (row.is_primary === 1 && row.requirement_role_code !== "output") {
+            issues.push(issue({
+                ruleId: "METHODOLOGY.ACTIVITY_ARTIFACT_REQUIREMENT.PRIMARY_OUTPUT_ROLE",
+                targetType: "activity_artifact_requirement",
+                targetId: row.activity_artifact_requirement_id,
+                message: "Primary artifact requirement는 output 역할이어야 합니다.",
+                details: {
+                    activityId: row.activity_id,
+                    requirementRoleCode: row.requirement_role_code
+                }
+            }));
+        }
+    }
+    return createValidationResult(issues);
+}
+function scopeRefBelongsToMethodology(db, methodologyId, scopeCode, refId) {
+    switch (scopeCode) {
+        case "methodology":
+            return refId === methodologyId;
+        case "lifecycle":
+            return db
+                .prepare("SELECT 1 FROM methodology_lifecycles WHERE lifecycle_id = ? AND methodology_id = ?")
+                .get(refId, methodologyId) !== undefined;
+        case "phase":
+            return db
+                .prepare(`SELECT 1
+             FROM methodology_phases ph
+             JOIN methodology_lifecycles l ON l.lifecycle_id = ph.lifecycle_id
+            WHERE ph.phase_id = ?
+              AND l.methodology_id = ?`)
+                .get(refId, methodologyId) !== undefined;
+        case "process":
+            return db
+                .prepare("SELECT 1 FROM methodology_processes WHERE process_id = ? AND methodology_id = ?")
+                .get(refId, methodologyId) !== undefined;
+        case "stage":
+            return db
+                .prepare(`SELECT 1
+             FROM methodology_stages s
+             JOIN methodology_processes p ON p.process_id = s.process_id
+            WHERE s.stage_id = ?
+              AND p.methodology_id = ?`)
+                .get(refId, methodologyId) !== undefined;
+        case "activity":
+            return db
+                .prepare(`SELECT 1
+             FROM methodology_activities a
+             JOIN methodology_processes p ON p.process_id = a.process_id
+            WHERE a.activity_id = ?
+              AND p.methodology_id = ?`)
+                .get(refId, methodologyId) !== undefined;
+        case "artifact_requirement":
+            return db
+                .prepare(`SELECT 1
+             FROM methodology_activity_artifact_requirements r
+             JOIN methodology_activities a ON a.activity_id = r.activity_id
+             JOIN methodology_processes p ON p.process_id = a.process_id
+            WHERE r.activity_artifact_requirement_id = ?
+              AND p.methodology_id = ?`)
+                .get(refId, methodologyId) !== undefined
+                || db
+                    .prepare(`SELECT 1
+               FROM methodology_stage_artifact_requirements r
+               JOIN methodology_stages s ON s.stage_id = r.stage_id
+               JOIN methodology_processes p ON p.process_id = s.process_id
+              WHERE r.stage_artifact_requirement_id = ?
+                AND p.methodology_id = ?`)
+                    .get(refId, methodologyId) !== undefined;
+        case "artifact_standard":
+            return true;
+        default:
+            return false;
+    }
+}
+function rowBelongsToScope(db, scope, ...refs) {
+    if (scope.methodologyId === undefined) {
+        return true;
+    }
+    return refs.some((ref) => scopeRefBelongsToMethodology(db, scope.methodologyId, ref.scopeCode, ref.refId));
+}
+export function validateHandoffRequirementReferences(db, options = {}) {
+    const scope = resolveValidationScope(db, options);
+    const rows = db
+        .prepare(`SELECT handoff_requirement_id,
+              source_scope_code,
+              source_ref_id,
+              target_scope_code,
+              target_ref_id
+         FROM methodology_handoff_requirements`)
+        .all();
+    const issues = [];
+    for (const row of rows) {
+        if (!rowBelongsToScope(db, scope, { scopeCode: row.source_scope_code, refId: row.source_ref_id }, { scopeCode: row.target_scope_code, refId: row.target_ref_id })) {
+            continue;
+        }
+        if (!scopeExists(db, row.source_scope_code, row.source_ref_id)) {
+            issues.push(issue({
+                ruleId: "METHODOLOGY.HANDOFF.SOURCE_EXISTS",
+                targetType: "handoff_requirement",
+                targetId: row.handoff_requirement_id,
+                message: "Handoff source 참조 대상을 찾을 수 없습니다.",
+                details: {
+                    sourceScopeCode: row.source_scope_code,
+                    sourceRefId: row.source_ref_id
+                }
+            }));
+        }
+        if (!scopeExists(db, row.target_scope_code, row.target_ref_id)) {
+            issues.push(issue({
+                ruleId: "METHODOLOGY.HANDOFF.TARGET_EXISTS",
+                targetType: "handoff_requirement",
+                targetId: row.handoff_requirement_id,
+                message: "Handoff target 참조 대상을 찾을 수 없습니다.",
+                details: {
+                    targetScopeCode: row.target_scope_code,
+                    targetRefId: row.target_ref_id
+                }
+            }));
+        }
+    }
+    return createValidationResult(issues);
+}
+export function validateBaselineRequirementReferences(db, options = {}) {
+    const scope = resolveValidationScope(db, options);
+    const rows = db
+        .prepare(`SELECT baseline_requirement_id,
+              baseline_scope_code,
+              baseline_scope_ref_id
+         FROM methodology_baseline_requirements`)
+        .all();
+    const issues = rows
+        .filter((row) => rowBelongsToScope(db, scope, {
+        scopeCode: row.baseline_scope_code,
+        refId: row.baseline_scope_ref_id
+    }))
+        .filter((row) => !scopeExists(db, row.baseline_scope_code, row.baseline_scope_ref_id))
+        .map((row) => issue({
+        ruleId: "METHODOLOGY.BASELINE.SCOPE_EXISTS",
+        targetType: "baseline_requirement",
+        targetId: row.baseline_requirement_id,
+        message: "Baseline scope 참조 대상을 찾을 수 없습니다.",
+        details: {
+            baselineScopeCode: row.baseline_scope_code,
+            baselineScopeRefId: row.baseline_scope_ref_id
+        }
+    }));
+    return createValidationResult(issues);
+}
+export function validateTracePolicyReferences(db, options = {}) {
+    const scope = resolveValidationScope(db, options);
+    const rows = db
+        .prepare(`SELECT trace_policy_id,
+              policy_scope_code,
+              policy_scope_ref_id
+         FROM methodology_trace_policies`)
+        .all();
+    const issues = rows
+        .filter((row) => rowBelongsToScope(db, scope, {
+        scopeCode: row.policy_scope_code,
+        refId: row.policy_scope_ref_id
+    }))
+        .filter((row) => !scopeExists(db, row.policy_scope_code, row.policy_scope_ref_id))
+        .map((row) => issue({
+        ruleId: "METHODOLOGY.TRACE_POLICY.POLICY_SCOPE_EXISTS",
+        targetType: "trace_policy",
+        targetId: row.trace_policy_id,
+        message: "Trace policy scope 참조 대상을 찾을 수 없습니다.",
+        details: {
+            policyScopeCode: row.policy_scope_code,
+            policyScopeRefId: row.policy_scope_ref_id
+        }
+    }));
+    return createValidationResult(issues);
+}
+export function validateMethodologyDefinition(db, options = {}) {
+    return mergeValidationResults([
+        validateStageActivityAssignments(db, options),
+        validateActivityArtifactRequirements(db, options),
+        validateHandoffRequirementReferences(db, options),
+        validateBaselineRequirementReferences(db, options),
+        validateTracePolicyReferences(db, options)
+    ]);
+}
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"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"}

package/docs/build.md

@@ -0,0 +1,47 @@
+# @soddong/agentic-domain-methodology 개발 및 빌드 매뉴얼
+
+## 1. 목적
+
+본 문서는 구축 담당자가 `@soddong/agentic-domain-methodology` 패키지를 개발, 빌드, 로컬 검증하기 위해 알아야 하는 내용을 정리합니다.
+
+## 2. 패키지 정보
+
+| 항목 | 값 |
+| --- | --- |
+| package | `@soddong/agentic-domain-methodology` |
+| current version | `0.11.1` |
+| workspace | `packages/agentic-domain-methodology` |
+| CLI | 1차 제공하지 않음 |
+
+## 3. 개발 검증
+
+repository root에서 실행합니다.
+
+```bash
+npm run build --workspace @soddong/agentic-domain-methodology
+npm run typecheck --workspace @soddong/agentic-domain-methodology
+npm run dev:test:agentic-domain-methodology
+```
+
+## 4. 패키징 Dry Run
+
+```bash
+npm pack --workspace @soddong/agentic-domain-methodology --dry-run --cache /private/tmp/agentic-npm-cache
+```
+
+확인 항목:
+
+```text
+- README.md 포함
+- CHANGELOG.md 포함
+- docs/ 포함
+- dist/index.js 포함
+- package.json 포함
+- 불필요한 source/test/local file 미포함
+```
+
+## 5. 다음 절차
+
+publish 절차는 [publishing.md](./publishing.md)를 따릅니다.
+
+운영환경 전달 기준은 [delivery.md](./delivery.md)를 따릅니다.

package/docs/configuration.md

@@ -0,0 +1,33 @@
+# @soddong/agentic-domain-methodology 설정 매뉴얼
+
+## 1. 목적
+
+본 문서는 `@soddong/agentic-domain-methodology`의 설정 책임을 정의합니다.
+
+## 2. 현재 설정
+
+Iteration 0에서는 별도 runtime 설정을 요구하지 않습니다.
+
+```text
+package
+  - package metadata
+  - 최소 public API
+
+consumer project
+  - 실제 runtime 설정
+  - registry 설정
+  - 향후 DB 경로 및 seed 적용 설정
+```
+
+## 3. 향후 설정 후보
+
+후속 iteration에서 다음 설정이 추가될 수 있습니다.
+
+| 설정 후보 | 설명 |
+| --- | --- |
+| database path | methodology SQLite schema 적용 대상 |
+| seed profile | 기본 방법론 seed 또는 SDLC seed 선택 |
+| artifact standard binding | Artifact Standard code/version 식별자 연결 |
+| validation profile | gate, handoff, artifact requirement 검증 수준 |
+
+환경별 실제 값은 패키지 내부에 고정하지 않고 consumer 프로젝트에서 제공합니다.

package/docs/delivery.md

@@ -0,0 +1,52 @@
+# @soddong/agentic-domain-methodology Delivery 매뉴얼
+
+## 1. 목적
+
+본 문서는 `@soddong/agentic-domain-methodology` 패키지를 구축 환경에서 운영환경으로 전달할 때 필요한 package-specific delivery 기준을 정의합니다.
+
+publish 절차 자체는 [publishing.md](./publishing.md)를 따릅니다. 운영환경 설치와 검증은 [operations.md](./operations.md)를 따릅니다.
+
+## 2. Delivery 범위
+
+| 구분 | 포함 여부 | 설명 |
+| --- | --- | --- |
+| npm package publish | 포함 | 공식 npm registry에 배포 |
+| 운영환경 install 검증 | 포함 | 공식 npm registry 기준 설치 확인 |
+| source repository 전체 전달 | 제외 | npm package 기준 전달 |
+| 인증 정보 전달 | 제외 | 환경별 `.npmrc` 또는 보안 정책으로 관리 |
+| registry URL 하드코딩 | 제외 | 환경 설정으로 제공 |
+
+## 3. Package에 포함되는 파일
+
+`@soddong/agentic-domain-methodology` 배포 패키지는 다음 파일을 포함해야 합니다.
+
+```text
+package/
+  package.json
+  README.md
+  CHANGELOG.md
+  dist/
+    index.js
+    *.d.ts
+  docs/
+    usage.md
+    configuration.md
+    build.md
+    publishing.md
+    delivery.md
+    operations.md
+```
+
+## 4. 운영환경 전달 기준
+
+운영환경에는 다음 정보만 전달하면 됩니다.
+
+```text
+- package name: @soddong/agentic-domain-methodology
+- install version: 0.11.1
+- 공식 npm registry 설정 방법
+- 설치 및 import 확인 절차
+- 문제 발생 시 확인 항목
+```
+
+운영환경 사용자는 구축 환경의 publish registry, build cache, tarball 생성 절차를 알 필요가 없습니다.

package/docs/operations.md

@@ -0,0 +1,55 @@
+# @soddong/agentic-domain-methodology 운영환경 매뉴얼
+
+## 1. 목적
+
+본 문서는 운영환경 담당자 또는 사용자가 `@soddong/agentic-domain-methodology`를 설치하고 기본 상태를 확인하는 절차를 정의합니다.
+
+## 2. 운영환경 전제
+
+| 항목 | 기준 |
+| --- | --- |
+| 네트워크 | 공식 npm registry 접근 가능 |
+| NPM Registry | `https://registry.npmjs.org/` |
+| package | `@soddong/agentic-domain-methodology` |
+
+## 3. Registry 확인
+
+```bash
+npm config get registry
+```
+
+기대 결과:
+
+```text
+https://registry.npmjs.org/
+```
+
+## 4. 설치
+
+```bash
+npm install @soddong/agentic-domain-methodology@0.11.1
+```
+
+## 5. 실행 확인
+
+```bash
+node -e "import('@soddong/agentic-domain-methodology').then(m => console.log(m.getMethodologyPackageInfo()))"
+```
+
+기대 결과:
+
+```text
+name: @soddong/agentic-domain-methodology
+logicalSchema: methodology
+sqliteTablePrefix: methodology_
+```
+
+## 6. 장애 확인
+
+| 증상 | 확인 |
+| --- | --- |
+| package not found | 공식 npm registry publish 여부 확인 |
+| authentication required | 사용자 홈 `.npmrc` 인증 정보 확인 |
+| 사설 registry 접근 시도 | `npm config get registry` 결과 확인 |
+| import 실패 | `node_modules/agentic-domain-methodology/package.json` 존재 여부 확인 |
+| 버전 불일치 | `npm view @soddong/agentic-domain-methodology version --registry=https://registry.npmjs.org/ --prefer-online` 결과 확인 |

package/docs/publishing.md

@@ -0,0 +1,84 @@
+# @soddong/agentic-domain-methodology Publishing 매뉴얼
+
+## 1. 목적
+
+본 문서는 `@soddong/agentic-domain-methodology` 패키지를 NPM Registry에 publish하는 절차를 정의합니다.
+
+## 2. 전제
+
+| 항목 | 기준 |
+| --- | --- |
+| package | `@soddong/agentic-domain-methodology` |
+| current version | `0.11.1` |
+| workspace | `packages/agentic-domain-methodology` |
+| publish registry | 구축 환경에서 제공 |
+| install registry | 운영환경 또는 검증 환경에서 제공 |
+
+## 3. Publish 전 검증
+
+repository root에서 실행합니다.
+
+```bash
+npm run build --workspace @soddong/agentic-domain-methodology
+npm run typecheck --workspace @soddong/agentic-domain-methodology
+npm run dev:test:agentic-domain-methodology
+npm pack --workspace @soddong/agentic-domain-methodology --dry-run --cache /private/tmp/agentic-npm-cache
+```
+
+## 4. Tarball 생성
+
+```bash
+npm pack --workspace @soddong/agentic-domain-methodology --cache /private/tmp/agentic-npm-cache
+```
+
+생성 예:
+
+```text
+agentic-domain-methodology-0.11.1.tgz
+```
+
+## 5. Publish
+
+`package.json`에는 registry URL을 고정하지 않습니다.
+
+```bash
+npm publish --workspace @soddong/agentic-domain-methodology --registry="${NPM_PUBLISH_REGISTRY_URL}"
+```
+
+Windows PowerShell:
+
+```powershell
+npm publish --workspace @soddong/agentic-domain-methodology --registry="$env:NPM_PUBLISH_REGISTRY_URL"
+```
+
+## 6. Publish 검증
+
+```bash
+npm view @soddong/agentic-domain-methodology version --registry="${NPM_INSTALL_REGISTRY_URL}"
+```
+
+기대 결과:
+
+```text
+0.11.1
+```
+
+## 7. 사용자 프로젝트 설치 검증
+
+```bash
+TEST_DIR=/private/tmp/agentic-domain-methodology-consumer-test
+rm -rf "$TEST_DIR"
+mkdir -p "$TEST_DIR"
+cd "$TEST_DIR"
+npm init -y
+npm install @soddong/agentic-domain-methodology@0.11.1 --registry="${NPM_INSTALL_REGISTRY_URL}" --prefer-online
+node -e "import('@soddong/agentic-domain-methodology').then(m => console.log(m.getMethodologyPackageInfo().logicalSchema))"
+```
+
+기대 결과:
+
+```text
+methodology
+```
+
+registry가 불안정하거나 공식 registry가 미확정이면 tarball 기반 consumer 검증을 publish 대체 검증으로 수행합니다.

package/docs/schema/generated/README.md

@@ -0,0 +1,39 @@
+# agentic-domain-methodology
+
+## Description
+
+Agentic Platform methodology domain database.
+
+## Tables
+
+| Name                                                                                        | Columns | Comment                                                                       | Type  |
+| ------------------------------------------------------------------------------------------- | ------- | ----------------------------------------------------------------------------- | ----- |
+| [methodology_schema_migrations](methodology_schema_migrations.md)                           | 3       | methodology 패키지의 migration 적용 이력을 관리한다.                                       | table |
+| [methodology_code_groups](methodology_code_groups.md)                                       | 7       | 코드 그룹을 정의한다.                                                                  | table |
+| [methodology_codes](methodology_codes.md)                                                   | 9       | 코드 그룹별 코드 값을 정의한다.                                                            | table |
+| [methodology_methodologies](methodology_methodologies.md)                                   | 10      | 방법론 정의의 최상위 versioned definition을 관리한다.                                       | table |
+| [methodology_common_blueprint_policies](methodology_common_blueprint_policies.md)           | 11      |                                                                               | table |
+| [methodology_common_blueprint_policy_nodes](methodology_common_blueprint_policy_nodes.md)   | 12      |                                                                               | table |
+| [methodology_lifecycles](methodology_lifecycles.md)                                         | 11      | 방법론 생명주기 모델을 관리한다.                                                            | table |
+| [methodology_phases](methodology_phases.md)                                                 | 11      | lifecycle 내 큰 구간을 관리한다.                                                       | table |
+| [methodology_processes](methodology_processes.md)                                           | 10      | 재사용 가능한 수행 절차를 관리한다.                                                          | table |
+| [methodology_phase_processes](methodology_phase_processes.md)                               | 9       | phase에서 어떤 process를 어떤 순서로 사용할지 관리한다.                                         | table |
+| [methodology_activities](methodology_activities.md)                                         | 14      | process 내부의 기본 수행 활동을 관리한다.                                                   | table |
+| [methodology_steps](methodology_steps.md)                                                   | 11      | activity 하위 순차 절차를 관리한다.                                                      | table |
+| [methodology_stages](methodology_stages.md)                                                 | 13      | process 내부 activity grouping, gate, 기준선, 전환 구간을 관리한다.                         | table |
+| [methodology_stage_activities](methodology_stage_activities.md)                             | 9       | stage와 activity의 포함 관계를 관리한다.                                                 | table |
+| [methodology_activity_artifact_requirements](methodology_activity_artifact_requirements.md) | 15      | activity의 input/output/supporting 산출물 요구를 관리한다.                               | table |
+| [methodology_stage_artifact_requirements](methodology_stage_artifact_requirements.md)       | 11      | stage gate, baseline, handoff, approval에 필요한 추가 산출물 요구를 관리한다.                 | table |
+| [methodology_stage_criteria](methodology_stage_criteria.md)                                 | 12      | stage의 entry, exit, gate 판단 기준을 관리한다.                                         | table |
+| [methodology_activity_criteria](methodology_activity_criteria.md)                           | 12      | activity의 completion 판단 기준을 관리한다.                                             | table |
+| [methodology_handoff_requirements](methodology_handoff_requirements.md)                     | 16      | phase, process, stage, activity 간 전달 요구를 관리한다.                                | table |
+| [methodology_baseline_requirements](methodology_baseline_requirements.md)                   | 12      | baseline이 필요한 scope와 trigger를 관리한다.                                           | table |
+| [methodology_trace_policies](methodology_trace_policies.md)                                 | 15      | 실제 trace link가 아니라 trace 필요 관계 정책을 관리한다.                                      | table |
+
+## Relations
+
+![er](schema.svg)
+
+---
+
+> Generated by [tbls](https://github.com/k1LoW/tbls)