From agent-almanac
Analyzes tensegrity systems: identifies compression struts and tension cables, classifies types (class 1/2, biological/architectural), computes prestress equilibrium, verifies stability via Maxwell's criterion, maps cytoskeletal elements.
npx claudepluginhub pjt222/agent-almanacThis skill is limited to using the following tools:
Analyze a tensegrity (tensional integrity) system -- a structure where isolated compression elements (struts) are stabilized by a continuous tension network (cables/tendons). Determine the system's force balance, prestress equilibrium, structural stability, and cross-scale coherence from molecular cytoskeleton to architectural form.
Performs spacecraft structural analysis including launch loads, material selection, stress & buckling checks, margin-of-safety calculations, and mass-optimized design. Use for sizing structures, load evaluation, or test plan reviews.
Provides structural systems knowledge for architects including typology selection, grid design, lateral stability, foundations, span-to-depth ratios, load paths, and decision frameworks by span, height, program, cost, speed, sustainability.
Guides finite element analysis, form-finding methods, shell and gridshell structures, topology optimization, and computational tools for AEC structural design.
Share bugs, ideas, or general feedback.
Analyze a tensegrity (tensional integrity) system -- a structure where isolated compression elements (struts) are stabilized by a continuous tension network (cables/tendons). Determine the system's force balance, prestress equilibrium, structural stability, and cross-scale coherence from molecular cytoskeleton to architectural form.
Establish the complete physical description by identifying every compression element (strut) and tension element (cable), their connectivity, and the boundary conditions.
## System Characterization
| ID | Type | Length | Cross-section | Material | Stiffness |
|----|-------|----------|---------------|----------------|---------------|
| S1 | strut | [value] | [value] | [material] | E = [value] |
| C1 | cable | [value] | [value] | [material] | EA = [value] |
- **Nodes**: [count], [fixed vs. free]
- **Scale**: [molecular / cellular / architectural / robotic]
- **Boundary conditions**: [description]
Expected: A complete inventory of all compression and tension elements with material properties, an incidence matrix, and boundary conditions sufficient to set up the equilibrium equations.
On failure: If element properties are unknown (common in biological systems), use published values: microtubules (E ~ 1.2 GPa, persistence length ~ 5 mm), actin (E ~ 2.6 GPa, persistence length ~ 17 um), intermediate filaments (highly nonlinear, strain-stiffening with low initial modulus ~1 MPa rising to ~1 GPa at high strain). If connectivity is unclear, reduce the system to the simplest topology that captures the essential force paths.
Determine what class of tensegrity the system belongs to and whether it is biological or engineered.
## Tensegrity Classification
- **Class**: [1 (isolated struts) / 2 (strut-strut contact)]
- **Dimension**: [2D / 3D]
- **Topology**: [prism / octahedron / icosahedron / X-module / irregular]
- **Category**: [biological / architectural / robotic / artistic]
- **b** (members): [value], **j** (nodes): [value]
### Biological Tensegrity Mapping (if applicable)
| Cell Component | Tensegrity Role | Key Properties |
|-------------------------|-----------------------|---------------------------------------------|
| Microtubules | Compression struts | 25 nm OD, E~1.2 GPa, dynamic instability |
| Actin filaments | Tension cables | 7 nm, cortical network, actomyosin contract. |
| Intermediate filaments | Deep tension/prestress| 10 nm, strain-stiffening, nucleus-to-membrane|
| Extracellular matrix | External anchor | Collagen/fibronectin, integrin attachment |
| Focal adhesions | Ground nodes | Mechanosensitive, connect cytoskeleton to ECM |
| Nucleus | Internal compression | Lamina network forms sub-tensegrity |
Expected: A clear classification (class, dimension, category) with the biological mapping table completed for biological systems. For engineered systems, the topology family is identified.
On failure: If the system does not cleanly fit class 1 or class 2, it may be a hybrid or a conventional frame. A true tensegrity requires that at least some elements work only in tension (cables that go slack under compression). If no elements are tension-only, the system is not a tensegrity -- reclassify as a conventional truss or frame and apply standard structural analysis.
Compute static equilibrium at every node, determine the state of prestress (internal tension/compression with no external load), and verify that all cables remain in tension.
## Prestress Equilibrium
- **Equilibrium matrix A**: [dj] x [b] = [size]
- **Rank of A**: [value]
- **Self-stress states (s)**: s = b - rank(A) = [value]
- **Self-stress feasibility**: [all cables in tension? Yes/No]
- **Minimum cable tension**: t_min = [value]
- **Critical external load**: F_crit = [value]
| Member | Type | Force Density | Force | Status |
|--------|-------|---------------|---------|-------------|
| S1 | strut | [negative] | [value] | compression |
| C1 | cable | [positive] | [value] | tension |
Expected: Self-stress states are computed, a physically realizable prestress (all cables in tension, all struts in compression) is found, and load capacity is estimated.
On failure: If no self-stress state keeps all cables in tension, the topology does not support a tensegrity prestress. Either (a) the incidence matrix has errors, (b) the system needs additional cables, or (c) it is a mechanism rather than a tensegrity. For large systems, use the force density method (Schek, 1974) or numerical null-space computation rather than hand calculation.
Determine whether the tensegrity is rigid (stable against infinitesimal perturbations) or a mechanism (has zero-energy deformation modes).
Apply the extended Maxwell rule: For a pin-jointed framework in d dimensions with b bars, j nodes, k kinematic constraints (supports), s self-stress states, and m infinitesimal mechanisms:
b - dj + k + s = m
This relates bars, joints, and constraints to the balance between self-stress and mechanism states.
Compute from the equilibrium matrix: rank(A) = b - s. The number of mechanisms is m = dj - k - rank(A). If m = 0, the structure is first-order rigid. If m > 0, prestress stability must be checked.
Prestress stability test: For each mechanism mode q, compute the second-order energy E_2 = q^T * G * q, where G is the geometric stiffness matrix (stress matrix). If E_2 > 0 for all mechanism modes, the tensegrity is prestress-stable (Connelly and Whiteley, 1996). This is how tensegrity achieves rigidity -- not through bar count, but through prestress stabilization of mechanisms.
Classify rigidity:
## Stability Analysis (Maxwell's Criterion)
- **Bars (b)**: [value]
- **Joints (j)**: [value]
- **Dimension (d)**: [2 or 3]
- **Kinematic constraints (k)**: [value]
- **Rank of A**: [value]
- **Self-stress states (s)**: [value]
- **Mechanisms (m)**: [value]
- **Maxwell check**: b - dj + k + s = m --> [values]
- **Prestress stability**: [stable / unstable / N/A]
- **Rigidity class**: [determinate / indeterminate / prestress-stable / mechanism]
Expected: Maxwell count performed, mechanisms determined, and for m > 0, prestress stability evaluated. The structure is classified as rigid, prestress-stable, or mechanism.
On failure: If the structure is a mechanism (m > 0 and not prestress-stable), options: (a) add cables to increase b and reduce m, (b) increase prestress, (c) modify topology. In biological systems, active actomyosin contractility continuously adjusts prestress to maintain stability -- the cell is a self-tuning tensegrity.
If the system has a biological interpretation, map the analysis to Ingber's cellular tensegrity model and check cross-scale coherence. Skip this step for purely engineered systems.
## Cross-Scale Biological Tensegrity
| Scale | Compression | Tension | Prestress Source | Nodes |
|------------|--------------------|----------------------|-----------------------|--------------------|
| Molecular | Tubulin dimers | Actin/IF subunits | ATP/GTP hydrolysis | Protein complexes |
| Cellular | Microtubules | Actin cortex + IFs | Actomyosin | Focal adhesions |
| Tissue | Cells (turgor) | ECM (collagen) | Cell contractility | Cell-ECM junctions |
| Organ | Bones | Muscles + fascia | Muscle tone | Joints |
### Mechanotransduction Pathway
ECM --> integrin --> focal adhesion --> actin cortex --> IF --> nuclear lamina --> chromatin
Expected: Biological tensegrity mapped at each relevant scale with compression, tension, prestress source, and nodes identified. Cross-scale force transmission documented.
On failure: If the cross-scale mapping breaks (no clear tension continuity between scales), document the gap. Not all biological structures are tensegrity at all scales. The spine is tensegrity at the musculoskeletal level (bones=struts, muscles/fascia=cables) but individual vertebrae are conventional compression structures internally.
Combine all preceding analyses into a final assessment of the system's tensional integrity.
## Structural Integrity Assessment
- **Prestress equilibrium**: [achieved / not achieved]
- **Rigidity**: [determinate / indeterminate / prestress-stable / mechanism]
- **Load capacity margin**: [value or qualitative]
- **Critical member**: [ID] -- failure causes [consequence]
- **Redundancy**: [cables removable before mechanism]
- **Integrity rating**: [ROBUST / MARGINAL / FRAGILE]
### Recommendations
1. [specific recommendation]
2. [specific recommendation]
3. [specific recommendation]
Expected: Complete structural integrity assessment with rigidity classification, vulnerability identification, redundancy analysis, and integrity rating (ROBUST/MARGINAL/FRAGILE) with actionable recommendations.
On failure: If the analysis is incomplete (equilibrium matrix too large, biological parameters unknown), state the assessment as conditional: "MARGINAL pending numerical verification" or "classification requires experimental measurement of prestress level." Partial assessment with explicit gaps is more valuable than no assessment.
assess-form -- structural inventory and transformation readiness; assess-form evaluates a system's form generically, while this skill applies the specific tensegrity framework of compression-tension decompositionadapt-architecture -- architectural metamorphosis; tensegrity analysis identifies whether integrity depends on tension continuity, informing which elements can safely be modified during transformationrepair-damage -- regenerative recovery; in tensegrity, cable failure and strut failure have different consequences, and the critical member analysis (Step 6) directly informs repair prioritycenter -- dynamic reasoning balance; tensegrity's principle of stability through balanced tension (not rigid compression) is the structural metaphor underlying centeringintegrate-gestalt -- tension-resonance mapping in gestalt integration mirrors compression-tension duality; both find coherence through productive interplay of opposing forcesanalyze-magnetic-levitation -- sister analysis skill sharing the same rigor pattern (characterize, classify, verify stability); levitation achieves contactless force balance, tensegrity achieves contact-based force balance through tension continuityconstruct-geometric-figure -- geometric construction of tensegrity node positions; the geometric figure provides the initial topology that tensegrity analysis then verifies for stability