Add agent skill for F´ integration testing

[devin-ai-integration]

Related Issue(s)	N/A
Has Unit Tests (y/n)	n
Documentation Included (y/n)	y
Generative AI was used in this contribution (y/n)	AI

---

Change Description

Adds a comprehensive agent skill (SKILL.md) at .agents/skills/integration-testing/SKILL.md that teaches AI coding agents how to author F´ integration test (InT) scripts using the GDS Python testing framework (fprime_gds.common.testing_fw).

The skill covers:

• Pytest setup and the fprime_test_api fixture (session + function scoped)
• Core API methods: sending commands (send_command, send_and_assert_command, send_and_assert_event, send_and_assert_telemetry)
• Event search/assert: await_event, assert_event, await_event_sequence, assert_event_count
• Telemetry search/assert: await_telemetry, assert_telemetry, await_telemetry_count, assert_telemetry_sequence
• File operations: uplink_file, uplink_file_and_await_completion, uplink_sequence_and_await_completion
• Sequence execution: compiling .seq files with fprime-seqgen and running them via CS_RUN
• Predicates module: comparison, set, logic, and data object predicates with composition patterns
• Search scope: start/timeout semantics, NOW marker, TimeType usage
• Sub-histories: filtered event/telemetry sub-histories for targeted assertions
• Assert helpers: test_assert, predicate_assert, expect mode for soft checks
• Deployment configuration: get_mnemonic() for portable component name resolution
• Anti-patterns: zero-count with timeout, no-scope searches, timestamp in sequences, predicate inversion gotchas
• Complete working examples and a 10-point checklist for test authors

Rationale

AI agents working on F´ projects need structured guidance to write correct integration tests. This skill provides the complete API reference, patterns, and anti-patterns derived from the actual fprime-gds testing framework source code and existing Ref app integration tests. It enables agents to produce idiomatic, correct InT scripts without having to rediscover the API each session.

Testing/Review Recommendations

• Verify the skill content aligns with the current fprime_gds.common.testing_fw.api.IntegrationTestAPI interface
• Check that the examples are consistent with existing tests in TestDeploymentsProject/Ref/test/int/
• This is a documentation-only change (a SKILL.md file); no code paths are affected

Future Work

• Could add coverage for Data Products (DP) testing patterns
• Could expand with deployment-specific skill variants for different projects

AI Usage (see policy)

This skill was authored by an AI agent (Devin) by analyzing the fprime-gds testing framework source code (common/testing_fw/api.py, predicates.py, pytest_integration.py), the GDS test API guide documentation (docs/user-manual/gds/gds-test-api-guide.md), and existing integration test examples across the fprime repository.

IAMAI

Link to Devin session: https://nasa-jpl-demo.devinenterprise.com/sessions/1d703e38f8e84373b8df69ff9a9a5075

---

[devin-ai-integration]

Original prompt from thomas.boyer.chammard

Looking across both fprime and fprime-gds, including documentation of the testing_fw in GDS and whatever you can find about integration testing: please create an agent skill for integration testing in F´, for authoring InT scripts with the Python testing framework.

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR that start with 'DevinAI' or '@devin'.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.