---
name: abaqus-subroutine-research
description: Use when collecting Abaqus User Subroutine research evidence from official Abaqus manuals, books, papers, benchmark sources, and source reliability notes before formulation, interface definition, or test model design.
---

# Abaqus Subroutine Research

Use this skill to collect source-backed Research evidence for Abaqus User Subroutine work while separating verified facts from inference.

## Inputs

Read first:

- `AGENTS.md`
- `docs/ABAQUS_SUBROUTINE_AGENT_DESIGN.md`
- `docs/research/README.md`
- `docs/requirements/<feature-id>.md`
- User-provided references, official Abaqus documentation links, books, papers, and benchmark sources

## Workflow

1. Define exact research questions from requirements and open issues.
2. Search source priorities in order: official Abaqus documentation, Abaqus User Subroutines Reference Guide, Abaqus Analysis User's Guide, books, papers, and benchmark sources.
3. Record source reliability tier, citation, scope, assumptions, and applicability limits.
4. Extract only facts needed by downstream formulation, Abaqus ABI interface definition, TDD test models, and Fortran implementation.
5. Separate verified facts from inference.
6. Identify candidate benchmark models, closed-form checks, patch tests, tangent checks, and negative tests.
7. Record unresolved conflicts or missing evidence as open issues.

## Output Contract

Produce or revise `docs/research/<feature-id>-research.md` with Source Inventory, Source Reliability Tier, Extracted Facts, Candidate Benchmarks, Verification Relevance, Applicability Limits, Open Issues, and Downstream Handoff.

## Boundaries

- Do not implement code.
- Do not finalize FEM formulations.
- Do not design Fortran source layout or Abaqus wrapper code.
- Do not run Abaqus.
- Do not generate reference CSVs.
- Do not approve release readiness.

## Quality Gate

- Source tiers are explicit.
- Each extracted fact links to a cited source.
- Inference is labeled as inference.
- Benchmark applicability limits are clear enough for Formulation and Reference Model Agents.

## Handoff

Send math evidence to Formulation Agent, Abaqus parameter evidence to I/O Definition Agent, benchmark candidates to Reference Model Agent, and validation risk notes to Numerical Review Agent.