update agent, skill and scripts

This commit is contained in:
KOKO\Mimi
2026-09-07 01:15:26 +09:00
parent 42a4847da5
commit d7e9629640
38 changed files with 476 additions and 2946 deletions
+3 -32
View File
@@ -1,39 +1,10 @@
---
name: fem-formulation-spec
description: Use when an approved structural FEM feature needs an implementation-ready mathematical formulation before numerical review or coding.
description: Produce an implementation-ready mathematical formulation for a new or changed structural FEM model.
---
# FEM Formulation Specification
Translate approved requirements and research into a complete mathematical contract, independent of programming APIs and storage formats.
Define only the model required by the assigned feature: assumptions, strong/weak form, kinematics, constitutive update, discretization, DOF/component and sign conventions, residual, consistent tangent where applicable, integration, state update, recovery, and formulation-level invariants. Distinguish small/large deformation and analysis-family assumptions.
## Inputs
- `docs/<feature-id>/requirements.md`
- `docs/<feature-id>/research.md`
- Governing standards and approved analysis assumptions
## Workflow
1. Fix primary variables, degrees of freedom, units, coordinates, signs, configuration, and boundary-condition conventions.
2. Derive governing strong and weak forms with all natural and essential boundary terms.
3. Define discretization, interpolation, kinematics, constitutive update contract, element residual/internal and external forces, and consistent tangent or stiffness.
4. Define mapping, Jacobian validity, quadrature, state/history evolution, constraints, and result recovery that apply to the selected analysis family.
5. State dimensions, invariants, algorithm pseudocode, numerical risks, and tests capable of falsifying each derivation.
Read [analysis-family guidance](references/analysis-families.md) and apply only the sections selected by the requirements. Use [workflow and decision authority](../fem-requirements-baseline/references/workflow-and-decisions.md) for unresolved physics choices and [evidence and handoff](../fem-requirements-baseline/references/evidence-and-handoff.md) for return data.
## Output
Follow [Feature document management](../../../docs/FEATURE_DOCUMENTATION.md): read the Coordinator's
feature context, keep main reports concise, and link necessary owned details in the same feature folder.
Create or revise `docs/<feature-id>/formulation.md` with assumptions; variables; strong/weak forms; discretization; kinematics; constitutive contract; element equations; integration; algorithms; recovery; numerical risks; verification implications; and handoff.
## Evidence
Every equation defines symbols, dimensions, configuration, sign, coordinate basis, and source or derivation. Show linearization when a consistent tangent is required. Link risks and checks to requirement IDs.
## Boundary
Do not design source-level APIs, parsers, storage schemas, or implementation tasks. Do not silently choose physics, stabilization, interpolation, constitutive behavior, or solver semantics outside the approved contract; return that critical choice for decision.
Use approved requirements and evidence; consult [analysis-family guidance](references/analysis-families.md) when specifying that family's formulation. Make physics-changing choices explicit and return unresolved scope or evidence gaps rather than silently choosing them. Include verification implications, but do not prescribe C++ storage, persistent schema, tolerance values, or reference-result edits.