initial commit

2026-06-09 12:27:22 +09:00
commit f186160e44
79 changed files with 6915 additions and 0 deletions
@@ -0,0 +1,53 @@
+---
+name: abaqus-subroutine-validation
+description: Use when validating Abaqus User Subroutine outputs against stored reference artifacts, checking metadata, source hashes, Abaqus and compiler versions, msg/dat/log tails, CSV schemas, tolerances, and opt-in Abaqus validation evidence.
+---
+
+# Abaqus Subroutine Validation
+
+Use this skill to validate implemented subroutines against no-Abaqus results and stored Abaqus reference artifacts without changing either side. Subroutine validation is the owned artifact for this skill.
+
+## Inputs
+
+Read first:
+
+- `AGENTS.md`
+- `docs/ABAQUS_SUBROUTINE_AGENT_DESIGN.md`
+- `docs/reference-verifications/README.md`
+- `docs/reference-models/<feature-id>-reference-models.md`
+- `references/<feature-id>/<model-id>/metadata.json`
+- Generated no-Abaqus and extracted CSV outputs
+
+## Workflow
+
+1. Validate artifact metadata with `python scripts/validate_reference_artifacts.py`.
+2. For `ready-for-comparison`, check model `.inp`, metadata.json, source hash, Abaqus version, compiler version, msg/dat/log tail files, and declared CSV files.
+3. Run no-Abaqus comparison commands when available.
+4. Run Abaqus only when explicitly configured through `HARNESS_ABAQUS_VALIDATION=run` and `HARNESS_ABAQUS_VALIDATION_COMMANDS`.
+5. Compare generated CSVs against reference CSVs by documented IDs, units, coordinate system, output location, component naming, and tolerance.
+6. Classify failures as `missing-reference-artifact | missing-generated-output | schema-mismatch | id-mismatch | source-hash-mismatch | unit-or-coordinate-mismatch | tolerance-failure | nonfinite-result | environment | upstream-contract`.
+
+## Output Contract
+
+Produce or revise `docs/reference-verifications/<feature-id>-reference-verification.md` with Artifact Inventory, Comparison Contract, Quantity Results, Failure Classification, Validation Evidence, Handoff Recommendation, and No-Change Assertion.
+
+## Boundaries
+
+- Do not edit source code.
+- Do not edit tests.
+- Do not change reference artifacts.
+- Do not change tolerance policies.
+- Do not generate reference CSVs.
+- Do not run Abaqus unless the opt-in environment contract is explicit.
+- Do not approve release readiness.
+
+## Quality Gate
+
+- `ready-for-comparison` artifacts pass metadata validation.
+- Source hash, Abaqus version, compiler version, msg/dat/log provenance, and CSV schemas are reported.
+- Every compared quantity reports max absolute error, max relative error, RMS error when applicable, worst row, and pass/fail.
+- Nonfinite values are reported explicitly.
+
+## Handoff
+
+Send implementation-owned mismatches to Correction Agent, artifact gaps to Reference Model Agent, ABI/schema gaps to I/O Definition Agent, and physically suspicious passing results to Physics Evaluation Agent.