modify agent and skill

2026-06-08 01:43:17 +09:00
parent 92a5cb19c0
commit 0c151cae56
12 changed files with 60 additions and 52 deletions
@@ -6,7 +6,7 @@
 이번 구성안은 ALL-FEM 논문의 구조를 확장하거나 재사용하는 계획이 아니다. 논문은 Agent 설계를 위한 참고 자료로만 사용하며, 본 프로젝트는 C++/MSVC 기반 독립 솔버 개발 워크플로우를 따른다.

 ## 설계 원칙
- 기능 요구조건, 이론 정식화, 코드 구현, 검증, 배포 역할을 분리한다.
+- 새로운 솔버 기능 요구조건 분석, 이론 정식화, 코드 구현, 검증, 배포 역할을 분리한다.
 - 실행 가능성만으로 성공을 판단하지 않고, 레퍼런스 결과와 물리량을 비교해 기능 완료를 판정한다.
 - 테스트는 구현 전에 준비한다. 개발 대상 솔버 테스트와 레퍼런스 솔버 결과 비교 테스트를 함께 사용한다.
 - Abaqus나 Nastran을 Agent가 직접 실행하지 않는다. `references/`에 저장된 입력 파일과 레퍼런스 CSV 결과를 검증 기준으로 사용한다.
@@ -21,7 +21,7 @@
 책임:
 - 기능 개발 요청을 단계별 작업으로 분해한다.
 - 각 Agent의 산출물을 연결하고 누락된 결정을 추적한다.
- 요구조건, 정식화, 테스트, 구현, 검증, 배포 단계의 진행 상태를 관리한다.
+- 요구조건 분석, 정식화, 테스트, 구현, 검증, 배포 단계의 진행 상태를 관리한다.
 - 실패 시 어떤 Agent로 되돌릴지 결정한다.

 주요 산출물:
@@ -30,10 +30,10 @@
 - 실패 원인과 재작업 지시

 ### Requirement Agent
-솔버 기능 요구조건을 정의하는 Agent이다.
+새로운 솔버 기능 요구조건을 분석하는 Agent이다.

 책임:
- 해석 기능의 범위, 입력, 출력, 제약조건을 정의한다.
+- 해석 기능의 범위, 입력, 출력, 제약조건을 분석하고 명시한다.
 - 대상 요소, 재료 모델, 경계조건, 하중 조건, 해석 타입을 명확히 한다.
 - 검증해야 할 물리량과 tolerance 기준을 정한다.

@@ -240,7 +240,7 @@ python scripts/validate_workspace.py

 | 개발 과정 | 담당 Agent | 필수 산출물 |
 | --- | --- | --- |
-| 1. 솔버 기능 요구조건 정의 | Requirement Agent | 요구조건, acceptance criteria |
+| 1. 새로운 솔버 기능 요구조건 분석 | Requirement Agent | 요구조건 분석, acceptance criteria |
 | 2. 연구자료 조사 | Research Agent | 자료 요약, benchmark 후보 |
 | 3. 유한요소 정식화 | Formulation Agent, Numerical Review Agent | 정식화 문서, 리뷰 결과 |
 | 4. 입출력 데이터 정의 | I/O Definition Agent | 입력/출력 schema |
@@ -278,7 +278,7 @@ flowchart TD

 ## 검증 Gate

-### Gate 1: 요구조건 승인
+### Gate 1: 요구조건 분석 승인
 통과 조건:
 - 대상 기능과 제외 범위가 명확하다.
 - 입력, 출력, tolerance, 검증 물리량이 정의되어 있다.
@@ -5,7 +5,7 @@ FESA will implement an initial finite element structural solver feature named `m

 The implementation must follow the full solver development workflow:

-1. Define solver feature requirements.
+1. Analyze new solver feature requirements.
 2. Research books, papers, manuals, and related solver implementations.
 3. Write the finite element formulation required for code implementation.
 4. Define solver input and output data contracts.
@@ -56,10 +56,10 @@ Primary conceptual modules:
 - `ResultWriter`: HDF5 output.
 - `ReferenceComparator`: HDF5 reference comparison.

-## Step 1: Requirements Baseline
+## Step 1: New Solver Feature Requirements Analysis
 Create `docs/requirements/mitc4-linear-static-shell.md`.

-The requirement document must define:
+The requirements analysis document must define:
 - analysis type: linear static
 - element type: MITC4 shell
 - DOF order: `U1, U2, U3, UR1, UR2, UR3`
@@ -21,7 +21,7 @@ Agent는 역할과 책임 단위이고, skill은 여러 Agent가 반복적으로

 | Skill | 적용 개발 과정 | 주요 사용자 Agent | 대표 산출물 |
 | --- | --- | --- | --- |
-| `fesa-requirements-baseline` | 1. 솔버 기능 요구조건 정의 | Requirement Agent, Coordinator Agent | `docs/requirements/<feature-id>.md` |
+| `fesa-requirements-baseline` | 1. 새로운 솔버 기능 요구조건 분석 | Requirement Agent, Coordinator Agent | `docs/requirements/<feature-id>.md` |
 | `fesa-research-evidence` | 2. 책, 논문 등 연구자료 조사 | Research Agent, Formulation Agent | `docs/research/<feature-id>-research.md` |
 | `fesa-formulation-spec` | 3. 코드 구현을 위한 유한요소 정식화 | Formulation Agent, Implementation Planning Agent | `docs/formulations/<feature-id>-formulation.md` |
 | `fesa-numerical-review` | 3. 정식화 독립 수치 검토 | Numerical Review Agent, Coordinator Agent | `docs/numerical-reviews/<feature-id>-review.md` |
@@ -36,7 +36,7 @@ Agent는 역할과 책임 단위이고, skill은 여러 Agent가 반복적으로

 예시 기능: `linear-truss-1d`

-1. Requirement Agent는 `fesa-requirements-baseline`을 사용해 기능 범위, 제외 범위, 입력, 출력, 검증 물리량, tolerance, `Requirement Verification Matrix`를 작성한다.
+1. Requirement Agent는 `fesa-requirements-baseline`을 사용해 새로운 솔버 기능의 범위, 제외 범위, 입력, 출력, 검증 물리량, tolerance, `Requirement Verification Matrix`를 분석하고 작성한다.
 2. Research Agent는 `fesa-research-evidence`를 사용해 truss/bar element 이론, benchmark 후보, source reliability, applicability limits를 정리한다.
 3. Formulation Agent는 `fesa-formulation-spec`을 사용해 strong form, weak form, shape functions, B matrix, element stiffness, output recovery를 정리한다.
 4. Numerical Review Agent는 `fesa-numerical-review`를 사용해 rigid body modes, patch test, stiffness symmetry, Jacobian, locking 위험을 검토하고 `pass-for-implementation-planning` 여부를 판단한다.
@@ -51,7 +51,7 @@ Agent는 역할과 책임 단위이고, skill은 여러 Agent가 반복적으로

 ### `fesa-requirements-baseline`

- 기능 요청을 검증 가능한 요구조건 baseline으로 만든다.
+- 새로운 솔버 기능 요청을 검증 가능한 요구조건 분석 baseline으로 만든다.
 - `shall` 문장과 `FESA-REQ-<FEATURE>-###` id를 사용한다.
 - 모든 `must` 요구조건은 verification method와 acceptance criteria를 가져야 한다.
 - FEM 정식화, C++ 구현, reference CSV 생성, release readiness 판단은 하지 않는다.