behavioral-guidelines

Enforces disciplined coding principles for planning, implementing, and testing changes in this repository.

8|15|Updated Jan 17, 2025
One-click install
npx skills add https://github.com/Netcracker/qubership-envgene --skill behavioral-guidelines-netcracker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: behavioral-guidelines
Source: https://github.com/Netcracker/qubership-envgene/tree/main/.claude/skills/behavioral-guidelines
Command: npx skills add https://github.com/Netcracker/qubership-envgene --skill behavioral-guidelines-netcracker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? LLM coding assistants often over-engineer solutions, make silent assumptions, touch unrelated code, and write tests that mock the very component under test. This Skill provides a strict set of behavioral guidelines that reduce these common mistakes when working in this repository. ## Core Features & Use Cases - Mandatory Scope Restriction: Limits all changes to cucumber_tests/ and .github/workflows/perform_e2e_tests.yml, forcing an explicit stop-and-report if a change would touch anything else. - Simplicity and Surgical Changes: Requires minimum code for the task, no speculative abstractions, and diffs where every changed line traces to the user's request. - Real-Component Testing: Prohibits mocking the system under test (e.g., the Calculator CLI JAR or sboms_retention_policy()), allowing mocks only for external dependencies like network, clock, or unavailable services. - Goal-Driven Execution: Converts vague tasks into verifiable success criteria with explicit step-and-verify plans. - Use Case: When planning a new BDD scenario for the effective-set-generator CLI, the Skill ensures the test invokes the real built JAR rather than a Python reimplementation, and that no files outside the test infrastructure are modified. ## Quick Start Ask the assistant to plan and implement a new Cucumber test scenario for the Calculator CLI while following the repository's behavioral guidelines.

Frequently Asked Questions about behavioral-guidelines

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write tests that don't mock the system under test?

Invoke the real component directly: for CLI scenarios, build and run the actual effective-set-generator JAR as a test fixture; for pipeline functions, call the real Python function. Reserve mocks only for network, clock, randomness, or unavailable external services.

Which files am I allowed to modify under these behavioral guidelines?

Only files under cucumber_tests/ and the .github/workflows/perform_e2e_tests.yml workflow may be created, modified, or deleted. Any change outside these paths must be stopped and reported to the user explicitly.

When is it acceptable to use a mock stub in BDD tests?

Mock stubs are acceptable only when the mocked component is not the subject of the scenario, such as a stubbed CLI that merely needs to not crash during an SBOM retention test. They are never acceptable for scenarios testing that component itself.

Why should I avoid refactoring adjacent code during a change?

Surgical changes keep every modified line traceable to the user's request, making reviews faster and regressions easier to isolate. Pre-existing dead code or style issues should be mentioned, not silently fixed.

How do I turn a vague task into verifiable success criteria?

Restate the task as a testable goal, such as writing a failing test that reproduces a bug and then making it pass. For multi-step work, list each step with its verification check before starting.