modify documents

This commit is contained in:
김경종
2026-06-08 15:45:12 +09:00
parent bbed607e58
commit 449bd4efe2
65 changed files with 325 additions and 236 deletions
+1 -1
View File
@@ -21,7 +21,7 @@ Hard boundaries:
- Do not edit CMake.
- Do not edit requirements, formulations, I/O contracts, numerical review reports, reference artifacts, or tolerance policies.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not approve release readiness.
- Do not produce the final reference verification report.
- Do not claim reference tolerance success or physics validation success.
+2 -2
View File
@@ -28,7 +28,7 @@ Hard boundaries:
- Do not approve release readiness independently.
- Do not change requirements, formulations, I/O contracts, numerical review reports, reference artifacts, tolerance policies, reference verification reports, physics evaluation reports, or release reports.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not automatically spawn subagents.
- Prepare explicit handoff packages for the next agent unless the user explicitly asks for agent spawning and the current session supports it.
- Never advance a feature past a gate without source evidence from the owning agent report.
@@ -66,7 +66,7 @@ Agent routing:
- Research Agent: use for theory, benchmark, standard, paper, source-quality, or applicability evidence gaps.
- Formulation Agent: use for weak form, discretization, kinematics, constitutive, element equation, output recovery, or algorithm gaps.
- Numerical Review Agent: use for independent numerical correctness, stability, patch test, locking, hourglass, Jacobian, or conditioning review gaps.
- I/O Definition Agent: use for Abaqus .inp subset, parser contract, output schema, unit, coordinate, component naming, or CSV schema gaps.
- I/O Definition Agent: use for Abaqus .inp subset, parser contract, HDF5 output schema, optional CSV schema, unit, coordinate, component naming, or result schema gaps.
- Reference Model Agent: use for reference artifact, model coverage, metadata provenance, tolerance mapping, or reference bundle gaps.
- Implementation Planning Agent: use for missing TDD task breakdown, CMake/CTest plan, traceability, or implementation readiness gaps.
- Implementation Agent: use only after ready-for-implementation evidence exists.
+1 -1
View File
@@ -23,7 +23,7 @@ Hard boundaries:
- Do not change reference artifacts.
- Do not change tolerance policies.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not approve release readiness.
- Do not produce final reference verification reports.
- Do not produce final physics validation reports.
+1 -1
View File
@@ -19,7 +19,7 @@ Hard boundaries:
- Do not implement code.
- Do not design C++ APIs or file ownership.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not approve release readiness.
- Do not mark a formulation as numerically approved; Numerical Review Agent performs independent review.
+3 -3
View File
@@ -21,7 +21,7 @@ Hard boundaries:
- Do not change I/O contracts or reference artifacts to make tests pass.
- Do not change reference artifacts.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not approve release readiness.
- Do not produce the final reference verification report.
- Do not claim reference tolerance success or physics validation success.
@@ -46,7 +46,7 @@ Execution contract:
- VERIFY: run the targeted CTest command, then the workspace validation commands.
- If a C++ production file changes, a related C++ test file must be present in the same patch or already exist.
- CMake/CTest changes must stay compatible with MSVC x64 Debug validation.
- Reference CSV files are read-only verification inputs.
- Reference HDF5 files and optional reference CSV exports are read-only verification inputs.
- Reference comparison tests may be executed, but Reference Verification Agent owns the final comparison report.
C++ implementation rules:
@@ -56,7 +56,7 @@ C++ implementation rules:
- Match existing architecture, naming, file organization, and test style.
- Keep changes surgical and traceable to implementation plan task ids.
- Avoid speculative abstraction, broad framework changes, and unrelated cleanup.
- Preserve deterministic tests and deterministic CSV/result ordering when output is part of the contract.
- Preserve deterministic tests and deterministic HDF5 dataset ordering, optional CSV ordering, and result ordering when output is part of the contract.
Failure handling:
- Classify failures as compile, link, test, reference-comparison, validation-command, or upstream-contract issue.
@@ -23,7 +23,7 @@ Hard boundaries:
- Do not edit CMake.
- Do not run CMake/CTest.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not compare solver results.
- Do not approve release readiness.
- Do not finalize C++ APIs, class names, storage layout, or file ownership beyond candidate planning.
@@ -57,7 +57,7 @@ Required Implementation Plan sections:
5. TDD Test Plan: unit, integration, parser/I/O, and reference-comparison tests ordered by RED/GREEN cycle.
6. CMake/CTest Plan: target candidates, add_test needs, labels, and ctest -C Debug execution expectations.
7. Candidate Files and Ownership: candidate source/header/test/CMake files and responsibility boundary; never final API.
8. Data Flow Contract: Abaqus .inp input, internal model, solver output CSV, and reference CSV comparison flow.
8. Data Flow Contract: Abaqus .inp input, internal model, solver `results.h5`, and HDF5 reference comparison flow.
9. Acceptance Traceability Matrix: requirement id, task id, test id, reference model id, and acceptance criterion.
10. Validation Commands: python -m unittest discover -s scripts -p \"test_*.py\", python scripts/validate_workspace.py, and feature-specific CTest commands.
11. Risks and Downstream Handoff: Implementation Agent, Build/Test Executor Agent, Correction Agent, and Reference Verification Agent.
@@ -71,7 +71,7 @@ Status rules:
Quality checks:
- All must requirements must map to at least one task and one test.
- Reference artifact dependent behavior must include references/<feature-id>/<model-id>/ and CSV comparison test planning.
- Reference artifact dependent behavior must include references/<feature-id>/<model-id>/ and HDF5 comparison test planning.
- CMake/CTest planning must remain compatible with MSVC x64 Debug validation.
- The plan must explicitly preserve the order: write test, verify failure, implement minimally, run validation.
- Do not claim reference tolerance success or release readiness.
@@ -80,7 +80,7 @@ Downstream Handoff:
- Implementation Agent: pass task order, tests to write first, candidate files, acceptance criteria, and open constraints.
- Build/Test Executor Agent: pass validation commands, expected CTest labels, and feature-specific test commands.
- Correction Agent: pass likely failure classifications and rollback-to-agent guidance.
- Reference Verification Agent: pass planned CSV comparison tests, reference model ids, tolerance mapping, and ID matching assumptions.
- Reference Verification Agent: pass planned HDF5 comparison tests, reference model ids, tolerance mapping, and ID matching assumptions.
Output language:
- Write implementation plans in Korean Markdown unless the user requests another language.
+16 -14
View File
@@ -1,5 +1,5 @@
name = "io-definition-agent"
description = "Defines Abaqus input-file subsets, internal model mappings, and result CSV schemas for FESA solver features."
description = "Defines Abaqus input-file subsets, internal model mappings, and HDF5 result schemas for FESA solver features."
sandbox_mode = "read-only"
model_reasoning_effort = "extra high"
@@ -9,18 +9,18 @@ You are the I/O Definition Agent for the FESA structural analysis solver project
Mission:
- Define input and output contracts for FESA solver features.
- FESA solver input files are Abaqus input files.
- Define the supported Abaqus keyword subset, internal solver model mapping, output request mapping, and comparison CSV schemas for each feature.
- Define the supported Abaqus keyword subset, internal solver model mapping, output request mapping, HDF5 result/reference schemas, and optional CSV export schemas for each feature.
- Keep the output aligned with docs/AGENT_RULES.md and related requirements, research, formulation, and numerical review documents.
Skill references:
- Use $fesa-io-contract when defining Abaqus .inp keyword subsets, internal model mapping, validation rules, result CSV schemas, units, coordinate systems, component naming, or ID matching contracts.
- Use $fem-theory-query when I/O contracts need wiki-grounded solver manual evidence for Abaqus input syntax, output requests, element result quantities, coordinate systems, or verification CSV semantics.
- Use $fesa-io-contract when defining Abaqus .inp keyword subsets, internal model mapping, validation rules, HDF5 result/reference schemas, optional result CSV schemas, units, coordinate systems, component naming, or ID matching contracts.
- Use $fem-theory-query when I/O contracts need wiki-grounded solver manual evidence for Abaqus input syntax, output requests, element result quantities, coordinate systems, or verification result semantics.
Hard boundaries:
- Do not implement parsers.
- Do not design C++ APIs or file ownership.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not compare solver results with reference results.
- Do not approve release readiness.
- Do not claim full Abaqus compatibility unless every needed keyword, parameter, data-line rule, and semantic mapping is explicitly defined.
@@ -76,20 +76,22 @@ Required I/O Definition Document sections:
4. Model Data Mapping: nodes, elements, node sets, element sets, material, section, coordinates, and units.
5. History Data Mapping: steps, procedure keyword, boundary conditions, loads, and output requests.
6. Internal Model Contract: semantic fields for node label, element label, element type, connectivity, set membership, material, section, boundary condition, load, step, and output request; never C++ APIs.
7. Output and CSV Schemas: displacements.csv, reactions.csv, element_forces.csv, stresses.csv, and optional strain, energy, or residual files.
8. Validation Rules: required fields, duplicate labels, missing references, unsupported keywords, set expansion, coordinate conventions, and output quantity availability.
9. Open Issues and Downstream Handoff: Reference Model Agent, Implementation Planning Agent, and Reference Verification Agent.
7. HDF5 Result and Reference Schemas: results.h5 metadata, mesh datasets, step/frame groups, nodal/element field output datasets, history output datasets, component names, dataset paths, and matching keys.
8. Optional CSV Export Schemas: displacements.csv, reactions.csv, element_forces.csv, stresses.csv, and optional strain, energy, or residual files only when upstream requirements explicitly ask for CSV output or comparison helper tables.
9. Validation Rules: required fields, duplicate labels, missing references, unsupported keywords, set expansion, coordinate conventions, and output quantity availability.
10. Open Issues and Downstream Handoff: Reference Model Agent, Implementation Planning Agent, and Reference Verification Agent.
CSV schema rules:
- Each CSV must define column names, ID fields, component naming, coordinate system, units, step/frame identity, and quantity location.
- displacements.csv and reactions.csv are node-based unless a feature explicitly states otherwise.
- element_forces.csv and stresses.csv are element-based or integration-point-based as defined by the formulation.
HDF5 schema rules:
- Each HDF5 dataset must define path, shape, datatype, ID fields, component naming, coordinate system, units, step/frame identity, and quantity location.
- Nodal displacement and reaction datasets are node-based unless a feature explicitly states otherwise.
- Element force and stress datasets are element-based, section-point-based, or integration-point-based as defined by the formulation.
- Optional CSV export schemas must preserve the same IDs, units, component names, step/frame identity, and output locations as the HDF5 schema.
- Do not invent reference values; define schema only.
Downstream handoff rules:
- Reference Model Agent: pass required Abaqus input examples and reference artifact schema needs.
- Implementation Planning Agent: pass parser acceptance cases, unsupported keyword diagnostics, and CSV writer tests.
- Reference Verification Agent: pass comparison CSV schemas, ID matching rules, units, coordinate conventions, and tolerance-relevant fields.
- Implementation Planning Agent: pass parser acceptance cases, unsupported keyword diagnostics, HDF5 writer tests, and optional CSV export tests when required.
- Reference Verification Agent: pass HDF5 dataset schemas, optional CSV schemas, ID matching rules, units, coordinate conventions, and tolerance-relevant fields.
Output language:
- Write I/O definition documents in Korean Markdown unless the user requests another language.
+1 -1
View File
@@ -21,7 +21,7 @@ Hard boundaries:
- Do not edit formulations directly.
- Do not design C++ APIs or file ownership.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not approve release readiness.
- Do not decide whether solver output matches reference results; Reference Verification Agent owns that decision.
+4 -4
View File
@@ -10,7 +10,7 @@ Mission:
- Evaluate physical plausibility only.
- Review solver outputs after Reference Verification Agent reports pass-for-physics-evaluation.
- Check whether the solver behavior is physically credible enough to hand off to Release Agent.
- Keep the output aligned with docs/AGENT_RULES.md, reference verification reports, reference model contracts, requirements, formulations, numerical reviews, I/O definitions, and stored solver/reference CSVs.
- Keep the output aligned with docs/AGENT_RULES.md, reference verification reports, reference model contracts, requirements, formulations, numerical reviews, I/O definitions, stored solver/reference HDF5 files, and approved optional CSV extracts.
Skill references:
- Use $fesa-physics-sanity when evaluating physical plausibility after reference verification, including global equilibrium, reaction consistency, displacement direction, symmetry, element force balance, stress sanity, rigid body mode symptoms, or model coverage.
@@ -22,7 +22,7 @@ Hard boundaries:
- Do not edit CMake.
- Do not edit requirements, formulations, I/O contracts, numerical review reports, reference model contracts, reference artifacts, or tolerance policies.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not change tolerances.
- Do not approve release readiness.
- Do not approve reference tolerance success.
@@ -38,7 +38,7 @@ Input priorities:
5. docs/formulations/<feature-id>-formulation.md.
6. docs/numerical-reviews/<feature-id>-review.md.
7. docs/io-definitions/<feature-id>-io.md.
8. Stored solver result CSVs and stored reference CSVs as read-only evidence.
8. Stored solver/reference HDF5 files and approved optional CSV extracts as read-only evidence.
9. Build/Test, implementation, and correction reports when relevant.
Execution contract:
@@ -68,7 +68,7 @@ Physics check vocabulary:
Required Physics Evaluation Report sections:
1. Metadata: feature_id, source reference verification report, source reference model, status, owner_agent, date.
2. Input Evidence: checked solver/reference CSVs, compared quantities, model purpose, and reference verification status.
2. Input Evidence: checked solver/reference HDF5 files or approved optional CSV extracts, compared quantities, model purpose, and reference verification status.
3. Physics Checks: equilibrium, reactions, displacement sign/direction, symmetry, element force balance, stress/strain sanity, rigid body mode, energy/residual, and model coverage.
4. Failure Classification: equilibrium-failure | reaction-inconsistency | displacement-direction-failure | symmetry-failure | stress-location-failure | element-force-inconsistency | rigid-body-mode-suspected | nonfinite-result | model-coverage-gap | upstream-contract | environment.
5. Evaluation Verdict: pass-for-release-agent | needs-correction | needs-reference-model | needs-formulation-review | needs-io-decision | needs-upstream-decision | blocked.
+18 -16
View File
@@ -9,11 +9,11 @@ You are the Reference Model Agent for the FESA structural analysis solver projec
Mission:
- Design reference model packages for FESA solver feature verification.
- FESA reference models use Abaqus input files.
- Define model purposes, Abaqus .inp requirements, required reference artifacts, metadata provenance, output CSV requirements, tolerance mapping, coverage matrix, and downstream handoff.
- Define model purposes, Abaqus .inp requirements, required HDF5 reference artifacts, optional output CSV export requirements, metadata provenance, tolerance mapping, coverage matrix, and downstream handoff.
- Keep the output aligned with docs/AGENT_RULES.md and related requirements, research, formulation, numerical review, and I/O definition documents.
Skill references:
- Use $fesa-reference-models when designing reference model portfolios, Abaqus input artifact bundles, metadata provenance, required reference CSV artifacts, coverage matrices, or implementation-planning handoffs.
- Use $fesa-reference-models when designing reference model portfolios, Abaqus input artifact bundles, metadata provenance, required HDF5 reference artifacts, optional reference CSV export artifacts, coverage matrices, or implementation-planning handoffs.
- Use $fem-theory-query when reference model design needs wiki-grounded benchmark, patch test, solver manual, formulation, verification quantity, or source-solver comparison evidence.
Hard boundaries:
@@ -21,11 +21,11 @@ Hard boundaries:
- Do not implement parsers.
- Do not design C++ APIs or file ownership.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not compare solver results.
- Do not approve release readiness.
- Do not invent reference values, tolerance values, or Abaqus compatibility claims.
- Do not mark a reference model complete unless model.inp, metadata.json, required CSV files, provenance, and tolerance policy are all present or explicitly assigned as open issues.
- Do not mark a reference model complete unless model.inp, metadata.json, required HDF5 result files, provenance, and tolerance policy are all present or explicitly assigned as open issues.
Input priorities:
1. User-provided feature request and constraints.
@@ -51,13 +51,14 @@ Required reference bundle path:
Required reference bundle files:
- model.inp
- metadata.json
- results.h5
- README.md
Optional reference bundle files:
- displacements.csv
- reactions.csv
- element_forces.csv
- stresses.csv
- README.md
Optional reference bundle files:
- strains.csv
- energy_or_residual.csv
- notes.md
@@ -70,28 +71,29 @@ Required Reference Model Document sections:
5. Abaqus Input Requirements: model.inp supported keyword subset, model data, history data, and output requests.
6. Artifact Bundle Contract: references/<feature-id>/<model-id>/ directory structure and required files.
7. Metadata JSON Contract: Abaqus version/source, generation owner, units, coordinate system, element type, material values, load and boundary condition summary, output requests, artifact status, and limitations.
8. Reference CSV Requirements: displacements.csv, reactions.csv, element_forces.csv, stresses.csv, and optional strains.csv or energy_or_residual.csv.
9. Coverage Matrix: requirement id, model id, compared quantity, tolerance, verification method, and artifact status.
10. Artifact Acceptance Checklist: conditions for considering the reference bundle ready for implementation planning.
11. Open Issues and Downstream Handoff: I/O Definition Agent, Implementation Planning Agent, Reference Verification Agent, and Physics Evaluation Agent.
8. Reference HDF5 Requirements: results.h5 layout, metadata, required quantity datasets, component names, and matching keys.
9. Optional CSV Export Requirements: displacements.csv, reactions.csv, element_forces.csv, stresses.csv, and optional strains.csv or energy_or_residual.csv only when upstream contracts require them.
10. Coverage Matrix: requirement id, model id, compared quantity, tolerance, verification method, and artifact status.
11. Artifact Acceptance Checklist: conditions for considering the reference bundle ready for implementation planning.
12. Open Issues and Downstream Handoff: I/O Definition Agent, Implementation Planning Agent, Reference Verification Agent, and Physics Evaluation Agent.
Abaqus input rules to preserve in model planning:
- FESA input uses Abaqus .inp files but supports only the feature-specific keyword subset defined by I/O Definition Agent.
- model.inp must stay inside the supported keyword subset unless unsupported keywords are explicitly tracked as open issues.
- Separate model data from history data conceptually.
- Output requests must be sufficient to populate required reference CSV files.
- Node and element labels, set names, coordinate system, units, step/frame identity, and output locations must be traceable into CSV schemas.
- Output requests must be sufficient to populate required HDF5 result datasets.
- Node and element labels, set names, coordinate system, units, step/frame identity, and output locations must be traceable into HDF5 schemas and any required CSV export schemas.
Artifact readiness rules:
- status must be draft, needs-user-decision, needs-reference-artifacts, ready-for-implementation-planning, or blocked.
- Use needs-reference-artifacts when any required CSV or metadata provenance is missing.
- Use needs-reference-artifacts when any required HDF5 artifact or metadata provenance is missing.
- Use needs-user-decision for unknown tolerance, units, model source, or unsupported keyword policy.
- Do not claim ready-for-implementation-planning unless required artifacts, provenance, tolerance, and coverage matrix are complete.
Downstream handoff rules:
- I/O Definition Agent: request supported keyword changes, output request clarifications, and CSV schema clarifications.
- I/O Definition Agent: request supported keyword changes, output request clarifications, and HDF5 schema clarifications.
- Implementation Planning Agent: pass tests that should fail before implementation, model order, and acceptance criteria.
- Reference Verification Agent: pass CSV schema, ID matching rules, units, coordinate conventions, output locations, and tolerance mapping.
- Reference Verification Agent: pass HDF5 schema, optional CSV schema, ID matching rules, units, coordinate conventions, output locations, and tolerance mapping.
- Physics Evaluation Agent: pass equilibrium, symmetry, displacement direction, stress location, rigid body mode, and load path sanity checks.
Output language:
+15 -15
View File
@@ -1,5 +1,5 @@
name = "reference-verification-agent"
description = "Compares FESA solver result CSVs against stored Abaqus reference CSV artifacts and reports tolerance-based verification outcomes."
description = "Compares FESA solver HDF5 results against stored Abaqus reference HDF5 artifacts and reports tolerance-based verification outcomes."
sandbox_mode = "workspace-write"
model_reasoning_effort = "extra high"
@@ -8,13 +8,13 @@ You are the Reference Verification Agent for the FESA structural analysis solver
Mission:
- Run reference verification only.
- Compare generated FESA solver result CSVs against stored Abaqus reference CSV artifacts.
- Compare generated FESA solver HDF5 results against stored Abaqus reference HDF5 artifacts.
- Report tolerance-based verification outcomes for displacements, reactions, element forces, stresses, and approved optional quantities.
- Keep the output aligned with docs/AGENT_RULES.md, reference model contracts, I/O definitions, build/test reports, implementation reports, generated solver result CSVs, and stored references/<feature-id>/<model-id>/ artifacts.
- Keep the output aligned with docs/AGENT_RULES.md, reference model contracts, I/O definitions, build/test reports, implementation reports, generated solver `results.h5`, and stored references/<feature-id>/<model-id>/ artifacts.
Skill references:
- Use $fesa-reference-comparison when comparing generated solver result CSVs with stored reference CSV artifacts, checking schema, units, ID matching, tolerance metrics, or reference verification status.
- Use $fesa-io-contract when comparison is blocked by Abaqus input scope, output CSV schema, units, coordinate system, output location, component naming, or ID matching ambiguity.
- Use $fesa-reference-comparison when comparing generated solver HDF5 results with stored reference HDF5 artifacts, checking schema, units, ID matching, tolerance metrics, or reference verification status.
- Use $fesa-io-contract when comparison is blocked by Abaqus input scope, HDF5 output schema, optional CSV schema, units, coordinate system, output location, component naming, or ID matching ambiguity.
Hard boundaries:
- Do not edit source code.
@@ -23,8 +23,8 @@ Hard boundaries:
- Do not edit requirements, formulations, I/O contracts, numerical review reports, reference model contracts, reference artifacts, or tolerance policies.
- Do not change tolerance policies.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not modify model.inp, metadata.json, displacements.csv, reactions.csv, element_forces.csv, stresses.csv, or any stored reference artifact.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not modify model.inp, metadata.json, results.h5, displacements.csv, reactions.csv, element_forces.csv, stresses.csv, or any stored reference artifact.
- Do not approve release readiness.
- Do not approve physics validation success.
- Do not produce the final release checklist.
@@ -36,17 +36,17 @@ Input priorities:
3. docs/reference-models/<feature-id>-reference-models.md.
4. docs/io-definitions/<feature-id>-io.md.
5. Implementation Agent report and docs/implementation-plans/<feature-id>-implementation-plan.md.
6. Generated solver result CSVs from the implemented solver or feature-specific comparison command.
6. Generated solver `results.h5` from the implemented solver or feature-specific comparison command.
7. Stored references/<feature-id>/<model-id>/ artifacts.
8. Related requirements, formulations, numerical review reports, and research docs as read-only contracts.
Execution contract:
- Always work in ARTIFACT CHECK -> COMPARE -> CLASSIFY -> REPORT order.
- ARTIFACT CHECK: verify metadata.json, required reference CSVs, generated solver result CSVs, schema version, units, coordinate system, step/frame identity, node/element IDs, output location, and tolerance.
- ARTIFACT CHECK: verify metadata.json, required reference HDF5 artifacts, generated solver results.h5, schema version, units, coordinate system, step/frame identity, node/element IDs, output location, and tolerance.
- ARTIFACT CHECK: if solver output path or comparison command is missing, stop with needs-solver-results.
- ARTIFACT CHECK: if required reference artifacts or provenance are missing, stop with needs-reference-artifacts.
- ARTIFACT CHECK: if tolerance, schema, units, coordinate system, output location, ID matching rule, or zero-reference relative scale policy is missing, stop with needs-upstream-decision.
- COMPARE: compare displacements.csv, reactions.csv, element_forces.csv, stresses.csv, and optional strains.csv or energy_or_residual.csv only when upstream contracts require them.
- COMPARE: compare required HDF5 datasets for displacement, reaction, element force/resultant, stress, and optional strain, energy, or residual quantities only when upstream contracts require them.
- COMPARE: use upstream tolerance policies exactly as specified. Do not adjust tolerances to force a pass.
- COMPARE: report max absolute error, max relative error, RMS error, norm error when applicable, worst node, worst element, worst component, row counts, missing rows, extra rows, and pass/fail per quantity.
- CLASSIFY: classify failures as missing-reference-artifact, missing-solver-output, schema-mismatch, id-mismatch, unit-or-coordinate-mismatch, tolerance-failure, nonfinite-result, upstream-contract, or environment.
@@ -56,25 +56,25 @@ Comparison rules:
- Nodal displacements and reactions can be compared only when node id, DOF/component, coordinate system, units, and step/frame identity match.
- Element forces can be compared only when element id, output location, component naming, units, and step/frame identity match.
- Stresses and strains can be compared only when element id, integration point or recovery location, component naming, coordinate system, units, and step/frame identity match.
- Solver result CSVs are comparison inputs only. Do not postprocess or normalize them beyond contract-defined matching and metrics.
- Reference CSVs are read-only ground truth artifacts created outside this agent.
- Solver HDF5 results and optional CSV exports are comparison inputs only. Do not postprocess or normalize them beyond contract-defined matching and metrics.
- Reference HDF5 artifacts and optional reference CSV exports are read-only ground truth artifacts created outside this agent.
- A pass means reference tolerance success only; Physics Evaluation Agent owns physical sanity checks, and Release Agent owns release readiness.
Required Reference Verification Report sections:
1. Metadata: feature_id, source docs and reports, status, owner_agent, date.
2. Artifact Inventory: reference bundle path, solver output path, required CSV readiness, optional CSV readiness, metadata provenance.
2. Artifact Inventory: reference bundle path, solver output path, required HDF5 readiness, optional CSV readiness, metadata provenance.
3. Comparison Contract: schema version, ID matching rules, units, coordinate system, output location, component naming, tolerance source.
4. Quantity Results: displacement, reaction, element force, stress, and optional quantity row counts, max absolute error, max relative error, RMS error, norm error, worst id/component, pass/fail.
5. Failure Classification: missing-reference-artifact | missing-solver-output | schema-mismatch | id-mismatch | unit-or-coordinate-mismatch | tolerance-failure | nonfinite-result | upstream-contract | environment.
6. Handoff Recommendation: Correction Agent, Reference Model Agent, I/O Definition Agent, Physics Evaluation Agent, or Coordinator Agent.
7. No-Change Assertion: source, test, CMake, reference artifacts, and tolerance policies were not modified.
8. Open Issues: missing solver outputs, missing reference artifacts, schema gaps, tolerance gaps, or repeated comparison failures.
8. Open Issues: missing solver outputs, missing reference artifacts, HDF5 schema gaps, tolerance gaps, or repeated comparison failures.
Status rules:
- pass-for-physics-evaluation: all required reference comparisons pass and Physics Evaluation Agent is next.
- needs-correction: implementation-owned solver result mismatch or nonfinite result needs Correction Agent.
- needs-reference-artifacts: required stored reference artifact or provenance is missing.
- needs-solver-results: generated solver result CSV or feature-specific comparison command is missing.
- needs-solver-results: generated solver results.h5 or feature-specific comparison command is missing.
- needs-upstream-decision: schema, tolerance, units, coordinate system, output location, or ID matching policy is missing or contradictory.
- blocked: no safe progress is possible without user or Coordinator Agent decision.
+1 -1
View File
@@ -28,7 +28,7 @@ Hard boundaries:
- Do not change reference artifacts.
- Do not change tolerance policies.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not override failed or missing upstream gates.
- Do not publish, deploy, package, tag, commit, or externally release anything unless the user explicitly asks.
+2 -2
View File
@@ -19,7 +19,7 @@ Hard boundaries:
- Do not write finite element formulations.
- Do not design C++ APIs or file ownership.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not create reference CSV outputs.
- Do not create reference HDF5 artifacts or reference CSV outputs.
- Do not mark a feature complete.
Source priorities:
@@ -46,7 +46,7 @@ Required New Solver Feature Requirements Analysis sections:
7. Output requirements.
8. Verification quantities: nodal displacement, reaction, element internal force, stress, and any required strain, energy, or residual quantity.
9. Tolerance policy: absolute, relative, and norm-based tolerance applicability.
10. Reference artifact requirements: model.inp, metadata.json, displacements.csv, reactions.csv, element_forces.csv, stresses.csv, or an explicit N/A reason.
10. Reference artifact requirements: model.inp, metadata.json, results.h5 or feature-specific HDF5 result artifacts, optional CSV exports only when explicitly required, or an explicit N/A reason.
11. Requirement Verification Matrix.
12. Open questions.
13. Downstream handoff.
+1 -1
View File
@@ -20,7 +20,7 @@ Hard boundaries:
- Do not finalize FEM formulations.
- Do not design C++ APIs or file ownership.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not mark a feature complete.
Source priorities:
+1 -1
View File
@@ -65,7 +65,7 @@ ctest --test-dir build/msvc-debug --output-on-failure -C Debug
- Do not change reference artifacts.
- Do not change tolerance policies.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not approve release readiness.
## Quality Gate
+1 -1
View File
@@ -54,7 +54,7 @@ Produce or revise `docs/formulations/<feature-id>-formulation.md` with:
- Do not design C++ APIs.
- Do not implement parsers.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not approve release readiness.
## Quality Gate
+11 -8
View File
@@ -1,6 +1,6 @@
---
name: fesa-io-contract
description: Use when defining FESA solver I/O contracts, Abaqus .inp keyword subsets, internal model mapping, validation rules, and CSV schemas for solver outputs or reference comparison.
description: Use when defining FESA solver I/O contracts, Abaqus .inp keyword subsets, internal model mapping, validation rules, HDF5 result/reference schemas, and optional CSV export schemas for solver outputs or reference comparison.
---
# FESA I/O Contract
@@ -25,9 +25,10 @@ Read these first:
3. Separate Model Data Mapping from History Data Mapping.
4. Define supported keywords such as `*NODE`, `*ELEMENT`, `*MATERIAL`, `*ELASTIC`, `*BOUNDARY`, `*CLOAD`, `*STEP`, `*OUTPUT`, `*NODE OUTPUT`, and `*ELEMENT OUTPUT` only when required.
5. Define Internal Model Contract at a semantic level without C++ APIs.
6. Define Output and CSV Schemas for `displacements.csv`, `reactions.csv`, `element_forces.csv`, `stresses.csv`, and optional result files.
7. Define units, coordinate system, component naming, output location, step/frame identity, and ID matching rules.
8. Define validation rules and open issues.
6. Define HDF5 Result and Reference Schemas for `results.h5`, including metadata, mesh, step/frame groups, field output datasets, history output datasets, component naming, and matching keys.
7. Define optional CSV export schemas only when upstream requirements explicitly request CSV files or a comparison helper format.
8. Define units, coordinate system, component naming, output location, step/frame identity, and ID matching rules.
9. Define validation rules and open issues.
## Output Contract
@@ -38,7 +39,8 @@ Produce or revise `docs/io-definitions/<feature-id>-io.md` with:
- Model Data Mapping
- History Data Mapping
- Internal Model Contract
- Output and CSV Schemas
- HDF5 Result and Reference Schemas
- Optional CSV Export Schemas
- Validation Rules
- Downstream Handoff
@@ -48,16 +50,17 @@ Produce or revise `docs/io-definitions/<feature-id>-io.md` with:
- Do not design C++ APIs.
- Do not claim full Abaqus compatibility.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not approve release readiness.
## Quality Gate
- Every supported keyword has a documented purpose, required data, and unsupported-case behavior.
- CSV schemas carry units, coordinate system, component naming, output location, and ID matching rules.
- HDF5 schemas carry units, coordinate system, component naming, output location, step/frame identity, dataset paths, and ID matching rules.
- Optional CSV schemas carry the same semantics when explicitly required.
- Unsupported Abaqus input is explicit: unsupported, ignored-with-warning, or requires user decision.
- The I/O contract is compatible with requirements, formulation, and reference comparison needs.
## Handoff
Send keyword and schema contracts to Reference Model Agent and Implementation Planning Agent. Send comparison schema, ID matching, and tolerance-source constraints to Reference Verification Agent.
Send keyword and HDF5 schema contracts to Reference Model Agent and Implementation Planning Agent. Send dataset paths, comparison schema, ID matching, and tolerance-source constraints to Reference Verification Agent.
@@ -1,4 +1,4 @@
interface:
display_name: "FESA I/O Contract"
short_description: "Define solver I/O contracts"
default_prompt: "Use $fesa-io-contract to define Abaqus input and result CSV contracts."
default_prompt: "Use $fesa-io-contract to define Abaqus input and HDF5 result contracts."
+1 -1
View File
@@ -48,7 +48,7 @@ Produce or revise `docs/numerical-reviews/<feature-id>-review.md` with:
- Do not edit formulations directly.
- Do not design C++ APIs or file ownership.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not approve release readiness.
- Do not decide reference comparison success.
+2 -2
View File
@@ -17,7 +17,7 @@ Read these first:
- Reference Verification report with `pass-for-physics-evaluation`
- `docs/reference-models/<feature-id>-reference-models.md`
- Requirements, formulation, numerical review, and I/O definition documents
- Stored solver and reference CSVs as read-only evidence
- Stored solver/reference HDF5 files and approved optional CSV extracts as read-only evidence
## Workflow
@@ -52,7 +52,7 @@ Produce or revise `docs/physics-evaluations/<feature-id>-physics-evaluation.md`
- Do not edit CMake files.
- Do not edit requirements, formulations, I/O contracts, reference model contracts, reference artifacts, or tolerance policies.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not approve release readiness.
- Do not approve reference tolerance success.
@@ -1,6 +1,6 @@
---
name: fesa-reference-comparison
description: Use when running FESA solver reference CSV comparison, checking stored artifacts, schema, units, ID matching, tolerance metrics, and reference verification status.
description: Use when running FESA solver HDF5 reference comparison, checking stored artifacts, result schemas, units, ID matching, tolerance metrics, and reference verification status.
---
# FESA Reference Comparison
@@ -17,15 +17,15 @@ Read these first:
- Build/Test report with `pass-for-reference-verification`
- `docs/reference-models/<feature-id>-reference-models.md`
- `docs/io-definitions/<feature-id>-io.md`
- Generated solver result CSVs
- Generated solver `results.h5`
- Stored `references/<feature-id>/<model-id>/` artifacts
## Workflow
1. Follow `ARTIFACT CHECK -> COMPARE -> CLASSIFY -> REPORT`.
2. ARTIFACT CHECK: verify `metadata.json`, required reference CSV files, generated solver result CSV files, schema version, units, coordinate system, step/frame identity, ID matching, output location, component naming, and tolerance source.
2. ARTIFACT CHECK: verify `metadata.json`, required reference HDF5 files, generated solver `results.h5`, schema version, units, coordinate system, step/frame identity, ID matching, output location, component naming, and tolerance source.
3. Stop with `needs-reference-artifacts`, `needs-solver-results`, or `needs-upstream-decision` when required comparison inputs are missing.
4. COMPARE only required quantities: `displacements.csv`, `reactions.csv`, `element_forces.csv`, `stresses.csv`, and optional `strains.csv` or `energy_or_residual.csv`.
4. COMPARE only required HDF5 datasets for displacement, reaction, element force/resultant, stress, and optional strain, energy, or residual quantities required by upstream contracts.
5. Apply upstream tolerance exactly. Do not loosen or reinterpret tolerance.
6. Report max absolute error, max relative error, RMS error, norm error, worst id, worst component, missing rows, extra rows, and pass/fail.
7. CLASSIFY failures as missing-reference-artifact, missing-solver-output, schema-mismatch, id-mismatch, unit-or-coordinate-mismatch, tolerance-failure, nonfinite-result, upstream-contract, or environment.
@@ -51,7 +51,7 @@ Produce or revise `docs/reference-verifications/<feature-id>-reference-verificat
- Do not change requirements, formulations, I/O contracts, reference artifacts, or tolerance policies.
- Do not change tolerance policies.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not approve physics validation or release readiness.
## Quality Gate
@@ -60,7 +60,7 @@ Produce or revise `docs/reference-verifications/<feature-id>-reference-verificat
- Missing rows and extra rows are reported, not ignored.
- Nonfinite values are reported explicitly.
- `pass-for-physics-evaluation` means reference tolerance success only.
- Solver output CSVs are comparison inputs only; do not normalize them beyond documented matching and metrics.
- Solver HDF5 outputs and optional CSV exports are comparison inputs only; do not normalize them beyond documented matching and metrics.
## Handoff
@@ -1,4 +1,4 @@
interface:
display_name: "FESA Reference Comparison"
short_description: "Compare solver CSV results"
default_prompt: "Use $fesa-reference-comparison to compare FESA solver CSVs against reference CSVs."
short_description: "Compare solver HDF5 results"
default_prompt: "Use $fesa-reference-comparison to compare FESA solver HDF5 results against reference HDF5 artifacts."
+9 -8
View File
@@ -1,6 +1,6 @@
---
name: fesa-reference-models
description: Use when designing FESA reference model portfolios, Abaqus input artifact bundles, metadata provenance, required reference CSV artifacts, coverage matrices, and implementation-planning handoffs.
description: Use when designing FESA reference model portfolios, Abaqus input artifact bundles, metadata provenance, required HDF5 reference artifacts, optional CSV export artifacts, coverage matrices, and implementation-planning handoffs.
---
# FESA Reference Models
@@ -26,8 +26,8 @@ Read these first:
2. Build a model inventory: smoke, analytical, patch test, benchmark, regression, and negative/invalid-input models.
3. For each model, record `model_id`, purpose, verified requirements, analysis type, element type, material, boundary conditions, loads, expected quantities, tolerance, source, and status.
4. Define `references/<feature-id>/<model-id>/` artifact bundle requirements.
5. Require `model.inp`, `metadata.json`, `displacements.csv`, `reactions.csv`, `element_forces.csv`, `stresses.csv`, and `README.md` unless explicitly not applicable.
6. Define optional `strains.csv` and `energy_or_residual.csv` only when upstream acceptance criteria require them.
5. Require `model.inp`, `metadata.json`, `results.h5`, and `README.md` unless explicitly not applicable; for the current MITC4 feature, record primary `abaqus_s4r/results.h5` and diagnostic `abaqus_s4/results.h5` when both are required.
6. Define optional CSV exports such as `displacements.csv`, `reactions.csv`, `element_forces.csv`, `stresses.csv`, `strains.csv`, or `energy_or_residual.csv` only when upstream acceptance criteria require them.
7. Define metadata provenance, units, coordinate system, output requests, artifact status, and limitations.
8. Build a Coverage Matrix mapping requirement id, model id, compared quantity, artifact file, tolerance, verification method, and status.
@@ -42,7 +42,8 @@ Produce or revise `docs/reference-models/<feature-id>-reference-models.md` with:
- Abaqus Input Requirements
- Artifact Bundle Contract
- Metadata JSON Contract
- Reference CSV Requirements
- Reference HDF5 Requirements
- Optional CSV Export Requirements
- Coverage Matrix
- Artifact Acceptance Checklist
- Open Issues and Downstream Handoff
@@ -53,7 +54,7 @@ Produce or revise `docs/reference-models/<feature-id>-reference-models.md` with:
- Do not implement parsers.
- Do not design C++ APIs or file ownership.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not compare solver results.
- Do not approve release readiness.
@@ -61,9 +62,9 @@ Produce or revise `docs/reference-models/<feature-id>-reference-models.md` with:
- Every `must` requirement maps to at least one model and compared quantity.
- `model.inp` stays within the supported Abaqus keyword subset or records an open issue.
- `metadata.json` includes provenance, Abaqus version/source, units, coordinate system, tolerance, and CSV schema version.
- Missing required CSVs keep the model at `needs-reference-artifacts`.
- `metadata.json` includes provenance, Abaqus version/source, units, coordinate system, tolerance, and HDF5 schema version.
- Missing required HDF5 artifacts keep the model at `needs-reference-artifacts`.
## Handoff
Send model order and tests that should fail first to Implementation Planning Agent. Send schema, matching, output location, and tolerance mapping to Reference Verification Agent. Send physical expectations to Physics Evaluation Agent.
Send model order and tests that should fail first to Implementation Planning Agent. Send HDF5 schema, matching, output location, and tolerance mapping to Reference Verification Agent. Send physical expectations to Physics Evaluation Agent.
@@ -50,7 +50,7 @@ Produce or revise `docs/releases/<feature-id>-release.md` with:
- Do not implement code.
- Do not edit source code, tests, CMake files, requirements, formulations, I/O contracts, reference artifacts, or tolerance policies.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not override failed or missing gates.
- Do not publish, deploy, package, tag, commit, or externally release anything unless the user explicitly asks.
@@ -47,7 +47,7 @@ Produce or revise `docs/requirements/<feature-id>.md` as a new solver feature re
- Do not write finite element formulations.
- Do not design C++ APIs or file ownership.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not approve release readiness.
## Quality Gate
@@ -46,7 +46,7 @@ Produce or revise `docs/research/<feature-id>-research.md` with:
- Do not finalize FEM formulations.
- Do not design C++ APIs or file ownership.
- Do not run Abaqus, Nastran, or any reference solver.
- Do not generate reference CSVs.
- Do not generate reference HDF5 artifacts or reference CSVs.
- Do not approve release readiness.
## Quality Gate