What problem does it solve?
This document consolidates development guidelines, validation patterns, and security guardrails to reduce fragmentation and unsafe practices when building and maintaining GitHub Agentic Workflows.
Core Features & Use Cases
- Code Organization: Recommended file, helper, and module patterns to keep the codebase modular and maintainable.
- Validation Architecture: Centralized and domain-specific validation strategies to ensure workflow correctness and expression safety.
- Security Best Practices: Template injection prevention, supply chain pinning, minimal permissions, and shell scripting guidance to harden workflows.
- Safe Outputs & Testing: Patterns for safe API write operations, static analysis integration, and test organization for reliable CI.
- Use Case: A maintainer refactors a large frontmatter parser into multiple focused modules, adds validation checks, and pins Actions to SHAs following the guidelines.
Quick Start
Read the Developer Instructions and apply the Code Organization and Security Best Practices sections to audit or extend an agentic workflow implementation.