Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
47 lines (29 loc) · 1.75 KB

CONTRIBUTING.md

File metadata and controls

47 lines (29 loc) · 1.75 KB
Raw

Contributing to TeensyRedOps

First off, thank you for considering contributing to TeensyRedOps! It's people like you that make this an excellent resource for the security community.

⚖️ A Note on Ethics

TeensyRedOps is a research and educational project. We do not accept contributions that involve:

  • Weaponized exploits for unpatched vulnerabilities (0-days).
  • Malicious payloads intended for unauthorized use.
  • Content that promotes illegal activities.

All contributions must focus on Adversary Simulation, Education, and Detection.

How Can I Contribute?

Reporting Bugs or Suggestions

  • Check the Issues tab to see if it has already been reported.
  • If not, open a new issue with a clear description and any relevant context.

Adding New Techniques

  1. Select a Category: Determine where your technique fits (HID, Physical Access, etc.).
  2. Use the Template: Follow the standardized Scenario Template.
  3. Focus on Detection: Ensure your contribution includes specific logs, telemetry, or defensive controls that help blue teams.
  4. Submission: Open a Pull Request with your changes.

Improving Documentation

  • Typos, clarity improvements, and expanded detection notes are always welcome.

Pull Request Process

  1. Keep PRs focused on a single change or related set of changes.
  2. Ensure documentation is updated (if applicable).
  3. The maintainer will review your PR and may suggest changes before merging.

Style Guide

  • Use professional, technical language.
  • Avoid sensationalist or "hacking for fun" terminology.
  • Use clear diagrams and tables for complex concepts.

Thank you for helping us build a better-defended world!